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

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

@@ -14798,22 +14798,25 @@ async function readFromClipboard(state2) {
 function inchesToTwips(inches) {
   if (inches == null) return;
   if (typeof inches === "string") inches = parseFloat(inches);
-  return Math.round(inches * 1440);
+  return Math.round(Number(inches) * 1440);
 }
 function twipsToInches(twips) {
   if (twips == null) return;
-  if (typeof twips === "string") twips = parseInt(twips, 10);
-  return Math.round(twips / 1440 * 100) / 100;
+  const value = Number(twips);
+  if (Number.isNaN(value)) return;
+  return value / 1440;
 }
 function twipsToPixels(twips) {
   if (twips == null) return;
-  twips = twipsToInches(twips);
-  return Math.round(twips * 96);
+  const inches = twipsToInches(twips);
+  if (inches == null) return;
+  const pixels = inches * 96;
+  return Math.round(pixels * 1e3) / 1e3;
 }
 function pixelsToTwips(pixels) {
   if (pixels == null) return;
-  pixels = pixels / 96;
-  return inchesToTwips(pixels);
+  const inches = Number(pixels) / 96;
+  return inchesToTwips(inches);
 }
 function twipsToLines(twips) {
   if (twips == null) return;
@@ -14856,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 = {
@@ -24701,13 +24712,15 @@ const getParagraphIndent = (node, docx, styleId = "") => {
   }
   return indent;
 };
-const getParagraphSpacing = (node, docx, styleId = "", marks = []) => {
+const getParagraphSpacing = (node, docx, styleId = "", marks = [], options = {}) => {
+  const { insideTable = false } = options;
   const spacing = {};
-  const { spacing: pDefaultSpacing = {} } = getDefaultParagraphStyle(docx, styleId);
+  const { spacing: pDefaultSpacing = {}, spacingSource } = getDefaultParagraphStyle(docx, styleId);
   let lineSpaceAfter, lineSpaceBefore, line, lineRuleStyle;
   const pPr = node.elements?.find((el) => el.name === "w:pPr");
   const inLineSpacingTag = pPr?.elements?.find((el) => el.name === "w:spacing");
   const inLineSpacing = inLineSpacingTag?.attributes || {};
+  const hasInlineSpacing = !!Object.keys(inLineSpacing).length;
   const textStyleMark = marks.find((el) => el.type === "textStyle");
   const fontSize2 = textStyleMark?.attrs?.fontSize;
   const lineSpacing = inLineSpacing?.["w:line"] || line || pDefaultSpacing?.["w:line"];
@@ -24729,6 +24742,12 @@ const getParagraphSpacing = (node, docx, styleId = "", marks = []) => {
   if (afterAutospacing === "1" && fontSize2) {
     spacing.lineSpaceAfter += Math.round(parseInt(fontSize2) * 0.5 * 96 / 72);
   }
+  if (insideTable && !hasInlineSpacing && spacingSource === "docDefault") {
+    const hasExplicitSpacing = Object.keys(inLineSpacing).length > 0;
+    if (!hasExplicitSpacing) {
+      return void 0;
+    }
+  }
   return spacing;
 };
 const getDefaultParagraphStyle = (docx, styleId = "") => {
@@ -24769,9 +24788,20 @@ const getDefaultParagraphStyle = (docx, styleId = "") => {
   const { attributes: pPrByIdIndentAttr } = pPrStyleIdIndentTag;
   const spacingRest = isNormalAsDefault ? pPrNormalSpacingAttr || pPrDefaultSpacingAttr : pPrDefaultSpacingAttr || pPrNormalSpacingAttr;
   const indentRest = isNormalAsDefault ? pPrNormalIndentAttr || pPrDefaultIndentAttr : pPrDefaultIndentAttr || pPrNormalIndentAttr;
+  let spacingToUse = pPrByIdSpacingAttr || spacingRest;
+  let spacingSource = "docDefault";
+  if (pPrByIdSpacingAttr) {
+    spacingSource = "style";
+  } else if (spacingRest === pPrNormalSpacingAttr && pPrNormalSpacingAttr) {
+    spacingSource = isNormalAsDefault ? "docDefault" : "normal";
+  } else if (spacingRest === pPrDefaultSpacingAttr && pPrDefaultSpacingAttr) {
+    spacingSource = "docDefault";
+  }
+  let indentToUse = pPrByIdIndentAttr || indentRest;
   return {
-    spacing: pPrByIdSpacingAttr || spacingRest,
-    indent: pPrByIdIndentAttr || indentRest,
+    spacing: spacingToUse,
+    spacingSource,
+    indent: indentToUse,
     justify: pPrByIdJcAttr
   };
 };
@@ -24946,7 +24976,13 @@ const handleParagraphNode$1 = (params2) => {
   }
   if (docx) {
     const defaultStyleId = node.attributes?.["w:rsidRDefault"];
-    schemaNode.attrs["spacing"] = getParagraphSpacing(node, docx, styleId, schemaNode.attrs.marksAttrs);
+    const insideTable = (params2.path || []).some((ancestor) => ancestor.name === "w:tc");
+    const spacing = getParagraphSpacing(node, docx, styleId, schemaNode.attrs.marksAttrs, {
+      insideTable
+    });
+    if (spacing) {
+      schemaNode.attrs["spacing"] = spacing;
+    }
     schemaNode.attrs["rsidRDefault"] = defaultStyleId;
   }
   if (docx) {
@@ -25192,10 +25228,10 @@ function createBorderPropertyHandler(xmlName, sdName = null) {
       createAttributeHandler("w:shadow", null, parseBoolean, booleanToString),
       createAttributeHandler("w:frame", null, parseBoolean, booleanToString)
     ],
-    encode: (_2, encodedAttrs) => {
+    encode: (params2, encodedAttrs) => {
       return Object.keys(encodedAttrs).length > 0 ? encodedAttrs : void 0;
     },
-    decode: function({ node }, _2) {
+    decode: function({ node }, context) {
       const decodedAttrs = this.decodeAttributes({ node: { ...node, attrs: node.attrs[sdName] || {} } });
       return Object.keys(decodedAttrs).length > 0 ? { attributes: decodedAttrs } : void 0;
     }
@@ -25554,10 +25590,10 @@ const translator$B = NodeTranslator.from({
     "w:themeTint",
     "w:val"
   ].map((attr) => createAttributeHandler(attr)),
-  encode: (_2, encodedAttrs) => {
+  encode: (params2, encodedAttrs) => {
     return Object.keys(encodedAttrs).length > 0 ? encodedAttrs : void 0;
   },
-  decode: function({ node }, _2) {
+  decode: function({ node }, context) {
     const decodedAttrs = this.decodeAttributes({ node: { ...node, attrs: node.attrs.shading || {} } });
     return Object.keys(decodedAttrs).length > 0 ? { attributes: decodedAttrs } : void 0;
   }
@@ -25570,10 +25606,10 @@ const translator$w = NodeTranslator.from({
   xmlName: "w:tblLook",
   sdNodeOrKeyName: "tblLook",
   attributes: ["w:firstColumn", "w:firstRow", "w:lastColumn", "w:lastRow", "w:noHBand", "w:noVBand"].map((attr) => createAttributeHandler(attr, null, parseBoolean, booleanToString)).concat([createAttributeHandler("w:val")]),
-  encode: (_2, encodedAttrs) => {
+  encode: (params2, encodedAttrs) => {
     return Object.keys(encodedAttrs).length > 0 ? encodedAttrs : void 0;
   },
-  decode: function({ node }, _2) {
+  decode: function({ node }, context) {
     const decodedAttrs = this.decodeAttributes({ node: { ...node, attrs: node.attrs.tblLook || {} } });
     return Object.keys(decodedAttrs).length > 0 ? { attributes: decodedAttrs } : void 0;
   }
@@ -25591,10 +25627,10 @@ const translator$q = NodeTranslator.from({
   xmlName: "w:tblpPr",
   sdNodeOrKeyName: "floatingTableProperties",
   attributes: ["w:leftFromText", "w:rightFromText", "w:topFromText", "w:bottomFromText", "w:tblpX", "w:tblpY"].map((attr) => createAttributeHandler(attr, null, parseInteger, integerToString)).concat(["w:horzAnchor", "w:vertAnchor", "w:tblpXSpec", "w:tblpYSpec"].map((attr) => createAttributeHandler(attr))),
-  encode: (_2, encodedAttrs) => {
+  encode: (params2, encodedAttrs) => {
     return Object.keys(encodedAttrs).length > 0 ? encodedAttrs : void 0;
   },
-  decode: function({ node }, _2) {
+  decode: function({ node }, context) {
     const decodedAttrs = this.decodeAttributes({ node: { ...node, attrs: node.attrs.floatingTableProperties || {} } });
     return Object.keys(decodedAttrs).length > 0 ? { attributes: decodedAttrs } : void 0;
   }
@@ -25615,13 +25651,13 @@ const translator$d = NodeTranslator.from(createBorderPropertyHandler("w:top"));
 const translator$c = NodeTranslator.from(createMeasurementPropertyHandler("w:top", "marginTop"));
 const XML_NODE_NAME$a = "w:tblBorders";
 const SD_ATTR_KEY$3 = "borders";
-const encode$a = (params2, _2) => {
+const encode$a = (params2) => {
   const { nodes } = params2;
   const node = nodes[0];
   const attributes = encodeProperties(node, tblBordersTranslatorsByXmlName);
   return Object.keys(attributes).length > 0 ? attributes : void 0;
 };
-const decode$a = (params2, _2) => {
+const decode$a = (params2) => {
   const { borders = {} } = params2.node.attrs || {};
   const elements = decodeProperties(tblBordersTranslatorsBySdName, borders);
   const newNode = {
@@ -25658,13 +25694,13 @@ const translator$b = NodeTranslator.from({
 });
 const XML_NODE_NAME$9 = "w:tblCellMar";
 const SD_ATTR_KEY$2 = "cellMargins";
-const encode$9 = (params2, _2) => {
+const encode$9 = (params2) => {
   const { nodes } = params2;
   const node = nodes[0];
   const attributes = encodeProperties(node, propertyTranslatorsByXmlName$1);
   return Object.keys(attributes).length > 0 ? attributes : void 0;
 };
-const decode$9 = (params2, _2) => {
+const decode$9 = (params2) => {
   const { cellMargins = {} } = params2.node.attrs || {};
   const elements = decodeProperties(propertyTranslatorsBySdName$1, cellMargins);
   const newNode = {
@@ -25755,6 +25791,53 @@ const translator$9 = NodeTranslator.from(config$8);
 const translator$8 = NodeTranslator.from(
   createSingleAttrPropertyHandler("w:gridCol", "col", "w:w", parseInteger, integerToString)
 );
+const DEFAULT_COLUMN_WIDTH_PX = 100;
+const normalizeTwipWidth = (value) => {
+  if (value == null) return null;
+  const numericValue = typeof value === "string" ? parseInt(value, 10) : value;
+  if (!Number.isFinite(numericValue) || Number.isNaN(numericValue) || numericValue <= 0) {
+    return null;
+  }
+  return numericValue;
+};
+const getSchemaDefaultColumnWidthPx = (params2) => {
+  const defaultValue = params2?.editor?.schema?.nodes?.tableCell?.spec?.attrs?.colwidth?.default;
+  if (Array.isArray(defaultValue)) {
+    const numericWidth = defaultValue.find((width) => typeof width === "number" && Number.isFinite(width) && width > 0);
+    if (numericWidth != null) return numericWidth;
+  } else if (typeof defaultValue === "number" && Number.isFinite(defaultValue) && defaultValue > 0) {
+    return defaultValue;
+  }
+  return DEFAULT_COLUMN_WIDTH_PX;
+};
+const getTableWidthPx = (params2) => {
+  const explicitWidth = params2?.node?.attrs?.tableWidth?.width;
+  if (typeof explicitWidth === "number" && explicitWidth > 0) return explicitWidth;
+  const tableWidth = params2?.node?.attrs?.tableProperties?.tableWidth;
+  if (tableWidth?.value != null && typeof tableWidth.value === "number" && tableWidth.value > 0) {
+    const { value, type: type2 } = tableWidth;
+    if (!type2 || type2 === "auto" || type2 === "dxa") {
+      return twipsToPixels(value);
+    }
+  }
+  return null;
+};
+const resolveFallbackColumnWidthTwips = (params2, totalColumns, cellMinWidthTwips) => {
+  const columnCount = Math.max(totalColumns, 1);
+  const defaultColumnWidthPx = getSchemaDefaultColumnWidthPx(params2);
+  const tableWidthPx = getTableWidthPx(params2);
+  const safeDefaultPx = Number.isFinite(defaultColumnWidthPx) && defaultColumnWidthPx > 0 ? defaultColumnWidthPx : DEFAULT_COLUMN_WIDTH_PX;
+  let fallbackWidthPx = safeDefaultPx;
+  if (typeof tableWidthPx === "number" && tableWidthPx > 0) {
+    fallbackWidthPx = tableWidthPx / columnCount;
+  }
+  const fallbackWidthTwips = pixelsToTwips(fallbackWidthPx);
+  if (!Number.isFinite(fallbackWidthTwips) || Number.isNaN(fallbackWidthTwips) || fallbackWidthTwips <= 0) {
+    const safeDefault = Math.max(pixelsToTwips(safeDefaultPx), cellMinWidthTwips);
+    return safeDefault;
+  }
+  return Math.max(fallbackWidthTwips, cellMinWidthTwips);
+};
 const XML_NODE_NAME$7 = "w:tblGrid";
 const SD_ATTR_KEY = "grid";
 const cellMinWidth = pixelsToTwips(10);
@@ -25769,35 +25852,60 @@ const encode$7 = (params2) => {
   };
 };
 const decode$7 = (params2) => {
-  const { grid = [] } = params2.node.attrs || {};
+  const { grid: rawGrid } = params2.node.attrs || {};
+  const grid = Array.isArray(rawGrid) ? rawGrid : [];
   const { firstRow = {} } = params2.extraParams || {};
   const cellNodes = firstRow.content?.filter((n) => n.type === "tableCell") ?? [];
-  const numberOfColumns = cellNodes.length || grid.length;
+  const columnCountFromCells = cellNodes.reduce((count, cell) => {
+    const spanCount = Math.max(1, cell?.attrs?.colspan ?? 1);
+    return count + spanCount;
+  }, 0);
+  const totalColumns = Math.max(columnCountFromCells, grid.length);
+  const fallbackColumnWidthTwips = resolveFallbackColumnWidthTwips(params2, totalColumns, cellMinWidth);
   const elements = [];
-  for (let cellIdx = 0; cellIdx < numberOfColumns; cellIdx++) {
-    const cell = cellNodes[cellIdx];
+  let columnIndex = 0;
+  const pushColumn = (widthTwips) => {
+    let numericWidth = typeof widthTwips === "string" ? parseInt(widthTwips, 10) : widthTwips;
+    if (numericWidth == null || Number.isNaN(numericWidth) || numericWidth <= 0) {
+      numericWidth = fallbackColumnWidthTwips;
+    }
+    numericWidth = Math.max(numericWidth, cellMinWidth);
+    const decoded = translator$8.decode({
+      node: { type: (
+        /** @type {string} */
+        translator$8.sdNodeOrKeyName
+      ), attrs: { col: numericWidth } }
+    });
+    if (decoded) elements.push(decoded);
+  };
+  cellNodes.forEach((cell) => {
     const { colspan = 1, colwidth } = cell?.attrs || {};
-    for (let mergedCellIdx = 0; mergedCellIdx < colspan; mergedCellIdx++) {
-      const cellWidthPixels = colwidth && colwidth[mergedCellIdx];
-      const colGridAttrs = grid?.[mergedCellIdx] || {};
-      const gridWidthTwips = colGridAttrs.col;
-      const gridWidthPixels = twipsToPixels(gridWidthTwips);
+    const spanCount = Math.max(1, colspan);
+    for (let span = 0; span < spanCount; span++) {
+      const cellWidthPixels = Array.isArray(colwidth) ? colwidth[span] : void 0;
+      const colGridAttrs = grid?.[columnIndex] || {};
+      const gridWidthTwips = normalizeTwipWidth(colGridAttrs.col);
+      const gridWidthPixels = gridWidthTwips != null ? twipsToPixels(gridWidthTwips) : null;
       let cellWidthTwips;
-      if (gridWidthPixels === cellWidthPixels) {
+      if (cellWidthPixels != null) {
+        if (gridWidthTwips != null && gridWidthPixels === cellWidthPixels) {
+          cellWidthTwips = gridWidthTwips;
+        } else {
+          cellWidthTwips = pixelsToTwips(cellWidthPixels);
+        }
+      } else if (gridWidthTwips != null) {
         cellWidthTwips = gridWidthTwips;
-      } else if (cellWidthPixels) {
-        cellWidthTwips = pixelsToTwips(cellWidthPixels);
-      }
-      const widthTwips = Math.max(cellWidthTwips, cellMinWidth);
-      elements.push(
-        translator$8.decode({
-          node: { type: (
-            /** @type {string} */
-            translator$8.sdNodeOrKeyName
-          ), attrs: { col: widthTwips } }
-        })
-      );
+      } else {
+        cellWidthTwips = fallbackColumnWidthTwips;
+      }
+      pushColumn(cellWidthTwips);
+      columnIndex++;
     }
+  });
+  while (columnIndex < grid.length) {
+    const gridWidthTwips = normalizeTwipWidth(grid[columnIndex]?.col);
+    pushColumn(gridWidthTwips);
+    columnIndex++;
   }
   const newNode = {
     name: XML_NODE_NAME$7,
@@ -25820,7 +25928,8 @@ const encode$6 = (params2, encodedAttrs) => {
   const node = nodes[0];
   const tblPr = node.elements.find((el) => el.name === "w:tblPr");
   if (tblPr) {
-    encodedAttrs["tableProperties"] = translator$9.encode({ ...params2, nodes: [tblPr] }).attributes;
+    const encodedProperties = translator$9.encode({ ...params2, nodes: [tblPr] });
+    encodedAttrs["tableProperties"] = encodedProperties?.attributes || {};
   }
   const tblGrid = node.elements.find((el) => el.name === "w:tblGrid");
   if (tblGrid) {
@@ -25842,7 +25951,7 @@ const encode$6 = (params2, encodedAttrs) => {
       key2 = prop;
       transform = (v2) => v2;
     }
-    if (encodedAttrs.tableProperties?.[key2]) {
+    if (encodedAttrs.tableProperties && encodedAttrs.tableProperties[key2]) {
       encodedAttrs[key2] = transform(encodedAttrs.tableProperties[key2]);
     }
   });
@@ -25851,11 +25960,17 @@ const encode$6 = (params2, encodedAttrs) => {
   }
   const { borders, rowBorders } = _processTableBorders(encodedAttrs.tableProperties?.borders || {});
   const referencedStyles = _getReferencedTableStyles(encodedAttrs.tableStyleId, params2);
+  if (referencedStyles?.cellMargins && !encodedAttrs.tableProperties?.cellMargins) {
+    encodedAttrs.tableProperties = {
+      ...encodedAttrs.tableProperties || {},
+      cellMargins: referencedStyles.cellMargins
+    };
+  }
   const rows = node.elements.filter((el) => el.name === "w:tr");
   const borderData = Object.assign({}, referencedStyles?.borders || {}, borders || {});
   const borderRowData = Object.assign({}, referencedStyles?.rowBorders || {}, rowBorders || {});
   encodedAttrs["borders"] = borderData;
-  const tblStyleTag = tblPr.elements.find((el) => el.name === "w:tblStyle");
+  const tblStyleTag = tblPr?.elements?.find((el) => el.name === "w:tblStyle");
   const columnWidths = (encodedAttrs["grid"] ?? []).map((item) => twipsToPixels(item.col));
   const content = [];
   rows.forEach((row) => {
@@ -25864,6 +25979,7 @@ const encode$6 = (params2, encodedAttrs) => {
       nodes: [row],
       extraParams: {
         row,
+        table: node,
         rowBorders: borderRowData,
         styleTag: tblStyleTag,
         columnWidths
@@ -25965,7 +26081,12 @@ function _getReferencedTableStyles(tableStyleReference, params2) {
     if (rowBorders) stylesToReturn.rowBorders = rowBorders;
     const cellMargins = {};
     Object.entries(tableProperties.cellMargins || {}).forEach(([key2, attrs]) => {
-      if (attrs?.value) cellMargins[key2] = String(attrs.value);
+      if (attrs?.value != null) {
+        cellMargins[key2] = {
+          value: attrs.value,
+          type: attrs.type || "dxa"
+        };
+      }
     });
     if (Object.keys(cellMargins).length) stylesToReturn.cellMargins = cellMargins;
   }
@@ -26218,11 +26339,17 @@ const getTableCellMargins = (marginTag, referencedStyles) => {
     marginTop: marginTopStyle,
     marginBottom: marginBottomStyle
   } = cellMargins;
+  const resolveMargin = (inlineValue, styleValue) => {
+    if (inlineValue != null) return inlineValue;
+    if (styleValue == null) return void 0;
+    if (typeof styleValue === "object") return styleValue.value;
+    return styleValue;
+  };
   const margins = {
-    left: twipsToPixels(inlineMarginLeftValue ?? marginLeftStyle),
-    right: twipsToPixels(inlineMarginRightValue ?? marginRightStyle),
-    top: twipsToPixels(inlineMarginTopValue ?? marginTopStyle),
-    bottom: twipsToPixels(inlineMarginBottomValue ?? marginBottomStyle)
+    left: twipsToPixels(resolveMargin(inlineMarginLeftValue, marginLeftStyle)),
+    right: twipsToPixels(resolveMargin(inlineMarginRightValue, marginRightStyle)),
+    top: twipsToPixels(resolveMargin(inlineMarginTopValue, marginTopStyle)),
+    bottom: twipsToPixels(resolveMargin(inlineMarginBottomValue, marginBottomStyle))
   };
   return margins;
 };
@@ -26497,7 +26624,7 @@ function parseTagValueJSON(json) {
   }
   try {
     return JSON.parse(trimmed);
-  } catch (err) {
+  } catch {
     return {};
   }
 }
@@ -26753,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);
@@ -26809,6 +26962,7 @@ function handleImageNode(node, params2, isAnchor) {
       size: size2,
       anchorData,
       isAnchor,
+      transformData,
       ...simplePos && {
         simplePos: {
           x: simplePos.attributes.x,
@@ -26960,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 {
@@ -26974,12 +27153,7 @@ const translateImageNode = (params2) => {
       },
       {
         name: "wp:effectExtent",
-        attributes: {
-          l: 0,
-          t: 0,
-          r: 0,
-          b: 0
-        }
+        attributes: effectExtentAttrs
       },
       {
         name: "wp:docPr",
@@ -27059,6 +27233,7 @@ const translateImageNode = (params2) => {
                     elements: [
                       {
                         name: "a:xfrm",
+                        attributes: xfrmAttrs,
                         elements: [
                           {
                             name: "a:ext",
@@ -27236,14 +27411,14 @@ function translateAnchorNode(params2) {
 const XML_NODE_NAME$3 = "wp:anchor";
 const SD_NODE_NAME$3 = ["image"];
 const validXmlAttributes$3 = ["distT", "distB", "distL", "distR"].map((xmlName) => createAttributeHandler(xmlName));
-function encode$3(params2, encodedAttrs) {
+function encode$3(params2) {
   const { node } = params2.extraParams;
   if (!node || !node.type) {
     return null;
   }
   return handleAnchorNode(params2);
 }
-function decode$3(params2, decodedAttrs) {
+function decode$3(params2) {
   const { node } = params2;
   if (!node || !node.type) {
     return null;
@@ -27277,14 +27452,14 @@ function translateInlineNode(params2) {
 const XML_NODE_NAME$2 = "wp:inline";
 const SD_NODE_NAME$2 = ["image"];
 const validXmlAttributes$2 = ["distT", "distB", "distL", "distR"].map((xmlName) => createAttributeHandler(xmlName));
-function encode$2(params2, encodedAttrs) {
+function encode$2(params2) {
   const { node } = params2.extraParams;
   if (!node || !node.type) {
     return null;
   }
   return handleInlineNode(params2);
 }
-function decode$2(params2, decodedAttrs) {
+function decode$2(params2) {
   const { node } = params2;
   if (!node || !node.type) {
     return null;
@@ -27310,7 +27485,7 @@ const registeredHandlers = Object.freeze({
 const XML_NODE_NAME$1 = "w:drawing";
 const SD_NODE_NAME$1 = [];
 const validXmlAttributes$1 = [];
-function encode$1(params2, encodedAttrs) {
+function encode$1(params2) {
   const nodes = params2.nodes;
   const node = nodes[0];
   const validChildTranslators = ["wp:anchor", "wp:inline"];
@@ -27321,7 +27496,7 @@ function encode$1(params2, encodedAttrs) {
     return translator2.encode({ ...params2, extraParams: { node: child } }) || acc;
   }, null);
 }
-function decode$1(params2, decodedAttrs) {
+function decode$1(params2) {
   const { node } = params2;
   if (!node || !node.type) {
     return null;
@@ -28922,7 +29097,7 @@ function translateStructuredContent(params2) {
 const XML_NODE_NAME = "w:sdt";
 const SD_NODE_NAME = ["fieldAnnotation", "structuredContent", "structuredContentBlock", "documentSection"];
 const validXmlAttributes = [];
-function encode$s(params2, encodedAttrs) {
+function encode$s(params2) {
   const nodes = params2.nodes;
   const node = nodes[0];
   const { type: sdtType, handler: handler2 } = sdtNodeTypeStrategy(node);
@@ -28932,7 +29107,7 @@ function encode$s(params2, encodedAttrs) {
   const result = handler2(params2);
   return result;
 }
-function decode(params2, decodedAttrs) {
+function decode(params2) {
   const { node } = params2;
   if (!node || !node.type) {
     return null;
@@ -31261,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);
@@ -42220,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
     };
@@ -42244,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 }) => {
@@ -42260,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 }) => {
@@ -49181,6 +49348,7 @@ const _Editor = class _Editor2 extends EventEmitter$1 {
       return result;
     } catch (error) {
       this.emit("exception", { error, editor: this });
+      console.error(error);
     }
   }
   /**
@@ -49204,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);
     }
   }
   /**
@@ -49792,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() {
@@ -49818,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"]
     };
   },
@@ -49831,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, ""),
@@ -49853,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 }) => {
@@ -49871,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 }) => {
@@ -49886,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"]
     };
   },
@@ -49899,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, ""),
@@ -49921,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 }) => {
@@ -49936,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 }) => {
@@ -49951,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,
@@ -49971,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,
@@ -49996,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 }) => {
@@ -50027,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 }) => {
@@ -50079,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 }) => {
@@ -50096,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 }) => {
@@ -50239,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: ""
@@ -50257,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,
@@ -50286,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 }) => {
@@ -50305,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 }) => {
@@ -50335,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 }) => {
@@ -50346,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 }) => {
@@ -50357,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 }) => {
@@ -50368,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 }) => {
@@ -50787,6 +50890,9 @@ function drawGapCursor(state2) {
 }
 const Gapcursor = Extension.create({
   name: "gapCursor",
+  addOptions() {
+    return {};
+  },
   addPmPlugins() {
     return [gapCursor()];
   },
@@ -51127,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 [];
@@ -51264,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"
@@ -51280,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 }) => {
@@ -51300,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 }) => {
@@ -51314,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" }];
   },
@@ -51346,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"
@@ -51371,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,
@@ -51400,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
@@ -51416,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) => {
@@ -51538,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) => {
@@ -51559,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);
@@ -51837,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 }) => {
@@ -52126,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)];
   },
@@ -52134,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
        */
@@ -52149,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
        */
@@ -52186,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) => {
@@ -52900,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: {}
     };
@@ -53137,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]
     };
   },
@@ -53151,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 }) => {
@@ -53166,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 }) => {
@@ -53577,6 +53654,9 @@ const LineBreak = Node$1.create({
   selectable: false,
   content: "",
   atom: true,
+  addOptions() {
+    return {};
+  },
   parseDOM() {
     return [{ tag: "br" }];
   },
@@ -53585,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 }
     };
   },
@@ -53604,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 }) => {
@@ -53623,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",
@@ -53638,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 }
     };
   },
@@ -53692,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 }) => {
@@ -56084,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: {
@@ -56252,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);
@@ -56272,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);
@@ -56282,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 }) => {
@@ -56661,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;
@@ -56790,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) => {
@@ -56844,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 {};
@@ -56855,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() {
@@ -56871,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 }
@@ -56935,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) => {
@@ -56967,10 +56944,6 @@ const TableCell = Node$1.create({
           };
         }
       },
-      /**
-       * @category Attribute
-       * @param {CellBackground} [background] - Cell background color configuration
-       */
       background: {
         renderDOM({ background }) {
           if (!background) return {};
@@ -56979,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 {};
@@ -56990,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 {};
@@ -57006,10 +56971,6 @@ const TableCell = Node$1.create({
           return { style: style2 };
         }
       },
-      /**
-       * @category Attribute
-       * @param {CellBorders} [borders] - Cell border configuration
-       */
       borders: {
         default: () => createCellBorders(),
         renderDOM({ borders }) {
@@ -57024,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
@@ -58667,7 +58618,7 @@ const validateUrlAccessibility = async (url) => {
       credentials: "omit"
     });
     return response.ok;
-  } catch (_error) {
+  } catch {
     return false;
   }
 };
@@ -59240,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",
@@ -59261,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 }) => {
@@ -59273,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;`;
@@ -59369,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,
@@ -59439,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 }
@@ -59667,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;
@@ -59729,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;
@@ -59995,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
       }
@@ -60007,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 }) => {
@@ -60018,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 }) => {
@@ -60035,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) => {
@@ -60048,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
       }
@@ -60081,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 }) => {
@@ -60100,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'
        * })
@@ -60143,7 +60070,7 @@ class StructuredContentViewBase {
     this.htmlAttributes = props.htmlAttributes;
     this.mount(props);
   }
-  mount(props) {
+  mount() {
     return;
   }
   get dom() {
@@ -60634,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,
@@ -60652,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 }
     };
   },
@@ -60685,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>'
@@ -60769,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 }) => {
@@ -60797,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);
@@ -60819,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);
@@ -60838,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' }
@@ -60897,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 }) => {
@@ -60924,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 }) => {
@@ -60950,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 }) => {
@@ -61048,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) => {
@@ -61127,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
        */
@@ -61151,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) => {
@@ -61183,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)
     };
@@ -61237,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)
     };
@@ -61339,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,
@@ -61370,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)
     };
@@ -61422,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);
@@ -61432,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);
@@ -61442,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);
@@ -61464,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,
@@ -61567,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'
        * })
@@ -61628,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 }) => {
@@ -61639,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();
@@ -64965,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,
@@ -67192,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} */
@@ -67213,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[]} */
@@ -67262,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} */
@@ -67531,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";