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

package/dist/super-editor/chunks/{editor-CQMKOaY4.js → editor-chVid4VD.js}

@@ -12,9 +12,9 @@ var __privateMethod = (obj, member, method) => (__accessCheck(obj, member, "acce
 var _Attribute_static, getGlobalAttributes_fn, getNodeAndMarksAttributes_fn, _Schema_static, createNodesSchema_fn, createMarksSchema_fn, _events, _ExtensionService_instances, setupExtensions_fn, attachEditorEvents_fn, _editor, _stateValidators, _xmlValidators, _requiredNodeTypes, _requiredMarkTypes, _SuperValidator_instances, initializeValidators_fn, collectValidatorRequirements_fn, analyzeDocument_fn, _commandService, _Editor_instances, initContainerElement_fn, init_fn, initRichText_fn, onFocus_fn, checkHeadless_fn, registerCopyHandler_fn, insertNewFileData_fn, registerPluginByNameIfNotExists_fn, createExtensionService_fn, createCommandService_fn, createConverter_fn, initMedia_fn, initFonts_fn, createSchema_fn, generatePmData_fn, createView_fn, onCollaborationReady_fn, initComments_fn, initPagination_fn, dispatchTransaction_fn, handleNodeSelection_fn, prepareDocumentForImport_fn, prepareDocumentForExport_fn, endCollaboration_fn, validateDocumentInit_fn, validateDocumentExport_fn, initDevTools_fn, _ListItemNodeView_instances, init_fn2, _FieldAnnotationView_instances, createAnnotation_fn, _AutoPageNumberNodeView_instances, renderDom_fn, scheduleUpdateNodeStyle_fn, _DocumentSectionView_instances, init_fn3, addToolTip_fn;
 import * as Y from "yjs";
 import { UndoManager, Item as Item$1, ContentType, Text as Text$1, XmlElement, encodeStateAsUpdate } from "yjs";
-import { P as PluginKey, a as Plugin, M as Mapping, N as NodeSelection, S as Selection, T as TextSelection, b as Slice, D as DOMSerializer, F as Fragment, c as DOMParser$1, d as Mark$1, e as dropPoint, A as AllSelection, p as process$1, B as Buffer2, f as callOrGet, g as getExtensionConfigField, h as getMarkType, i as getMarksFromSelection, j as getNodeType, k as getSchemaTypeNameByName, l as Schema$1, m as cleanSchemaItem, n as canSplit, o as defaultBlockAt$1, q as liftTarget, r as canJoin, s as joinPoint, t as replaceStep$1, R as ReplaceAroundStep$1, u as isTextSelection, v as getMarkRange, w as isMarkActive, x as isNodeActive, y as deleteProps, z as processContent, C as ReplaceStep, E as NodeRange, G as findWrapping, L as ListHelpers, H as findParentNode, I as isMacOS, J as isIOS, K as getSchemaTypeByName, O as inputRulesPlugin, Q as TrackDeleteMarkName, U as TrackInsertMarkName, V as v4, W as TrackFormatMarkName, X as comments_module_events, Y as findMark, Z as objectIncludes, _ as AddMarkStep, $ as RemoveMarkStep, a0 as twipsToLines, a1 as pixelsToTwips, a2 as helpers, a3 as posToDOMRect, a4 as CommandService, a5 as SuperConverter, a6 as createDocument, a7 as createDocFromMarkdown, a8 as createDocFromHTML, a9 as EditorState, aa as hasSomeParentWithClass, ab as isActive, ac as unflattenListsInHtml, ad as parseSizeUnit, ae as minMax, af as getLineHeightValueString, ag as InputRule, ah as kebabCase, ai as findParentNodeClosestToPos, aj as getListItemStyleDefinitions, ak as docxNumberigHelpers, al as parseIndentElement, am as combineIndents, an as StepMap, ao as SelectionRange, ap as Transform, aq as isInTable$1, ar as generateDocxRandomId, as as insertNewRelationship, at as updateDOMAttributes, au as htmlHandler } from "./converter-kutpjDQU.js";
+import { P as PluginKey, a as Plugin, M as Mapping, N as NodeSelection, S as Selection, T as TextSelection, b as Slice, D as DOMSerializer, F as Fragment, c as DOMParser$1, d as Mark$1, e as dropPoint, A as AllSelection, p as process$1, B as Buffer2, f as callOrGet, g as getExtensionConfigField, h as getMarkType, i as getMarksFromSelection, j as getNodeType, k as getSchemaTypeNameByName, l as Schema$1, m as cleanSchemaItem, n as canSplit, o as defaultBlockAt$1, q as liftTarget, r as canJoin, s as joinPoint, t as replaceStep$1, R as ReplaceAroundStep$1, u as isTextSelection, v as getMarkRange, w as isMarkActive, x as isNodeActive, y as deleteProps, z as processContent, C as ReplaceStep, E as NodeRange, G as findWrapping, L as ListHelpers, H as findParentNode, I as isMacOS, J as isIOS, K as getSchemaTypeByName, O as inputRulesPlugin, Q as TrackDeleteMarkName, U as TrackInsertMarkName, V as v4, W as TrackFormatMarkName, X as comments_module_events, Y as findMark, Z as objectIncludes, _ as AddMarkStep, $ as RemoveMarkStep, a0 as twipsToLines, a1 as pixelsToTwips, a2 as helpers, a3 as posToDOMRect, a4 as CommandService, a5 as SuperConverter, a6 as createDocument, a7 as createDocFromMarkdown, a8 as createDocFromHTML, a9 as EditorState, aa as hasSomeParentWithClass, ab as isActive, ac as unflattenListsInHtml, ad as parseSizeUnit, ae as minMax, af as getLineHeightValueString, ag as InputRule, ah as kebabCase, ai as findParentNodeClosestToPos, aj as getListItemStyleDefinitions, ak as docxNumberigHelpers, al as parseIndentElement, am as combineIndents, an as StepMap, ao as SelectionRange, ap as Transform, aq as isInTable$1, ar as generateDocxRandomId, as as insertNewRelationship, at as updateDOMAttributes, au as htmlHandler } from "./converter-C6YOTAXG.js";
 import { ref, computed, createElementBlock, openBlock, withModifiers, Fragment as Fragment$1, renderList, normalizeClass, createCommentVNode, toDisplayString, createElementVNode, createApp } from "vue";
-import { D as DocxZipper } from "./docx-zipper-BjcI24VU.js";
+import { D as DocxZipper } from "./docx-zipper-CSiwWpmr.js";
 var GOOD_LEAF_SIZE = 200;
 var RopeSequence = function RopeSequence2() {
 };
@@ -7683,12 +7683,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
     };
@@ -7707,9 +7701,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, dispatch, tr }) => {
@@ -7723,9 +7716,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, dispatch, tr }) => {
@@ -14705,6 +14697,7 @@ const _Editor = class _Editor extends EventEmitter {
       return result;
     } catch (error) {
       this.emit("exception", { error, editor: this });
+      console.error(error);
     }
   }
   /**
@@ -14728,6 +14721,7 @@ const _Editor = class _Editor extends EventEmitter {
       this.converter.footerEditors.length = 0;
     } catch (error) {
       this.emit("exception", { error, editor: this });
+      console.error(error);
     }
   }
   /**
@@ -15425,6 +15419,7 @@ endCollaboration_fn = function() {
     if (this.options.ydoc) this.options.ydoc.destroy();
   } catch (error) {
     this.emit("exception", { error, editor: this });
+    console.error(error);
   }
 };
 /**
@@ -15459,11 +15454,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"]
     };
   },
@@ -15472,10 +15462,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, ""),
@@ -15494,16 +15480,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 }) => {
@@ -15512,9 +15499,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 }) => {
@@ -15527,11 +15513,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"]
     };
   },
@@ -15540,10 +15521,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, ""),
@@ -15562,13 +15539,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: (fontFamily) => ({ chain }) => {
@@ -15577,9 +15554,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 }) => {
@@ -15592,12 +15568,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,
@@ -15612,10 +15582,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,
@@ -15637,16 +15603,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: (fontSize) => ({ chain }) => {
@@ -15668,9 +15628,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 }) => {
@@ -15720,13 +15679,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: (alignment) => ({ commands: commands2 }) => {
@@ -15737,9 +15692,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 }) => {
@@ -15880,13 +15834,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: ""
@@ -15898,10 +15845,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,
@@ -15927,16 +15870,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: (lineHeight) => ({ commands: commands2 }) => {
@@ -15946,9 +15883,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 }) => {
@@ -15976,9 +15912,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 }) => {
@@ -15987,9 +15922,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 }) => {
@@ -15998,9 +15932,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 }) => {
@@ -16009,13 +15942,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 }) => {
@@ -16428,6 +16356,9 @@ function drawGapCursor(state) {
 }
 const Gapcursor = Extension.create({
   name: "gapCursor",
+  addOptions() {
+    return {};
+  },
   addPmPlugins() {
     return [gapCursor()];
   },
@@ -16768,6 +16699,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 [];
@@ -16905,11 +16839,6 @@ const Document = Node$1.create({
   },
   addAttributes() {
     return {
-      /**
-       * @private
-       * @category Attribute
-       * @param {Object} [attributes] - Internal document attributes
-       */
       attributes: {
         rendered: false,
         "aria-label": "Document node"
@@ -16921,10 +16850,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 }) => {
@@ -16941,9 +16870,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 }) => {
@@ -16955,13 +16883,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" }];
   },
@@ -16987,14 +16921,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"
@@ -17012,27 +16938,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,
@@ -17041,11 +16953,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
@@ -17057,10 +16964,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) => {
@@ -17179,9 +17085,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) => {
@@ -17200,8 +17122,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);
@@ -17478,7 +17403,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 }) => {
@@ -17767,6 +17692,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)];
   },
@@ -17775,11 +17703,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
        */
@@ -17790,16 +17717,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
        */
@@ -17827,13 +17750,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) => {
@@ -18541,12 +18460,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: {}
     };
@@ -18778,11 +18691,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]
     };
   },
@@ -18792,10 +18700,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 }) => {
@@ -18807,13 +18713,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 }) => {
@@ -19218,6 +19120,9 @@ const LineBreak = Node$1.create({
   selectable: false,
   content: "",
   atom: true,
+  addOptions() {
+    return {};
+  },
   parseDOM() {
     return [{ tag: "br" }];
   },
@@ -19226,17 +19131,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 }
     };
   },
@@ -19245,9 +19140,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 }) => {
@@ -19264,11 +19158,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",
@@ -19279,35 +19168,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 }
     };
   },
@@ -19333,9 +19202,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 }) => {
@@ -21725,17 +21593,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: {
@@ -21893,14 +21750,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);
@@ -21913,9 +21765,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, dispatch }) => {
         return deleteTable(state, dispatch);
@@ -21923,9 +21774,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, dispatch, chain }) => {
@@ -22302,10 +22152,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;
@@ -22431,24 +22280,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) => {
@@ -22485,10 +22322,6 @@ const TableRow = Node$1.create({
   },
   addAttributes() {
     return {
-      /**
-       * @category Attribute
-       * @param {number} [rowHeight] - Fixed row height in pixels
-       */
       rowHeight: {
         renderDOM({ rowHeight }) {
           if (!rowHeight) return {};
@@ -22496,11 +22329,6 @@ const TableRow = Node$1.create({
           return { style };
         }
       },
-      /**
-       * Indicates that this row should not be split across pages when paginating/exporting.
-       * @category Attribute
-       * @param {boolean} [cantSplit]
-       */
       cantSplit: {
         default: false,
         parseDOM() {
@@ -22512,44 +22340,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 }
@@ -22576,24 +22390,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) => {
@@ -22608,10 +22410,6 @@ const TableCell = Node$1.create({
           };
         }
       },
-      /**
-       * @category Attribute
-       * @param {CellBackground} [background] - Cell background color configuration
-       */
       background: {
         renderDOM({ background }) {
           if (!background) return {};
@@ -22620,10 +22418,6 @@ const TableCell = Node$1.create({
           return { style };
         }
       },
-      /**
-       * @category Attribute
-       * @param {string} [verticalAlign] - Vertical content alignment (top, middle, bottom)
-       */
       verticalAlign: {
         renderDOM({ verticalAlign }) {
           if (!verticalAlign) return {};
@@ -22631,10 +22425,6 @@ const TableCell = Node$1.create({
           return { style };
         }
       },
-      /**
-       * @category Attribute
-       * @param {CellMargins} [cellMargins] - Internal cell padding
-       */
       cellMargins: {
         renderDOM({ cellMargins }) {
           if (!cellMargins) return {};
@@ -22647,10 +22437,6 @@ const TableCell = Node$1.create({
           return { style };
         }
       },
-      /**
-       * @category Attribute
-       * @param {CellBorders} [borders] - Cell border configuration
-       */
       borders: {
         default: () => createCellBorders(),
         renderDOM({ borders }) {
@@ -22665,20 +22451,10 @@ const TableCell = Node$1.create({
           return { style };
         }
       },
-      /**
-       * @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
@@ -24308,7 +24084,7 @@ const validateUrlAccessibility = async (url) => {
       credentials: "omit"
     });
     return response.ok;
-  } catch (_error) {
+  } catch {
     return false;
   }
 };
@@ -24881,6 +24657,19 @@ const findPreviousDomNodeWithClass = (view, pos, className) => {
   }
   return null;
 };
+const getRotationMargins = (w, h, angleDegrees) => {
+  const rad = angleDegrees * (Math.PI / 180);
+  const cos = Math.abs(Math.cos(rad));
+  const sin = Math.abs(Math.sin(rad));
+  const boundingWidth = w * cos + h * sin;
+  const boundingHeight = w * sin + h * cos;
+  const marginLeftRight = Math.round(Math.max(0, (boundingWidth - w) / 2));
+  const marginTopBottom = Math.round(Math.max(0, (boundingHeight - h) / 2));
+  return {
+    horizontal: marginLeftRight,
+    vertical: marginTopBottom
+  };
+};
 const Image = Node$1.create({
   name: "image",
   group: "inline",
@@ -24902,10 +24691,6 @@ const Image = Node$1.create({
   },
   addAttributes() {
     return {
-      /**
-       * @category Attribute
-       * @param {string} [src] - Image source URL or path
-       */
       src: {
         default: null,
         renderDOM: ({ src }) => {
@@ -24914,95 +24699,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 style = "";
+          if (transformData?.rotation) {
+            style += `rotate(${Math.round(transformData.rotation)}deg) `;
+          }
+          if (transformData?.verticalFlip) {
+            style += "scaleY(-1) ";
+          }
+          if (transformData?.horizontalFlip) {
+            style += "scaleX(-1) ";
+          }
+          style = style.trim();
+          if (style.length > 0) {
+            return { style: `transform: ${style};` };
+          }
+          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, extension }) => {
           let style = "";
-          const { width, height } = size ?? {};
+          let { width, height } = size ?? {};
           if (width) style += `width: ${width}px;`;
           if (height && ["emf", "wmf"].includes(extension))
             style += `height: ${height}px; border: 1px solid black; position: absolute;`;
@@ -25010,51 +24775,58 @@ const Image = Node$1.create({
           return { style };
         }
       },
-      /**
-       * @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 = {}, padding, marginOffset, transformData }) => {
+          let { left: left2 = 0, top: top2 = 0, bottom: bottom2 = 0, right: right2 = 0 } = padding ?? {};
+          const { rotation } = transformData ?? {};
+          const { height, width } = size ?? {};
+          if (rotation && height && width) {
+            const { horizontal, vertical } = getRotationMargins(width, height, rotation);
+            left2 += horizontal;
+            right2 += horizontal;
+            top2 += vertical;
+            bottom2 += vertical;
+          }
           let style = "";
-          if (left2 && !marginOffset?.left) style += `margin-left: ${left2}px;`;
-          if (top2 && !marginOffset?.top) style += `margin-top: ${top2}px;`;
+          if (left2 && marginOffset?.left == null) style += `margin-left: ${left2}px;`;
+          if (top2 && marginOffset?.top == null) style += `margin-top: ${top2}px;`;
           if (bottom2) style += `margin-bottom: ${bottom2}px;`;
           if (right2) style += `margin-right: ${right2}px;`;
           return { style };
         }
       },
-      /**
-       * @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 }) => {
+          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 } = size ?? {};
+          if (rotation && height && width) {
+            const { horizontal, vertical } = getRotationMargins(width, height, rotation);
+            rotationLeft = horizontal;
+            rotationTop = vertical;
+          }
+          const left2 = baseLeft + rotationLeft;
+          const top2 = baseTop + rotationTop;
           let style = "";
           if (left2) style += `margin-left: ${left2}px;`;
           if (top2) {
             if (relativeFromPageV && top2 >= maxMarginV) style += `margin-top: ${maxMarginV}px;`;
             else style += `margin-top: ${top2}px;`;
           }
+          if (!style) return {};
           return { style };
         }
       },
-      /**
-       * @category Attribute
-       * @param {string} [style] - Custom inline CSS styles
-       */
       style: {
         default: null,
         rendered: true,
@@ -25080,18 +24852,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 }
@@ -25308,6 +25072,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, editor }) => {
         const { options } = editor;
         if (!options.isHeaderOrFooter) return false;
@@ -25370,6 +25142,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, editor }) => {
         const { options } = editor;
         if (!options.isHeaderOrFooter) return false;
@@ -25636,11 +25416,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
       }
@@ -25648,10 +25423,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 }) => {
@@ -25659,10 +25430,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 }) => {
@@ -25676,10 +25443,6 @@ const ContentBlock = Node$1.create({
           return { style };
         }
       },
-      /**
-       * @category Attribute
-       * @param {string} [background] - Background color for the block
-       */
       background: {
         default: null,
         renderDOM: (attrs) => {
@@ -25689,19 +25452,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
       }
@@ -25722,9 +25475,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 }) => {
@@ -25741,13 +25493,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'
        * })
@@ -25784,7 +25536,7 @@ class StructuredContentViewBase {
     this.htmlAttributes = props.htmlAttributes;
     this.mount(props);
   }
-  mount(props) {
+  mount() {
     return;
   }
   get dom() {
@@ -26275,16 +26027,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,
@@ -26293,25 +26036,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 }
     };
   },
@@ -26326,10 +26053,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>'
@@ -26410,9 +26136,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 }) => {
@@ -26438,9 +26163,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);
@@ -26460,9 +26184,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);
@@ -26479,16 +26202,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' }
@@ -26538,11 +26255,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 }) => {
@@ -26565,9 +26281,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 }) => {
@@ -26591,11 +26306,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 }) => {
@@ -26689,7 +26403,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) => {
@@ -26768,9 +26482,8 @@ const TextStyle = Mark.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
        */
@@ -26792,10 +26505,6 @@ const Bold = Mark.create({
   },
   addAttributes() {
     return {
-      /**
-       * @category Attribute
-       * @param {string} [value] - Bold weight value ('0' renders as normal)
-       */
       value: {
         default: null,
         renderDOM: (attrs) => {
@@ -26824,26 +26533,23 @@ const Bold = Mark.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)
     };
@@ -26878,25 +26584,22 @@ const Italic = Mark.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)
     };
@@ -26980,10 +26683,6 @@ const Highlight = Mark.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,
@@ -27011,26 +26710,23 @@ const Highlight = Mark.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)
     };
@@ -27063,9 +26759,8 @@ const Strike = Mark.create({
       /**
        * Apply strikethrough formatting
        * @category Command
-       * @returns {Function} Command
        * @example
-       * setStrike()
+       * editor.commands.setStrike()
        */
       setStrike: () => ({ commands: commands2 }) => {
         return commands2.setMark(this.name);
@@ -27073,9 +26768,8 @@ const Strike = Mark.create({
       /**
        * Remove strikethrough formatting
        * @category Command
-       * @returns {Function} Command
        * @example
-       * unsetStrike()
+       * editor.commands.unsetStrike()
        */
       unsetStrike: () => ({ commands: commands2 }) => {
         return commands2.unsetMark(this.name);
@@ -27083,9 +26777,8 @@ const Strike = Mark.create({
       /**
        * Toggle strikethrough formatting
        * @category Command
-       * @returns {Function} Command
        * @example
-       * toggleStrike()
+       * editor.commands.toggleStrike()
        */
       toggleStrike: () => ({ commands: commands2 }) => {
         return commands2.toggleMark(this.name);
@@ -27105,11 +26798,6 @@ const Link = Mark.create({
   inclusive: false,
   addOptions() {
     return {
-      /**
-       * Allowed URL protocols
-       * @type {string[]}
-       * @default ['http', 'https']
-       */
       protocols: ["http", "https"],
       htmlAttributes: {
         target: null,
@@ -27208,16 +26896,10 @@ const Link = Mark.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'
        * })
@@ -27269,9 +26951,8 @@ const Link = Mark.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 }) => {
@@ -27280,16 +26961,10 @@ const Link = Mark.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();
@@ -30606,6 +30281,9 @@ const Mentions = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-b
 const popoverPluginKey = new PluginKey("popoverPlugin");
 const PopoverPlugin = Extension.create({
   name: "popoverPlugin",
+  addOptions() {
+    return {};
+  },
   addPmPlugins() {
     const popover = new Plugin({
       key: popoverPluginKey,
@@ -32833,12 +32511,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} */
@@ -32854,13 +32531,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[]} */
@@ -32903,14 +32580,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} */
@@ -33172,6 +32848,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";