@harbour-enterprises/superdoc 0.18.0-next.2 → 0.18.0-next.3

package/dist/super-editor/chunks/{editor-Dlzi1Ni6.js → editor-CAEseNKq.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, 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, c as callOrGet, g as getExtensionConfigField, b as getMarkType, d as getMarksFromSelection, e as getNodeType, f as getSchemaTypeNameByName, S as Schema$1, h as cleanSchemaItem, T as TextSelection, N as NodeSelection, i as canSplit, j as defaultBlockAt$1, l as liftTarget, A as AllSelection, k as canJoin, m as joinPoint, n as Selection, r as replaceStep$1, o as Slice, F as Fragment, R as ReplaceAroundStep$1, p as isTextSelection, q as getMarkRange, s as isMarkActive, t as isNodeActive, u as deleteProps, D as DOMParser$1, v as ReplaceStep, w as NodeRange, x as findWrapping, L as ListHelpers, y as findParentNode, z as isMacOS, B as isIOS, C as DOMSerializer, E as Mark$1, G as dropPoint, H as process$1, I as Buffer2, J as getSchemaTypeByName, K as inputRulesPlugin, O as TrackDeleteMarkName, Q as TrackInsertMarkName, U as v4, V as TrackFormatMarkName, W as comments_module_events, X as findMark, Y as objectIncludes, Z as AddMarkStep, _ as RemoveMarkStep, $ as twipsToLines, a0 as pixelsToTwips, a1 as helpers, a2 as posToDOMRect, a3 as CommandService, a4 as SuperConverter, a5 as createDocument, a6 as createDocFromMarkdown, a7 as createDocFromHTML, a8 as EditorState, a9 as hasSomeParentWithClass, aa as isActive, ab as unflattenListsInHtml, ac as parseSizeUnit, ad as minMax, ae as getLineHeightValueString, af as InputRule, ag as kebabCase, ah as findParentNodeClosestToPos, ai as getListItemStyleDefinitions, aj as docxNumberigHelpers, ak as parseIndentElement, al as combineIndents, am as StepMap, an as getColStyleDeclaration, ao as SelectionRange, ap as Transform, aq as isInTable$1, ar as createColGroup, as as generateDocxRandomId, at as insertNewRelationship, au as htmlHandler } from "./converter-DdzGurMJ.js";
+import { P as PluginKey, a as Plugin, M as Mapping, c as callOrGet, g as getExtensionConfigField, b as getMarkType, d as getMarksFromSelection, e as getNodeType, f as getSchemaTypeNameByName, S as Schema$1, h as cleanSchemaItem, T as TextSelection, N as NodeSelection, i as canSplit, j as defaultBlockAt$1, l as liftTarget, A as AllSelection, k as canJoin, m as joinPoint, n as Selection, r as replaceStep$1, o as Slice, F as Fragment, R as ReplaceAroundStep$1, p as isTextSelection, q as getMarkRange, s as isMarkActive, t as isNodeActive, u as deleteProps, D as DOMParser$1, v as ReplaceStep, w as NodeRange, x as findWrapping, L as ListHelpers, y as findParentNode, z as isMacOS, B as isIOS, C as DOMSerializer, E as Mark$1, G as dropPoint, H as process$1, I as Buffer2, J as getSchemaTypeByName, K as inputRulesPlugin, O as TrackDeleteMarkName, Q as TrackInsertMarkName, U as v4, V as TrackFormatMarkName, W as comments_module_events, X as findMark, Y as objectIncludes, Z as AddMarkStep, _ as RemoveMarkStep, $ as twipsToLines, a0 as pixelsToTwips, a1 as helpers, a2 as posToDOMRect, a3 as CommandService, a4 as SuperConverter, a5 as createDocument, a6 as createDocFromMarkdown, a7 as createDocFromHTML, a8 as EditorState, a9 as hasSomeParentWithClass, aa as isActive, ab as unflattenListsInHtml, ac as parseSizeUnit, ad as minMax, ae as getLineHeightValueString, af as InputRule, ag as kebabCase, ah as findParentNodeClosestToPos, ai as getListItemStyleDefinitions, aj as docxNumberigHelpers, ak as parseIndentElement, al as combineIndents, am as StepMap, an as getColStyleDeclaration, ao as SelectionRange, ap as Transform, aq as isInTable$1, ar as createColGroup, as as generateDocxRandomId, at as insertNewRelationship, au as htmlHandler } from "./converter-YnaMMkRN.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-Bjul2JVv.js";
+import { D as DocxZipper } from "./docx-zipper-Bq9-qqP_.js";
 var GOOD_LEAF_SIZE = 200;
 var RopeSequence = function RopeSequence2() {
 };
@@ -15279,6 +15279,10 @@ const TextAlign = Extension.create({
       {
         types: this.options.types,
         attributes: {
+          /**
+           * @category Attribute
+           * @param {string} [textAlign='left'] - Text alignment value (left, center, right, justify)
+           */
           textAlign: {
             default: this.options.defaultAlignment,
             parseDOM: (el) => {
@@ -15299,11 +15303,32 @@ const TextAlign = Extension.create({
   },
   addCommands() {
     return {
+      /**
+       * 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')
+       * @note Applies to all configured node types (heading, paragraph by default)
+       */
       setTextAlign: (alignment) => ({ commands: commands2 }) => {
         const containsAlignment = this.options.alignments.includes(alignment);
         if (!containsAlignment) return false;
         return this.options.types.map((type) => commands2.updateAttributes(type, { textAlign: alignment })).every((result) => result);
       },
+      /**
+       * Remove text alignment (reset to default)
+       * @category Command
+       * @returns {Function} Command function
+       * @example
+       * unsetTextAlign()
+       * @note Resets alignment to the default value
+       */
       unsetTextAlign: () => ({ commands: commands2 }) => {
         return this.options.types.map((type) => commands2.resetAttributes(type, "textAlign")).every((result) => result);
       }
@@ -15334,6 +15359,10 @@ const TextIndent = Extension.create({
       {
         types: this.options.types,
         attributes: {
+          /**
+           * @category Attribute
+           * @param {string} [textIndent] - Text indentation value with unit (e.g., '0.5in')
+           */
           textIndent: {
             default: null,
             parseDOM: (el) => el.style.textIndent,
@@ -15351,13 +15380,43 @@ const TextIndent = Extension.create({
   },
   addCommands() {
     return {
+      /**
+       * Set text indentation
+       * @category Command
+       * @param {string} indent - Indentation value with unit (e.g., '0.5in', '2cm')
+       * @returns {Function} Command function
+       * @example
+       * // Set to 0.5 inches
+       * setTextIndent('0.5in')
+       *
+       * // Set to 2 centimeters
+       * setTextIndent('2cm')
+       * @note Accepts any valid CSS unit (in, cm, px, em, etc.)
+       */
       setTextIndent: (indent) => ({ commands: commands2 }) => {
         if (!indent) return false;
         return this.options.types.map((type) => commands2.updateAttributes(type, { textIndent: indent })).every((result) => result);
       },
+      /**
+       * Remove text indentation
+       * @category Command
+       * @returns {Function} Command function
+       * @example
+       * unsetTextIndent()
+       * @note Removes all indentation from the selected nodes
+       */
       unsetTextIndent: () => ({ commands: commands2 }) => {
         return this.options.types.map((type) => commands2.resetAttributes(type, "textIndent")).every((result) => result);
       },
+      /**
+       * Increase text indentation
+       * @category Command
+       * @returns {Function} Command function
+       * @example
+       * increaseTextIndent()
+       * @note Increments by the default value (0.125in by default)
+       * @note Creates initial indent if none exists
+       */
       increaseTextIndent: () => ({ commands: commands2 }) => {
         return this.options.types.map((type) => {
           let { textIndent } = this.editor.getAttributes(type);
@@ -15368,7 +15427,7 @@ const TextIndent = Extension.create({
             });
           }
           let [value, unit] = parseSizeUnit(textIndent);
-          value = value + this.options.defaults.increment;
+          value = Number(value) + this.options.defaults.increment;
           unit = unit ? unit : this.options.defaults.unit;
           if (Number.isNaN(value)) return false;
           return commands2.updateAttributes(type, {
@@ -15376,12 +15435,21 @@ const TextIndent = Extension.create({
           });
         }).every((result) => result);
       },
+      /**
+       * Decrease text indentation
+       * @category Command
+       * @returns {Function} Command function
+       * @example
+       * decreaseTextIndent()
+       * @note Decrements by the default value (0.125in by default)
+       * @note Removes indentation completely if it reaches 0 or below
+       */
       decreaseTextIndent: () => ({ commands: commands2 }) => {
         return this.options.types.map((type) => {
           let { textIndent } = this.editor.getAttributes(type);
           if (!textIndent) return false;
           let [value, unit] = parseSizeUnit(textIndent);
-          value = value - this.options.defaults.increment;
+          value = Number(value) - this.options.defaults.increment;
           unit = unit ? unit : this.options.defaults.unit;
           if (Number.isNaN(value)) return false;
           if (value <= 0) {
@@ -15950,8 +16018,17 @@ const Gapcursor = Extension.create({
   addPmPlugins() {
     return [gapCursor()];
   },
+  /**
+   * Extend node schema to allow gap cursor positioning
+   * @returns {Object} Schema extension with allowGapCursor property
+   */
   extendNodeSchema(extension) {
     return {
+      /**
+       * Whether to allow gap cursor before/after this node
+       * Set to false on nodes where gap cursor shouldn't appear
+       * @type {boolean|null}
+       */
       allowGapCursor: callOrGet(
         getExtensionConfigField(extension, "allowGapCursor", {
           name: extension.name,
@@ -17013,10 +17090,12 @@ const getLinkedStyle = (styleId, styles = []) => {
 };
 const getSpacingStyle = (spacing) => {
   const { lineSpaceBefore, lineSpaceAfter, line, lineRule } = spacing;
+  const lineHeightResult = getLineHeightValueString(line, "", lineRule, true);
+  const lineHeightStyles = typeof lineHeightResult === "object" && lineHeightResult !== null ? lineHeightResult : {};
   return {
     "margin-top": lineSpaceBefore + "px",
     "margin-bottom": lineSpaceAfter + "px",
-    ...getLineHeightValueString(line, "", lineRule, true)
+    ...lineHeightStyles
   };
 };
 const getSpacingStyleString = (spacing) => {
@@ -17201,6 +17280,11 @@ const createLinkedStylesPlugin = (editor) => {
   return new Plugin({
     key: LinkedStylesPluginKey,
     state: {
+      /**
+       * Initialize plugin state with styles and decorations
+       * @returns {Object} Initial state with styles and decorations
+       * @private
+       */
       init() {
         if (!editor.converter || editor.options.mode !== "docx") return {};
         const styles = editor.converter?.linkedStyles || [];
@@ -17209,6 +17293,15 @@ const createLinkedStylesPlugin = (editor) => {
           decorations: generateDecorations(editor.state, styles)
         };
       },
+      /**
+       * Update decorations when document changes
+       * @param {Object} tr - The transaction
+       * @param {Object} prev - Previous plugin state
+       * @param {Object} oldEditorState - Old editor state
+       * @param {Object} newEditorState - New editor state
+       * @returns {Object} Updated state with styles and decorations
+       * @private
+       */
       apply(tr, prev, oldEditorState, newEditorState) {
         if (!editor.converter || editor.options.mode !== "docx") return { ...prev };
         let decorations = prev.decorations || DecorationSet.empty;
@@ -17220,6 +17313,12 @@ const createLinkedStylesPlugin = (editor) => {
       }
     },
     props: {
+      /**
+       * Provide decorations to the editor view
+       * @param {Object} state - Current editor state
+       * @returns {Object} The decoration set
+       * @private
+       */
       decorations(state) {
         return LinkedStylesPluginKey.getState(state)?.decorations;
       }
@@ -17261,24 +17360,35 @@ const LinkedStyles = Extension.create({
   addCommands() {
     return {
       /**
-       * Apply a linked style to the current selection.
-       *
-       * @param {object} style The linked style to apply
-       * @param {string} style.id The style ID (e.g., 'Heading1')
-       * @returns {boolean} Whether the style was correctly applied
+       * Apply a linked style to the selected paragraphs
+       * @category Command
+       * @param {Object} style - The style object to apply
+       * @returns {Function} Command function
+       * @example
+       * const style = editor.helpers.linkedStyles.getStyleById('Heading1');
+       * setLinkedStyle(style);
+       * @note Clears existing formatting when applying a style
+       * @note Works with custom selection preservation
        */
       setLinkedStyle: (style) => (params2) => {
         const { tr } = params2;
         return applyLinkedStyleToTransaction(tr, this.editor, style);
       },
       /**
-       * Toggle a linked style on the current selection.
+       * Toggle a linked style on the current selection
+       * @category Command
+       * @param {Object} 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)
        *
-       * @param {object} style The linked style to apply
-       * @param {string} style.id The style ID (e.g., 'Heading1')
-       * @param {string|null} nodeType The node type to restrict the toggle to (e.g., 'paragraph'). If null,
-       * the style can be toggled on any node type.
-       * @returns {boolean} Whether the style was correctly applied/removed
+       * // Toggle only on paragraph nodes
+       * toggleLinkedStyle(style, 'paragraph')
+       * @note If selection is empty, returns false
+       * @note Removes style if already applied, applies it if not
        */
       toggleLinkedStyle: (style, nodeType = null) => (params2) => {
         const { tr } = params2;
@@ -17301,9 +17411,17 @@ const LinkedStyles = Extension.create({
         return applyLinkedStyleToTransaction(tr, this.editor, style);
       },
       /**
-       * Apply a linked style by its ID.
-       * @param {string} styleId The style ID (e.g., 'Heading1')
-       * @returns {boolean} Whether the style was correctly applied
+       * 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')
+       * @note Looks up the style from loaded Word styles
        */
       setStyleById: (styleId) => (params2) => {
         const { state, tr } = params2;
@@ -17318,22 +17436,39 @@ const LinkedStyles = Extension.create({
   addHelpers() {
     return {
       /**
-       * Get all linked styles available in the editor
+       * Get all available linked styles
+       * @category Helper
        * @returns {Array} Array of linked style objects
+       * @example
+       * const styles = editor.helpers.linkedStyles.getStyles();
+       * // Returns all styles from the Word document
        */
       getStyles: () => {
         const styles = LinkedStylesPluginKey.getState(this.editor.state)?.styles || [];
         return styles;
       },
       /**
-       * Get a linked style by its ID
-       * @param {string} styleId The style ID (e.g., 'Heading1')
-       * @returns {object|null} The linked style object or null if not found
+       * Get a specific style by ID
+       * @category Helper
+       * @param {string} styleId - The style ID to find
+       * @returns {Object} The style object or undefined
+       * @example
+       * const headingStyle = editor.helpers.linkedStyles.getStyleById('Heading1');
        */
       getStyleById: (styleId) => {
         const styles = this.editor.helpers[this.name].getStyles();
         return styles.find((s) => s.id === styleId);
       },
+      /**
+       * Get the CSS string for a style
+       * @category Helper
+       * @param {string} styleId - The style ID
+       * @returns {string} CSS style string
+       * @example
+       * const css = editor.helpers.linkedStyles.getLinkedStyleString('Heading1');
+       * // Returns: "font-size: 16pt; font-weight: bold; color: #2E74B5"
+       * @private
+       */
       getLinkedStyleString: (styleId) => {
         const styles = this.editor.helpers.linkedStyles.getStyles();
         const style = styles.find((s) => s.id === styleId);
@@ -23712,6 +23847,10 @@ const Image = Node$1.create({
   },
   addAttributes() {
     return {
+      /**
+       * @category Attribute
+       * @param {string} [src] - Image source URL or path
+       */
       src: {
         default: null,
         renderDOM: ({ src }) => {
@@ -23720,31 +23859,90 @@ 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
       },
+      /**
+       * @category Attribute
+       * @param {boolean} [isAnchor] - Whether image is anchored
+       * @private
+       */
       isAnchor: { rendered: false },
+      /**
+       * @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 }) => {
@@ -23757,6 +23955,14 @@ 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 }) => {
@@ -23769,6 +23975,12 @@ const Image = Node$1.create({
           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 }) => {
@@ -23784,6 +23996,10 @@ const Image = Node$1.create({
           return { style };
         }
       },
+      /**
+       * @category Attribute
+       * @param {string} [style] - Custom inline CSS styles
+       */
       style: {
         default: null,
         rendered: true,
@@ -23806,6 +24022,27 @@ const Image = Node$1.create({
   },
   addCommands() {
     return {
+      /**
+       * 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
+       * @example
+       * // Insert an image from a URL
+       * setImage({ src: 'https://example.com/image.jpg' })
+       *
+       * // Insert a base64 encoded image
+       * setImage({
+       *   src: 'data:image/png;base64,...',
+       *   alt: 'Company logo',
+       *   size: { width: 200 }
+       * })
+       * @note Supports URLs, relative paths, and base64 data URIs
+       */
       setImage: (options) => ({ commands: commands2 }) => {
         return commands2.insertContent({
           type: this.name,
@@ -23843,7 +24080,9 @@ const getFileOpener = () => {
 const handleImageUpload = (file) => {
   return new Promise((resolve, reject) => {
     let reader = new FileReader();
-    reader.onload = (event) => resolve(event.target.result);
+    reader.onload = (event) => {
+      resolve(event.target.result);
+    };
     reader.onerror = reject;
     setTimeout(() => reader.readAsDataURL(file), 250);
   });
@@ -24047,8 +24286,8 @@ async function uploadImage({ editor, view, file, size, uploadHandler }) {
     let rId = null;
     if (editor.options.mode === "docx") {
       const [, path] = mediaPath.split("word/");
-      const id2 = addImageRelationship({ editor, path });
-      if (id2) rId = id2;
+      const imageid = addImageRelationship({ editor, path });
+      if (imageid) rId = imageid;
     }
     let imageNode = schema.nodes.image.create({
       src: mediaPath,
@@ -24071,8 +24310,8 @@ function addImageRelationship({ editor, path }) {
   const target = path;
   const type = "image";
   try {
-    const id = insertNewRelationship(target, type, editor);
-    return id;
+    const relationshipId = insertNewRelationship(target, type, editor);
+    return relationshipId;
   } catch {
     return null;
   }
@@ -25185,6 +25424,17 @@ const BlockNode = Extension.create({
   name: "blockNode",
   addCommands() {
     return {
+      /**
+       * 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
+       * @example
+       * const newParagraph = editor.schema.nodes.paragraph.create({}, editor.schema.text('New content'))
+       * replaceBlockNodeById('block-123', newParagraph)
+       * @note The replacement node should have the same type as the original
+       */
       replaceBlockNodeById: (id, contentNode) => ({ dispatch, tr }) => {
         const blockNode = this.editor.helpers.blockNode.getBlockNodeById(id);
         if (!blockNode || blockNode.length > 1) {
@@ -25201,6 +25451,15 @@ const BlockNode = Extension.create({
         }
         return true;
       },
+      /**
+       * 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')
+       * @note Completely removes the node from the document
+       */
       deleteBlockNodeById: (id) => ({ dispatch, tr }) => {
         const blockNode = this.editor.helpers.blockNode.getBlockNodeById(id);
         if (!blockNode || blockNode.length > 1) {
@@ -25217,6 +25476,18 @@ const BlockNode = Extension.create({
         }
         return true;
       },
+      /**
+       * Update attributes of a block node by its ID
+       * @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' })
+       * @example
+       * updateBlockNodeAttributes('block-123', { indent: { left: 20 } })
+       * @note Merges new attributes with existing ones
+       */
       updateBlockNodeAttributes: (id, attrs = {}) => ({ dispatch, tr }) => {
         const blockNode = this.editor.helpers.blockNode.getBlockNodeById(id);
         if (!blockNode || blockNode.length > 1) {
@@ -25239,15 +25510,54 @@ const BlockNode = Extension.create({
   },
   addHelpers() {
     return {
+      /**
+       * Get all block nodes in the document
+       * @category Helper
+       * @returns {Array<BlockNodeInfo>} Array of block node info objects
+       * @example
+       * const blocks = editor.helpers.blockNode.getBlockNodes()
+       * console.log(`Found ${blocks.length} block nodes`)
+       */
       getBlockNodes: () => {
         return findChildren(this.editor.state.doc, (node) => nodeAllowsSdBlockIdAttr(node));
       },
+      /**
+       * Get a specific block node by its ID
+       * @category Helper
+       * @param {string} id - The sdBlockId to search for
+       * @returns {Array<BlockNodeInfo>} Array containing the matching node (or empty)
+       * @example
+       * const block = editor.helpers.blockNode.getBlockNodeById('block-123')
+       * if (block.length) console.log('Found:', block[0].node.type.name)
+       */
       getBlockNodeById: (id) => {
         return findChildren(this.editor.state.doc, (node) => node.attrs.sdBlockId === id);
       },
+      /**
+       * Get all block nodes of a specific type
+       * @category Helper
+       * @param {string} type - The node type name (e.g., 'paragraph', 'heading')
+       * @returns {Array<BlockNodeInfo>} Array of matching block nodes
+       * @example
+       * const paragraphs = editor.helpers.blockNode.getBlockNodesByType('paragraph')
+       * const headings = editor.helpers.blockNode.getBlockNodesByType('heading')
+       */
       getBlockNodesByType: (type) => {
         return findChildren(this.editor.state.doc, (node) => node.type.name === type);
       },
+      /**
+       * Get all block nodes within a position range
+       * @category Helper
+       * @param {number} from - Start position
+       * @param {number} to - End position
+       * @returns {Array<BlockNodeInfo>} Array of block nodes in the range
+       * @example
+       * const selection = editor.state.selection
+       * const blocksInSelection = editor.helpers.blockNode.getBlockNodesInRange(
+       *   selection.from,
+       *   selection.to
+       * )
+       */
       getBlockNodesInRange: (from2, to) => {
         let blockNodes = [];
         this.editor.state.doc.nodesBetween(from2, to, (node, pos) => {
@@ -25303,10 +25613,11 @@ const nodeNeedsSdBlockId = (node) => {
   return !currentId;
 };
 const checkForNewBlockNodesInTrs = (transactions) => {
-  return transactions.some((tr) => {
+  return Array.from(transactions).some((tr) => {
     return tr.steps.some((step) => {
+      if (!(step instanceof ReplaceStep)) return false;
       const hasValidSdBlockNodes = step.slice?.content?.content?.some((node) => nodeAllowsSdBlockIdAttr(node));
-      return step instanceof ReplaceStep && hasValidSdBlockNodes;
+      return hasValidSdBlockNodes;
     });
   });
 };
@@ -25335,6 +25646,10 @@ const TextStyle = Mark.create({
   },
   addAttributes() {
     return {
+      /**
+       * @category Attribute
+       * @param {string} [styleId] - Style identifier for referencing predefined styles
+       */
       styleId: {}
     };
   },
@@ -25343,10 +25658,11 @@ const TextStyle = Mark.create({
       /**
        * Remove empty text style marks
        * @category Command
-       * @returns {Function} Command - Removes mark if no attributes present
+       * @returns {Function} Command function - Removes mark if no attributes present
        * @example
        * removeEmptyTextStyle()
        * @note Cleanup utility to prevent empty span elements
+       * @note Automatically checks if any style attributes exist before removal
        */
       removeEmptyTextStyle: () => ({ state, commands: commands2 }) => {
         const attributes = Attribute.getMarkAttributes(state, this.type);
@@ -26368,12 +26684,16 @@ const TextTransform = Extension.create({
       {
         types: this.options.types,
         attributes: {
+          /**
+           * @category Attribute
+           * @param {string} [textTransform] - Text transform value (uppercase, lowercase, capitalize, none)
+           */
           textTransform: {
             default: null,
             renderDOM: (attrs) => {
-              if (!attrs.textCase) return {};
+              if (!attrs.textTransform) return {};
               return {
-                style: `text-transform: ${attrs.textCase}`
+                style: `text-transform: ${attrs.textTransform}`
               };
             }
           }