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

package/dist/chunks/{PdfViewer-Djd4zd7C.es.js → PdfViewer-DpUAoC7K.es.js}

@@ -1,6 +1,6 @@
 import { d as defineComponent, h, T as Transition, p as process$1, w as watchEffect, c as computed, r as ref, f as onMounted, X as onUnmounted, E as createElementBlock, G as openBlock, K as createBaseVNode, M as createCommentVNode, I as createVNode, v as unref } from "./vue-BnBKJwCW.es.js";
-import { N as NBaseLoading, u as useSuperdocStore, s as storeToRefs, a as useSelection } from "./index-ajHpG3f-.es.js";
-import { C as derived, r as c, q as cB, aF as fadeInTransition, y as cM, I as warnOnce, J as useConfig, N as useTheme, aG as pxfy, P as createKey, Q as useThemeClass, aH as useCompitable, ai as _export_sfc } from "./index-fbohTSaQ.es.js";
+import { N as NBaseLoading, u as useSuperdocStore, s as storeToRefs, a as useSelection } from "./index-DEYAgfRu.es.js";
+import { C as derived, r as c, q as cB, aF as fadeInTransition, y as cM, I as warnOnce, J as useConfig, N as useTheme, aG as pxfy, P as createKey, Q as useThemeClass, aH as useCompitable, ai as _export_sfc } from "./index-BB7PV6qA.es.js";
 function self(vars) {
   const {
     opacityDisabled,

package/dist/chunks/{PdfViewer-D_YseVgi.cjs → PdfViewer-Dy4TDA_a.cjs}

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const vue = require("./vue-De9wkgLl.cjs");
-const superdoc = require("./index-CyiEB9wO.cjs");
-const index = require("./index-D-7HfDnq.cjs");
+const superdoc = require("./index-CM_lykaH.cjs");
+const index = require("./index-vSyQ2hF9.cjs");
 function self(vars) {
   const {
     opacityDisabled,

package/dist/chunks/{SuperConverter-BAUfsE-s.es.js → SuperConverter-B4dnd1SO.es.js}

@@ -32669,7 +32669,7 @@ class SuperConverter {
   static getStoredSuperdocVersion(docx) {
     return SuperConverter.getStoredCustomProperty(docx, "SuperdocVersion");
   }
-  static setStoredSuperdocVersion(docx = this.convertedXml, version = "1.6.0-next.2") {
+  static setStoredSuperdocVersion(docx = this.convertedXml, version = "1.6.0-next.3") {
     return SuperConverter.setStoredCustomProperty(docx, "SuperdocVersion", version, false);
   }
   /**

package/dist/chunks/{SuperConverter-DrhNM5Cd.cjs → SuperConverter-UL6mfKlt.cjs}

@@ -32670,7 +32670,7 @@ class SuperConverter {
   static getStoredSuperdocVersion(docx) {
     return SuperConverter.getStoredCustomProperty(docx, "SuperdocVersion");
   }
-  static setStoredSuperdocVersion(docx = this.convertedXml, version = "1.6.0-next.2") {
+  static setStoredSuperdocVersion(docx = this.convertedXml, version = "1.6.0-next.3") {
     return SuperConverter.setStoredCustomProperty(docx, "SuperdocVersion", version, false);
   }
   /**

package/dist/chunks/{index-fbohTSaQ.es.js → index-BB7PV6qA.es.js}

@@ -1,6 +1,6 @@
 import { B as Buffer$2 } from "./jszip-B1fkPkPJ.es.js";
 import { t as twipsToInches, i as inchesToTwips, p as ptToTwips, l as linesToTwips, a as twipsToLines, b as pixelsToTwips, h as halfPointToPoints, c as twipsToPixels$2, d as convertSizeToCSS, e as inchesToPixels } from "./helpers-C8e9wR5l.es.js";
-import { g as generateDocxRandomId, T as TextSelection$1, o as objectIncludes, w as wrapTextsInRuns, D as DOMParser$1, c as createDocFromMarkdown, a as createDocFromHTML, b as chainableEditorState, d as convertMarkdownToHTML, f as findParentNode, e as findParentNodeClosestToPos, h as generateRandom32BitHex, i as generateRandomSigned32BitIntStrId, P as PluginKey, j as Plugin, M as Mapping, N as NodeSelection, k as Selection, l as Slice, m as DOMSerializer, F as Fragment, n as Mark$1, p as dropPoint, A as AllSelection, q as Schema$1, s as canSplit, t as resolveRunProperties, u as encodeMarksFromRPr, v as liftTarget, x as canJoin, y as joinPoint, z as replaceStep$1, R as ReplaceAroundStep$1, B as htmlHandler, C as ReplaceStep, E as getResolvedParagraphProperties, G as changeListLevel, H as isList$1, I as updateNumberingProperties, L as ListHelpers, J as inputRulesPlugin, K as TrackDeleteMarkName$1, O as TrackInsertMarkName$1, Q as TrackFormatMarkName$1, U as AddMarkStep, V as RemoveMarkStep, W as CommandService, S as SuperConverter, X as EditorState, Y as unflattenListsInHtml, Z as SelectionRange, _ as Transform, $ as createOoxmlResolver, a0 as translator, a1 as translator$1, a2 as resolveDocxFontFamily, a3 as combineIndentProperties, a4 as _getReferencedTableStyles, a5 as decodeRPrFromMarks, a6 as calculateResolvedParagraphProperties, a7 as encodeCSSFromPPr, a8 as encodeCSSFromRPr, a9 as generateOrderedListIndex, aa as docxNumberingHelpers, ab as InputRule, ac as insertNewRelationship, ad as kebabCase$1, ae as getUnderlineCssString } from "./SuperConverter-BAUfsE-s.es.js";
+import { g as generateDocxRandomId, T as TextSelection$1, o as objectIncludes, w as wrapTextsInRuns, D as DOMParser$1, c as createDocFromMarkdown, a as createDocFromHTML, b as chainableEditorState, d as convertMarkdownToHTML, f as findParentNode, e as findParentNodeClosestToPos, h as generateRandom32BitHex, i as generateRandomSigned32BitIntStrId, P as PluginKey, j as Plugin, M as Mapping, N as NodeSelection, k as Selection, l as Slice, m as DOMSerializer, F as Fragment, n as Mark$1, p as dropPoint, A as AllSelection, q as Schema$1, s as canSplit, t as resolveRunProperties, u as encodeMarksFromRPr, v as liftTarget, x as canJoin, y as joinPoint, z as replaceStep$1, R as ReplaceAroundStep$1, B as htmlHandler, C as ReplaceStep, E as getResolvedParagraphProperties, G as changeListLevel, H as isList$1, I as updateNumberingProperties, L as ListHelpers, J as inputRulesPlugin, K as TrackDeleteMarkName$1, O as TrackInsertMarkName$1, Q as TrackFormatMarkName$1, U as AddMarkStep, V as RemoveMarkStep, W as CommandService, S as SuperConverter, X as EditorState, Y as unflattenListsInHtml, Z as SelectionRange, _ as Transform, $ as createOoxmlResolver, a0 as translator, a1 as translator$1, a2 as resolveDocxFontFamily, a3 as combineIndentProperties, a4 as _getReferencedTableStyles, a5 as decodeRPrFromMarks, a6 as calculateResolvedParagraphProperties, a7 as encodeCSSFromPPr, a8 as encodeCSSFromRPr, a9 as generateOrderedListIndex, aa as docxNumberingHelpers, ab as InputRule, ac as insertNewRelationship, ad as kebabCase$1, ae as getUnderlineCssString } from "./SuperConverter-B4dnd1SO.es.js";
 import { p as process$1, r as ref, C as global$1, c as computed, E as createElementBlock, F as Fragment$1, S as renderList, O as withModifiers, G as openBlock, P as normalizeClass, M as createCommentVNode, H as toDisplayString, K as createBaseVNode, U as createApp, f as onMounted, X as onUnmounted, R as withDirectives, v as unref, Y as vModelText, y as nextTick, L as normalizeStyle, u as watch, Z as withKeys, _ as createTextVNode, I as createVNode, h as h$1, $ as readonly, s as getCurrentInstance, o as onBeforeUnmount, j as reactive, b as onBeforeMount, i as inject, a0 as onActivated, a1 as onDeactivated, a2 as Comment, d as defineComponent, a as provide, g as Teleport, t as toRef, a3 as renderSlot, a4 as isVNode, D as shallowRef, w as watchEffect, T as Transition, a5 as mergeProps, a6 as vShow, a7 as cloneVNode, a8 as Text$2, m as markRaw, N as createBlock, J as withCtx, a9 as useCssVars, V as resolveDynamicComponent, aa as normalizeProps, ab as guardReactiveProps } from "./vue-BnBKJwCW.es.js";
 import "./jszip.min-DCl8qkFO.es.js";
 import { E as EventEmitter$1 } from "./eventemitter3-CwrdEv8r.es.js";
@@ -13244,6 +13244,90 @@ const CommentsPlugin = Extension.create({
   name: "comments",
   addCommands() {
     return {
+      /**
+       * Add a comment to the current selection
+       * @category Command
+       * @param {string|Object} contentOrOptions - Comment content as a string, or an options object
+       * @param {string} [contentOrOptions.content] - The comment content (text or HTML)
+       * @param {string} [contentOrOptions.author] - Author name (defaults to user from editor config)
+       * @param {string} [contentOrOptions.authorEmail] - Author email (defaults to user from editor config)
+       * @param {string} [contentOrOptions.authorImage] - Author image URL (defaults to user from editor config)
+       * @param {boolean} [contentOrOptions.isInternal=false] - Whether the comment is internal/private
+       * @returns {boolean} True if the comment was added successfully, false otherwise
+       * @example
+       * // Simple usage with just content
+       * editor.commands.addComment('This needs review')
+       *
+       * // With options
+       * editor.commands.addComment({
+       *   content: 'Please clarify this section',
+       *   author: 'Jane Doe',
+       *   isInternal: true
+       * })
+       *
+       * // To get the comment ID, listen to the commentsUpdate event
+       * editor.on('commentsUpdate', (event) => {
+       *   if (event.type === 'add') {
+       *     console.log('New comment ID:', event.activeCommentId)
+       *   }
+       * })
+       */
+      addComment: (contentOrOptions) => ({ tr, dispatch, editor }) => {
+        const { selection } = tr;
+        const { $from, $to } = selection;
+        if ($from.pos === $to.pos) {
+          console.warn("addComment requires a text selection. Please select text before adding a comment.");
+          return false;
+        }
+        let content, author, authorEmail, authorImage, isInternal;
+        if (typeof contentOrOptions === "string") {
+          content = contentOrOptions;
+        } else if (contentOrOptions && typeof contentOrOptions === "object") {
+          content = contentOrOptions.content;
+          author = contentOrOptions.author;
+          authorEmail = contentOrOptions.authorEmail;
+          authorImage = contentOrOptions.authorImage;
+          isInternal = contentOrOptions.isInternal;
+        }
+        const commentId = v4();
+        const resolvedInternal = isInternal ?? false;
+        const configUser = editor.options?.user || {};
+        tr.setMeta(CommentsPluginKey, { event: "add" });
+        tr.addMark(
+          $from.pos,
+          $to.pos,
+          editor.schema.marks[CommentMarkName$1].create({
+            commentId,
+            internal: resolvedInternal
+          })
+        );
+        if (dispatch) dispatch(tr);
+        const commentPayload = normalizeCommentEventPayload({
+          conversation: {
+            commentId,
+            isInternal: resolvedInternal,
+            commentText: content,
+            creatorName: author ?? configUser.name,
+            creatorEmail: authorEmail ?? configUser.email,
+            creatorImage: authorImage ?? configUser.image,
+            createdTime: Date.now()
+          },
+          editorOptions: editor.options,
+          fallbackCommentId: commentId,
+          fallbackInternal: resolvedInternal
+        });
+        editor.emit("commentsUpdate", {
+          type: comments_module_events.ADD,
+          comment: commentPayload,
+          activeCommentId: commentId
+        });
+        return true;
+      },
+      /**
+       * @private
+       * Internal command to insert a comment mark at the current selection.
+       * Use `addComment` for the public API.
+       */
       insertComment: (conversation = {}) => ({ tr, dispatch }) => {
         const { selection } = tr;
         const { $from, $to } = selection;
@@ -15687,7 +15771,7 @@ const canUseDOM = () => {
     return false;
   }
 };
-const summaryVersion = "1.6.0-next.2";
+const summaryVersion = "1.6.0-next.3";
 const nodeKeys = ["group", "content", "marks", "inline", "atom", "defining", "code", "tableRole", "summary"];
 const markKeys = ["group", "inclusive", "excludes", "spanning", "code"];
 function mapAttributes(attrs) {
@@ -18354,7 +18438,7 @@ class Editor extends EventEmitter {
    * Process collaboration migrations
    */
   processCollaborationMigrations() {
-    console.debug("[checkVersionMigrations] Current editor version", "1.6.0-next.2");
+    console.debug("[checkVersionMigrations] Current editor version", "1.6.0-next.3");
     if (!this.options.ydoc) return;
     const metaMap = this.options.ydoc.getMap("meta");
     let docVersion = metaMap.get("version");

package/dist/chunks/{index-CyiEB9wO.cjs → index-CM_lykaH.cjs}

@@ -1,6 +1,6 @@
 "use strict";
-const index = require("./index-D-7HfDnq.cjs");
-require("./SuperConverter-DrhNM5Cd.cjs");
+const index = require("./index-vSyQ2hF9.cjs");
+require("./SuperConverter-UL6mfKlt.cjs");
 const blankDocx = require("./blank-docx-DfW3Eeh2.cjs");
 const eventemitter3 = require("./eventemitter3-BQuRcMPI.cjs");
 const provider = require("@hocuspocus/provider");
@@ -7530,7 +7530,7 @@ const _sfc_main = {
   __name: "SuperDoc",
   emits: ["selection-update"],
   setup(__props, { emit: __emit }) {
-    const PdfViewer = vue.defineAsyncComponent(() => Promise.resolve().then(() => require("./PdfViewer-D_YseVgi.cjs")));
+    const PdfViewer = vue.defineAsyncComponent(() => Promise.resolve().then(() => require("./PdfViewer-Dy4TDA_a.cjs")));
     const superdocStore = useSuperdocStore();
     const commentsStore = useCommentsStore();
     const {
@@ -8484,7 +8484,7 @@ class SuperDoc extends eventemitter3.EventEmitter {
     this.config.colors = shuffleArray(this.config.colors);
     this.userColorMap = /* @__PURE__ */ new Map();
     this.colorIndex = 0;
-    this.version = "1.6.0-next.2";
+    this.version = "1.6.0-next.3";
     this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
     this.superdocId = config.superdocId || uuid.v4();
     this.colors = this.config.colors;

package/dist/chunks/{index-ajHpG3f-.es.js → index-DEYAgfRu.es.js}

@@ -1,5 +1,5 @@
-import { B as BIT8, M as MAX_SAFE_INTEGER, c as create, a as BITS7, u as utf8TextDecoder, b as create$1, s as setIfUndefined, d as create$2, f as from, e as floor$1, g as equalityDeep, w as writeVarUint, h as writeVarString, t as toUint8Array, i as createEncoder, j as createInjectionKey, k as toString, l as throwError, m as useSsrAdapter, n as configProviderInjectionKey, o as cssrAnchorMetaName, p as globalStyle, q as cB, r as c, v as isMounted, x as commonVariables$2, y as cM, z as cNotM, A as cE, C as derived, D as changeColor, E as insideModal, F as insidePopover, G as resolveWrappedSlot, H as on, I as warnOnce, J as useConfig, K as useMergedState, L as useMemo, N as useTheme, O as useRtl, P as createKey, Q as useThemeClass, R as createId, S as call, T as render, U as messageProviderInjectionKey, V as messageApiInjectionKey, W as fromBase64, X as onChange, Y as varStorage, Z as toBase64, _ as createUint8ArrayFromArrayBuffer, $ as offChange, a0 as writeVarUint8Array, a1 as map, a2 as length, a3 as isNode, a4 as min, a5 as pow, a6 as comments_module_events, a7 as getFileObject, a8 as getTrackChanges, a9 as CommentsPluginKey, aa as TrackChangesBasePluginKey, ab as Editor, ac as getRichTextExtensions, ad as ellipsisVerticalSvg, ae as xmarkIconSvg, af as checkIconSvg, ag as caretDownIconSvg, ah as commentIconSvg, ai as _export_sfc, aj as NDropdown, ak as SuperInput, al as vClickOutside, am as PresentationEditor, an as SuperEditor, ao as AIWriter, ap as NConfigProvider, aq as SuperToolbar } from "./index-fbohTSaQ.es.js";
-import "./SuperConverter-BAUfsE-s.es.js";
+import { B as BIT8, M as MAX_SAFE_INTEGER, c as create, a as BITS7, u as utf8TextDecoder, b as create$1, s as setIfUndefined, d as create$2, f as from, e as floor$1, g as equalityDeep, w as writeVarUint, h as writeVarString, t as toUint8Array, i as createEncoder, j as createInjectionKey, k as toString, l as throwError, m as useSsrAdapter, n as configProviderInjectionKey, o as cssrAnchorMetaName, p as globalStyle, q as cB, r as c, v as isMounted, x as commonVariables$2, y as cM, z as cNotM, A as cE, C as derived, D as changeColor, E as insideModal, F as insidePopover, G as resolveWrappedSlot, H as on, I as warnOnce, J as useConfig, K as useMergedState, L as useMemo, N as useTheme, O as useRtl, P as createKey, Q as useThemeClass, R as createId, S as call, T as render, U as messageProviderInjectionKey, V as messageApiInjectionKey, W as fromBase64, X as onChange, Y as varStorage, Z as toBase64, _ as createUint8ArrayFromArrayBuffer, $ as offChange, a0 as writeVarUint8Array, a1 as map, a2 as length, a3 as isNode, a4 as min, a5 as pow, a6 as comments_module_events, a7 as getFileObject, a8 as getTrackChanges, a9 as CommentsPluginKey, aa as TrackChangesBasePluginKey, ab as Editor, ac as getRichTextExtensions, ad as ellipsisVerticalSvg, ae as xmarkIconSvg, af as checkIconSvg, ag as caretDownIconSvg, ah as commentIconSvg, ai as _export_sfc, aj as NDropdown, ak as SuperInput, al as vClickOutside, am as PresentationEditor, an as SuperEditor, ao as AIWriter, ap as NConfigProvider, aq as SuperToolbar } from "./index-BB7PV6qA.es.js";
+import "./SuperConverter-B4dnd1SO.es.js";
 import { B as BlankDOCX } from "./blank-docx-ABm6XYAA.es.js";
 import { E as EventEmitter } from "./eventemitter3-CwrdEv8r.es.js";
 import { HocuspocusProvider, HocuspocusProviderWebsocket } from "@hocuspocus/provider";
@@ -7513,7 +7513,7 @@ const _sfc_main = {
   __name: "SuperDoc",
   emits: ["selection-update"],
   setup(__props, { emit: __emit }) {
-    const PdfViewer = defineAsyncComponent(() => import("./PdfViewer-Djd4zd7C.es.js"));
+    const PdfViewer = defineAsyncComponent(() => import("./PdfViewer-DpUAoC7K.es.js"));
     const superdocStore = useSuperdocStore();
     const commentsStore = useCommentsStore();
     const {
@@ -8467,7 +8467,7 @@ class SuperDoc extends EventEmitter {
     this.config.colors = shuffleArray(this.config.colors);
     this.userColorMap = /* @__PURE__ */ new Map();
     this.colorIndex = 0;
-    this.version = "1.6.0-next.2";
+    this.version = "1.6.0-next.3";
     this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
     this.superdocId = config.superdocId || v4();
     this.colors = this.config.colors;

package/dist/chunks/{index-D-7HfDnq.cjs → index-vSyQ2hF9.cjs}

@@ -1,7 +1,7 @@
 "use strict";
 const jszip = require("./jszip-C8_CqJxM.cjs");
 const helpers$1 = require("./helpers-nOdwpmwb.cjs");
-const superEditor_converter = require("./SuperConverter-DrhNM5Cd.cjs");
+const superEditor_converter = require("./SuperConverter-UL6mfKlt.cjs");
 const vue = require("./vue-De9wkgLl.cjs");
 require("./jszip.min-BPh2MMAa.cjs");
 const eventemitter3 = require("./eventemitter3-BQuRcMPI.cjs");
@@ -13261,6 +13261,90 @@ const CommentsPlugin = Extension.create({
   name: "comments",
   addCommands() {
     return {
+      /**
+       * Add a comment to the current selection
+       * @category Command
+       * @param {string|Object} contentOrOptions - Comment content as a string, or an options object
+       * @param {string} [contentOrOptions.content] - The comment content (text or HTML)
+       * @param {string} [contentOrOptions.author] - Author name (defaults to user from editor config)
+       * @param {string} [contentOrOptions.authorEmail] - Author email (defaults to user from editor config)
+       * @param {string} [contentOrOptions.authorImage] - Author image URL (defaults to user from editor config)
+       * @param {boolean} [contentOrOptions.isInternal=false] - Whether the comment is internal/private
+       * @returns {boolean} True if the comment was added successfully, false otherwise
+       * @example
+       * // Simple usage with just content
+       * editor.commands.addComment('This needs review')
+       *
+       * // With options
+       * editor.commands.addComment({
+       *   content: 'Please clarify this section',
+       *   author: 'Jane Doe',
+       *   isInternal: true
+       * })
+       *
+       * // To get the comment ID, listen to the commentsUpdate event
+       * editor.on('commentsUpdate', (event) => {
+       *   if (event.type === 'add') {
+       *     console.log('New comment ID:', event.activeCommentId)
+       *   }
+       * })
+       */
+      addComment: (contentOrOptions) => ({ tr, dispatch, editor }) => {
+        const { selection } = tr;
+        const { $from, $to } = selection;
+        if ($from.pos === $to.pos) {
+          console.warn("addComment requires a text selection. Please select text before adding a comment.");
+          return false;
+        }
+        let content, author, authorEmail, authorImage, isInternal;
+        if (typeof contentOrOptions === "string") {
+          content = contentOrOptions;
+        } else if (contentOrOptions && typeof contentOrOptions === "object") {
+          content = contentOrOptions.content;
+          author = contentOrOptions.author;
+          authorEmail = contentOrOptions.authorEmail;
+          authorImage = contentOrOptions.authorImage;
+          isInternal = contentOrOptions.isInternal;
+        }
+        const commentId = uuid.v4();
+        const resolvedInternal = isInternal ?? false;
+        const configUser = editor.options?.user || {};
+        tr.setMeta(CommentsPluginKey, { event: "add" });
+        tr.addMark(
+          $from.pos,
+          $to.pos,
+          editor.schema.marks[CommentMarkName$1].create({
+            commentId,
+            internal: resolvedInternal
+          })
+        );
+        if (dispatch) dispatch(tr);
+        const commentPayload = normalizeCommentEventPayload({
+          conversation: {
+            commentId,
+            isInternal: resolvedInternal,
+            commentText: content,
+            creatorName: author ?? configUser.name,
+            creatorEmail: authorEmail ?? configUser.email,
+            creatorImage: authorImage ?? configUser.image,
+            createdTime: Date.now()
+          },
+          editorOptions: editor.options,
+          fallbackCommentId: commentId,
+          fallbackInternal: resolvedInternal
+        });
+        editor.emit("commentsUpdate", {
+          type: comments_module_events.ADD,
+          comment: commentPayload,
+          activeCommentId: commentId
+        });
+        return true;
+      },
+      /**
+       * @private
+       * Internal command to insert a comment mark at the current selection.
+       * Use `addComment` for the public API.
+       */
       insertComment: (conversation = {}) => ({ tr, dispatch }) => {
         const { selection } = tr;
         const { $from, $to } = selection;
@@ -15704,7 +15788,7 @@ const canUseDOM = () => {
     return false;
   }
 };
-const summaryVersion = "1.6.0-next.2";
+const summaryVersion = "1.6.0-next.3";
 const nodeKeys = ["group", "content", "marks", "inline", "atom", "defining", "code", "tableRole", "summary"];
 const markKeys = ["group", "inclusive", "excludes", "spanning", "code"];
 function mapAttributes(attrs) {
@@ -18371,7 +18455,7 @@ class Editor extends EventEmitter {
    * Process collaboration migrations
    */
   processCollaborationMigrations() {
-    console.debug("[checkVersionMigrations] Current editor version", "1.6.0-next.2");
+    console.debug("[checkVersionMigrations] Current editor version", "1.6.0-next.3");
     if (!this.options.ydoc) return;
     const metaMap = this.options.ydoc.getMap("meta");
     let docVersion = metaMap.get("version");

package/dist/super-editor/converter.cjs

@@ -2,6 +2,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 require("../chunks/jszip-C8_CqJxM.cjs");
 require("../chunks/helpers-nOdwpmwb.cjs");
-const superEditor_converter = require("../chunks/SuperConverter-DrhNM5Cd.cjs");
+const superEditor_converter = require("../chunks/SuperConverter-UL6mfKlt.cjs");
 require("../chunks/uuid-R7L08bOx.cjs");
 exports.SuperConverter = superEditor_converter.SuperConverter;

package/dist/super-editor/converter.es.js

@@ -1,6 +1,6 @@
 import "../chunks/jszip-B1fkPkPJ.es.js";
 import "../chunks/helpers-C8e9wR5l.es.js";
-import { S } from "../chunks/SuperConverter-BAUfsE-s.es.js";
+import { S } from "../chunks/SuperConverter-B4dnd1SO.es.js";
 import "../chunks/uuid-CjlX8hrF.es.js";
 export {
   S as SuperConverter

package/dist/super-editor.cjs

@@ -1,10 +1,10 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const index = require("./chunks/index-D-7HfDnq.cjs");
+const index = require("./chunks/index-vSyQ2hF9.cjs");
 const superEditor_docxZipper = require("./super-editor/docx-zipper.cjs");
 const superEditor_fileZipper = require("./super-editor/file-zipper.cjs");
 const vue = require("./chunks/vue-De9wkgLl.cjs");
-const superEditor_converter = require("./chunks/SuperConverter-DrhNM5Cd.cjs");
+const superEditor_converter = require("./chunks/SuperConverter-UL6mfKlt.cjs");
 function isNodeType(node, name) {
   return node.type.name === name;
 }

package/dist/super-editor.es.js

@@ -1,9 +1,9 @@
-import { ax as Node, ay as Mark } from "./chunks/index-fbohTSaQ.es.js";
-import { ao, au, a9, ab, aw, am, av, aA, an, ak, aq, az, aa, as, aC, aE, aB, ac, aD, ar, at } from "./chunks/index-fbohTSaQ.es.js";
+import { ax as Node, ay as Mark } from "./chunks/index-BB7PV6qA.es.js";
+import { ao, au, a9, ab, aw, am, av, aA, an, ak, aq, az, aa, as, aC, aE, aB, ac, aD, ar, at } from "./chunks/index-BB7PV6qA.es.js";
 import { default as default2 } from "./super-editor/docx-zipper.es.js";
 import { createZip } from "./super-editor/file-zipper.es.js";
 import { d as defineComponent, E as createElementBlock, G as openBlock, K as createBaseVNode } from "./chunks/vue-BnBKJwCW.es.js";
-import { S, r } from "./chunks/SuperConverter-BAUfsE-s.es.js";
+import { S, r } from "./chunks/SuperConverter-B4dnd1SO.es.js";
 function isNodeType(node, name) {
   return node.type.name === name;
 }

package/dist/superdoc.cjs

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const index = require("./chunks/index-D-7HfDnq.cjs");
-const superdoc = require("./chunks/index-CyiEB9wO.cjs");
-const superEditor_converter = require("./chunks/SuperConverter-DrhNM5Cd.cjs");
+const index = require("./chunks/index-vSyQ2hF9.cjs");
+const superdoc = require("./chunks/index-CM_lykaH.cjs");
+const superEditor_converter = require("./chunks/SuperConverter-UL6mfKlt.cjs");
 const blankDocx = require("./chunks/blank-docx-DfW3Eeh2.cjs");
 require("./chunks/jszip-C8_CqJxM.cjs");
 require("./chunks/helpers-nOdwpmwb.cjs");

package/dist/superdoc.es.js

@@ -1,6 +1,6 @@
-import { au, ab, aw, av, as, a7, ac, ar, at } from "./chunks/index-fbohTSaQ.es.js";
-import { D, H, P, S, c } from "./chunks/index-ajHpG3f-.es.js";
-import { S as S2, r } from "./chunks/SuperConverter-BAUfsE-s.es.js";
+import { au, ab, aw, av, as, a7, ac, ar, at } from "./chunks/index-BB7PV6qA.es.js";
+import { D, H, P, S, c } from "./chunks/index-DEYAgfRu.es.js";
+import { S as S2, r } from "./chunks/SuperConverter-B4dnd1SO.es.js";
 import { B } from "./chunks/blank-docx-ABm6XYAA.es.js";
 import "./chunks/jszip-B1fkPkPJ.es.js";
 import "./chunks/helpers-C8e9wR5l.es.js";

package/dist/superdoc.umd.js

@@ -38097,7 +38097,7 @@ Please report this to https://github.com/markedjs/marked.`, e) {
     static getStoredSuperdocVersion(docx) {
       return SuperConverter.getStoredCustomProperty(docx, "SuperdocVersion");
     }
-    static setStoredSuperdocVersion(docx = this.convertedXml, version2 = "1.6.0-next.2") {
+    static setStoredSuperdocVersion(docx = this.convertedXml, version2 = "1.6.0-next.3") {
       return SuperConverter.setStoredCustomProperty(docx, "SuperdocVersion", version2, false);
     }
     /**
@@ -51265,6 +51265,90 @@ Please report this to https://github.com/markedjs/marked.`, e) {
     name: "comments",
     addCommands() {
       return {
+        /**
+         * Add a comment to the current selection
+         * @category Command
+         * @param {string|Object} contentOrOptions - Comment content as a string, or an options object
+         * @param {string} [contentOrOptions.content] - The comment content (text or HTML)
+         * @param {string} [contentOrOptions.author] - Author name (defaults to user from editor config)
+         * @param {string} [contentOrOptions.authorEmail] - Author email (defaults to user from editor config)
+         * @param {string} [contentOrOptions.authorImage] - Author image URL (defaults to user from editor config)
+         * @param {boolean} [contentOrOptions.isInternal=false] - Whether the comment is internal/private
+         * @returns {boolean} True if the comment was added successfully, false otherwise
+         * @example
+         * // Simple usage with just content
+         * editor.commands.addComment('This needs review')
+         *
+         * // With options
+         * editor.commands.addComment({
+         *   content: 'Please clarify this section',
+         *   author: 'Jane Doe',
+         *   isInternal: true
+         * })
+         *
+         * // To get the comment ID, listen to the commentsUpdate event
+         * editor.on('commentsUpdate', (event) => {
+         *   if (event.type === 'add') {
+         *     console.log('New comment ID:', event.activeCommentId)
+         *   }
+         * })
+         */
+        addComment: (contentOrOptions) => ({ tr, dispatch, editor }) => {
+          const { selection } = tr;
+          const { $from, $to } = selection;
+          if ($from.pos === $to.pos) {
+            console.warn("addComment requires a text selection. Please select text before adding a comment.");
+            return false;
+          }
+          let content2, author, authorEmail, authorImage, isInternal;
+          if (typeof contentOrOptions === "string") {
+            content2 = contentOrOptions;
+          } else if (contentOrOptions && typeof contentOrOptions === "object") {
+            content2 = contentOrOptions.content;
+            author = contentOrOptions.author;
+            authorEmail = contentOrOptions.authorEmail;
+            authorImage = contentOrOptions.authorImage;
+            isInternal = contentOrOptions.isInternal;
+          }
+          const commentId = v4();
+          const resolvedInternal = isInternal ?? false;
+          const configUser = editor.options?.user || {};
+          tr.setMeta(CommentsPluginKey, { event: "add" });
+          tr.addMark(
+            $from.pos,
+            $to.pos,
+            editor.schema.marks[CommentMarkName$1].create({
+              commentId,
+              internal: resolvedInternal
+            })
+          );
+          if (dispatch) dispatch(tr);
+          const commentPayload = normalizeCommentEventPayload({
+            conversation: {
+              commentId,
+              isInternal: resolvedInternal,
+              commentText: content2,
+              creatorName: author ?? configUser.name,
+              creatorEmail: authorEmail ?? configUser.email,
+              creatorImage: authorImage ?? configUser.image,
+              createdTime: Date.now()
+            },
+            editorOptions: editor.options,
+            fallbackCommentId: commentId,
+            fallbackInternal: resolvedInternal
+          });
+          editor.emit("commentsUpdate", {
+            type: comments_module_events.ADD,
+            comment: commentPayload,
+            activeCommentId: commentId
+          });
+          return true;
+        },
+        /**
+         * @private
+         * Internal command to insert a comment mark at the current selection.
+         * Use `addComment` for the public API.
+         */
         insertComment: (conversation = {}) => ({ tr, dispatch }) => {
           const { selection } = tr;
           const { $from, $to } = selection;
@@ -64183,7 +64267,7 @@ Please report this to https://github.com/markedjs/marked.`, e) {
       return false;
     }
   };
-  const summaryVersion = "1.6.0-next.2";
+  const summaryVersion = "1.6.0-next.3";
   const nodeKeys = ["group", "content", "marks", "inline", "atom", "defining", "code", "tableRole", "summary"];
   const markKeys = ["group", "inclusive", "excludes", "spanning", "code"];
   function mapAttributes(attrs) {
@@ -66851,7 +66935,7 @@ Please report this to https://github.com/markedjs/marked.`, e) {
      * Process collaboration migrations
      */
     processCollaborationMigrations() {
-      console.debug("[checkVersionMigrations] Current editor version", "1.6.0-next.2");
+      console.debug("[checkVersionMigrations] Current editor version", "1.6.0-next.3");
       if (!this.options.ydoc) return;
       const metaMap = this.options.ydoc.getMap("meta");
       let docVersion = metaMap.get("version");
@@ -150269,7 +150353,7 @@ ${reason}`);
       this.config.colors = shuffleArray(this.config.colors);
       this.userColorMap = /* @__PURE__ */ new Map();
       this.colorIndex = 0;
-      this.version = "1.6.0-next.2";
+      this.version = "1.6.0-next.3";
       this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
       this.superdocId = config2.superdocId || v4();
       this.colors = this.config.colors;