@harbour-enterprises/superdoc 0.11.31 → 0.11.33

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

@@ -6,14 +6,14 @@ var bt = (t, a, o) => a in t ? yt(t, a, { enumerable: !0, configurable: !0, writ
 var Re = (t, a, o) => bt(t, typeof a != "symbol" ? a + "" : a, o), qe = (t, a, o) => a.has(t) || Ue("Cannot " + o);
 var Ae = (t, a, o) => (qe(t, a, "read from private field"), o ? o.call(t) : a.get(t)), Oe = (t, a, o) => a.has(t) ? Ue("Cannot add the same private member more than once") : a instanceof WeakSet ? a.add(t) : a.set(t, o);
 var z = (t, a, o) => (qe(t, a, "access private method"), o);
-import { _ as q, a as Ze, b as wt, I as Ne, f as Ct, c as Ge, d as kt, i as _t, u as xt, r as Et, E as ze, e as St, P as At, h as Tt, M as Ft, j as It, A as Lt, N as Mt } from "./chunks/editor-GtdcYA5D.js";
-import { C as No, T as zo, l as Vo, n as Wo, k as Po, m as jo } from "./chunks/editor-GtdcYA5D.js";
-import { a1 as Dt, y as $t, a3 as Ht, T as Ye, a as Bt } from "./chunks/converter-hZK1xKPW.js";
-import { O as qo } from "./chunks/converter-hZK1xKPW.js";
+import { _ as q, a as Ze, b as wt, I as Ne, f as Ct, c as Ge, d as kt, i as _t, u as xt, r as St, E as ze, e as Et, P as At, h as Tt, M as Ft, j as It, A as Lt, N as Mt } from "./chunks/editor-CgA3W09D.js";
+import { C as No, T as zo, l as Vo, n as Wo, k as Po, m as jo } from "./chunks/editor-CgA3W09D.js";
+import { a1 as Dt, y as $t, a3 as Ht, T as Ye, a as Bt } from "./chunks/converter-0l3CSdnn.js";
+import { O as qo } from "./chunks/converter-0l3CSdnn.js";
 import { ref as f, createElementBlock as C, openBlock as w, createElementVNode as k, unref as D, getCurrentInstance as Rt, computed as j, watch as Ot, onMounted as ke, createCommentVNode as Q, withDirectives as Je, withKeys as Qe, normalizeClass as oe, withModifiers as ge, vModelText as et, createTextVNode as tt, toDisplayString as ie, Fragment as U, renderList as ee, normalizeStyle as J, createVNode as P, h as B, createApp as Nt, reactive as Ke, onUnmounted as zt, shallowRef as nt, onBeforeUnmount as ot, createBlock as Vt } from "vue";
-import { t as X, s as Wt, T as Pt, N as Y } from "./chunks/toolbar-Bk4txCKp.js";
+import { t as X, s as Wt, T as Pt, N as Y } from "./chunks/toolbar-Dk5ck8s2.js";
 import jt from "./ai-writer.es.js";
-import { D as Ko } from "./chunks/docx-zipper-DMEmQVkt.js";
+import { D as Ko } from "./chunks/docx-zipper-B-BWHBdZ.js";
 import { createZip as Zo } from "./file-zipper.es.js";
 var it = { exports: {} };
 (function(t) {
@@ -53,9 +53,9 @@ var it = { exports: {} };
     var d = o ? o + c : c, u = this._events[d];
     return u ? u.fn ? 1 : u.length : 0;
   }, l.prototype.emit = function(c, d, u, b, v, y) {
-    var E = o ? o + c : c;
-    if (!this._events[E]) return !1;
-    var g = this._events[E], F = arguments.length, $, p;
+    var S = o ? o + c : c;
+    if (!this._events[S]) return !1;
+    var g = this._events[S], F = arguments.length, $, p;
     if (g.fn) {
       switch (g.once && this.removeListener(c, g.fn, void 0, !0), F) {
         case 1:
@@ -110,8 +110,8 @@ var it = { exports: {} };
     if (y.fn)
       y.fn === d && (!b || y.once) && (!u || y.context === u) && r(this, v);
     else {
-      for (var E = 0, g = [], F = y.length; E < F; E++)
-        (y[E].fn !== d || b && !y[E].once || u && y[E].context !== u) && g.push(y[E]);
+      for (var S = 0, g = [], F = y.length; S < F; S++)
+        (y[S].fn !== d || b && !y[S].once || u && y[S].context !== u) && g.push(y[S]);
       g.length ? this._events[v] = g.length === 1 ? g[0] : g : r(this, v);
     }
     return this;
@@ -147,10 +147,10 @@ const x = (t) => {
     throw new Error("Toolbar button item needs either icon or label - " + t.name);
   if (!t.name)
     throw new Error("Invalid toolbar item name - " + t.name);
-  const o = f($t()), n = t.type, e = f(t.name), i = t.command, r = t.noArgumentCommand, l = f(t.icon), s = f(t.group || "center"), c = f(t.allowWithoutEditor), d = f(t.attributes || {}), u = t.disabled || !1, b = f(t.disabled), v = f(!1), y = f(!1), E = f(t.style), g = f(t.isNarrow), F = f(t.isWide), $ = f(t.minWidth), p = f(t.suppressActiveHighlight || !1), _ = f(t.argument), T = f(null), N = f(null), V = f(t.iconColor), te = f(t.hasCaret), ye = f(t.dropdownStyles), Z = f(t.tooltip), re = f(t.tooltipVisible), be = f(t.tooltipTimeout), I = f(t.defaultLabel), M = f(t.label), H = f(t.hideLabel), R = f(t.inlineTextInputVisible), G = f(t.hasInlineTextInput), K = f(t.markName), ce = f(t.labelAttr), ue = f(t.selectedValue), _e = f(t.dropdownValueKey), xe = f(t.inputRef || null), Ee = f([]);
+  const o = f($t()), n = t.type, e = f(t.name), i = t.command, r = t.noArgumentCommand, l = f(t.icon), s = f(t.group || "center"), c = f(t.allowWithoutEditor), d = f(t.attributes || {}), u = t.disabled || !1, b = f(t.disabled), v = f(!1), y = f(!1), S = f(t.style), g = f(t.isNarrow), F = f(t.isWide), $ = f(t.minWidth), p = f(t.suppressActiveHighlight || !1), _ = f(t.argument), T = f(null), N = f(null), V = f(t.iconColor), te = f(t.hasCaret), ye = f(t.dropdownStyles), Z = f(t.tooltip), re = f(t.tooltipVisible), be = f(t.tooltipTimeout), I = f(t.defaultLabel), M = f(t.label), H = f(t.hideLabel), R = f(t.inlineTextInputVisible), G = f(t.hasInlineTextInput), K = f(t.markName), ce = f(t.labelAttr), ue = f(t.selectedValue), _e = f(t.dropdownValueKey), xe = f(t.inputRef || null), Se = f([]);
   if (t.options) {
     if (!Array.isArray(t.options)) throw new Error("Invalid toolbar item options - " + t.options);
-    Ee.value.push(...t.options);
+    Se.value.push(...t.options);
   }
   const Fe = (se) => {
     we(se), !p.value && (v.value = !0);
@@ -178,8 +178,8 @@ const x = (t) => {
     disabled: b,
     active: v,
     expand: y,
-    nestedOptions: Ee,
-    style: E,
+    nestedOptions: Se,
+    style: S,
     isNarrow: g,
     isWide: F,
     minWidth: $,
@@ -296,7 +296,7 @@ const x = (t) => {
     }, l = f(!1), s = f(n.initialText), c = f(n.href), d = j(() => c.value?.startsWith("http") ? c.value : "http://" + c.value), u = j(() => {
       const p = d.value.split(".").filter(Boolean);
       return d.value.includes(".") && p.length > 1;
-    }), b = j(() => y.value ? "Apply" : "Remove"), v = j(() => !u.value), y = j(() => !E.value), E = j(() => n.href && !c.value), g = j(() => n.href.startsWith("#")), F = () => {
+    }), b = j(() => y.value ? "Apply" : "Remove"), v = j(() => !u.value), y = j(() => !S.value), S = j(() => n.href && !c.value), g = j(() => n.href.startsWith("#")), F = () => {
       window.open(d.value, "_blank");
     };
     Ot(
@@ -392,7 +392,7 @@ const x = (t) => {
       ], 10, yn))), 256))
     ]));
   }
-}, En = /* @__PURE__ */ q(xn, [["__scopeId", "data-v-f86e1477"]]), Sn = {
+}, Sn = /* @__PURE__ */ q(xn, [["__scopeId", "data-v-f86e1477"]]), En = {
   key: 0,
   class: "linked-style-buttons"
 }, An = ["onClick"], Tn = {
@@ -408,7 +408,7 @@ const x = (t) => {
     const o = a, n = t, e = (i) => {
       o("select", i);
     };
-    return (i, r) => n.editor ? (w(), C("div", Sn, [
+    return (i, r) => n.editor ? (w(), C("div", En, [
       (w(!0), C(U, null, ee(D(Ze)(t.editor), (l) => (w(), C("div", {
         class: "style-item",
         onClick: (s) => e(l)
@@ -603,7 +603,7 @@ const x = (t) => {
     h("#6CA0DC"),
     h("#9DBFE8"),
     h("#CEDFF3"),
-    h("#00E0FF")
+    h("#21c8ce")
   ],
   [
     h("#3E027A"),
@@ -625,8 +625,8 @@ const x = (t) => {
       let u = [...s.parentElement.querySelectorAll("[data-item]")], b = parseInt(s.dataset.cols, 10), v = parseInt(s.dataset.rows, 10);
       e.value = b, n.value = v;
       for (let y = 0; y < u.length; y++) {
-        let E = u[y], g = parseInt(E.dataset.cols, 10), F = parseInt(E.dataset.rows, 10);
-        g <= b && F <= v ? E.classList.add("selected") : E.classList.remove("selected");
+        let S = u[y], g = parseInt(S.dataset.cols, 10), F = parseInt(S.dataset.rows, 10);
+        g <= b && F <= v ? S.classList.add("selected") : S.classList.remove("selected");
       }
     }, r = ({ cols: l, rows: s }) => {
       o("select", { cols: l, rows: s });
@@ -848,8 +848,8 @@ const x = (t) => {
     ],
     onActivate: ({ fontSize: m }) => {
       if (!m) return s.label.value = s.defaultLabel.value;
-      let S = Wt(m, 12);
-      S < 8 && (S = 8), S > 96 && (S = 96), s.label.value = String(S);
+      let E = Wt(m, 12);
+      E < 8 && (E = 8), E > 96 && (E = 96), s.label.value = String(E);
     },
     onDeactivate: () => s.label.value = s.defaultLabel.value
   }), c = x({
@@ -911,7 +911,7 @@ const x = (t) => {
       v.iconColor.value = m;
     },
     onDeactivate: () => v.iconColor.value = "#000"
-  }), y = f(null), E = x({
+  }), y = f(null), S = x({
     type: "dropdown",
     name: "search",
     icon: e.search,
@@ -927,8 +927,8 @@ const x = (t) => {
     ]
   }), g = () => B("div", {}, [
     B(so, {
-      onSubmit: ({ value: S }) => {
-        t.activeEditor.commands.search(S);
+      onSubmit: ({ value: E }) => {
+        t.activeEditor.commands.search(E);
       },
       searchRef: y
     })
@@ -1083,9 +1083,9 @@ const x = (t) => {
   function ye(m) {
     return B(Qn, {
       options: te,
-      onSelect: (S) => {
+      onSelect: (E) => {
         ae(m);
-        const { command: A } = S;
+        const { command: A } = E;
         t.emitCommand({ item: m, argument: { command: A } });
       }
     });
@@ -1105,10 +1105,10 @@ const x = (t) => {
         type: "render",
         render: () => B("div", {}, [
           B(tn, {
-            onSelect: (S) => {
+            onSelect: (E) => {
               ae(Z);
               const A = { ...Z, command: "setTextAlign" };
-              A.command = "setTextAlign", t.emitCommand({ item: A, argument: S }), re(Z, S);
+              A.command = "setTextAlign", t.emitCommand({ item: A, argument: E }), re(Z, E);
             }
           })
         ]),
@@ -1121,8 +1121,8 @@ const x = (t) => {
     onDeactivate: () => {
       re(Z, "left");
     }
-  }), re = (m, S) => {
-    let A = S === "both" ? "justify" : S, W = {
+  }), re = (m, E) => {
+    let A = E === "both" ? "justify" : E, W = {
       left: e.alignLeft,
       right: e.alignRight,
       center: e.alignCenter,
@@ -1231,7 +1231,7 @@ const x = (t) => {
     command: "rejectTrackedChangeOnSelection",
     icon: e.trackChangesReject,
     group: "left"
-  }), Ee = x({
+  }), Se = x({
     type: "button",
     disabled: !1,
     name: "toggleTrackChangesShowOriginal",
@@ -1260,7 +1260,7 @@ const x = (t) => {
     u,
     H,
     M,
-    E,
+    S,
     R
   ].map((m) => m.name);
   const Le = x({
@@ -1269,7 +1269,7 @@ const x = (t) => {
     tooltip: "Format painter",
     icon: e.copyFormat,
     command: "copyFormat"
-  }), Me = (m, S) => m === "editor" ? S : m === "suggester" ? S.filter((A) => A.value === "suggesting") : S.filter((A) => A.value === "viewing"), we = (m) => m === "editor" ? "Editing" : m === "suggester" ? "Suggesting" : "Viewing", ne = x({
+  }), Me = (m, E) => m === "editor" ? E : m === "suggester" ? E.filter((A) => A.value === "suggesting") : E.filter((A) => A.value === "viewing"), we = (m) => m === "editor" ? "Editing" : m === "suggester" ? "Suggesting" : "Viewing", ne = x({
     type: "dropdown",
     name: "documentMode",
     command: "setDocumentMode",
@@ -1315,9 +1315,9 @@ const x = (t) => {
     }
   ];
   function me(m) {
-    const S = Me(n, De);
-    return B(En, {
-      options: S,
+    const E = Me(n, De);
+    return B(Sn, {
+      options: E,
       onSelect: (A) => {
         ae(m);
         const { label: W, icon: le } = A;
@@ -1367,10 +1367,10 @@ const x = (t) => {
         type: "render",
         key: "linkedStyle",
         render: () => {
-          const m = (S) => {
+          const m = (E) => {
             ae(Ce);
             const A = { ...Ce, command: "setLinkedStyle" };
-            t.emitCommand({ item: A, argument: S });
+            t.emitCommand({ item: A, argument: E });
           };
           return B("div", {}, [
             B(Fn, {
@@ -1387,8 +1387,8 @@ const x = (t) => {
     onDeactivate: () => {
       Ce.disabled.value = !0;
     }
-  }), he = (m, S) => {
-    if (S.value.toString() === m)
+  }), he = (m, E) => {
+    if (E.value.toString() === m)
       return B("div", { innerHTML: eo, class: "dropdown-select-icon" });
   }, de = x({
     type: "dropdown",
@@ -1461,34 +1461,34 @@ const x = (t) => {
   if (t.config?.superdoc?.config?.modules?.ai || (O = O.filter((m) => m.name.value !== "ai")), o <= $e.md && (O = O.filter((m) => m.type !== "separator")), t.config.pagination || (O = O.filter((m) => m.name.value !== "pageBreakTool")), t.config.mode !== "docx") {
     const m = O.findIndex((A) => A.name.value === "linkedStyles");
     O.splice(m - 1, 2);
-    const S = ["ruler", "zoom", "undo", "redo"];
-    O = O.filter((A) => !S.includes(A.name.value));
+    const E = ["ruler", "zoom", "undo", "redo"];
+    O = O.filter((A) => !E.includes(A.name.value));
   }
-  const je = [ue, Ee, Fe];
+  const je = [ue, Se, Fe];
   a || (n === "viewer" && je.push(_e, xe), O = O.filter((m) => !je.includes(m)));
-  const ft = [E, K, R, ne].map((m) => m.name), vt = (m) => ft.includes(m.name), Se = [], He = [];
+  const ft = [S, K, R, ne].map((m) => m.name), vt = (m) => ft.includes(m.name), Ee = [], He = [];
   let Be = mt + ut;
   return O.forEach((m) => {
-    const S = pe.get(m.name.value) || pe.get("default");
+    const E = pe.get(m.name.value) || pe.get("default");
     if (o < $e.xl && pt.includes(m.name.value)) {
-      if (Se.push(m), m.name.value === "linkedStyles") {
+      if (Ee.push(m), m.name.value === "linkedStyles") {
         const A = O.findIndex((W) => W.name.value === "linkedStyles");
         O.splice(A + 1, 1);
       }
       return;
     }
     if (o < $e.sm && ht.includes(m.name.value)) {
-      Se.push(m);
+      Ee.push(m);
       return;
     }
     if (vt(m)) {
-      He.push(m), Be += S;
+      He.push(m), Be += E;
       return;
     }
-    Be < o ? (He.push(m), Be += S) : Se.push(m);
+    Be < o ? (He.push(m), Be += E) : Ee.push(m);
   }), {
     defaultItems: He,
-    overflowItems: Se.filter((m) => m.type !== "separator")
+    overflowItems: Ee.filter((m) => m.type !== "separator")
   };
 }, ao = [".jpg", ".jpeg", ".png", "image/jpeg", "image/png"], ro = () => {
   let t = document.createElement("input");
@@ -1557,11 +1557,11 @@ const x = (t) => {
       let b = o.name.replace(" ", "_"), v = Ct(a.state, l);
       if (v == null)
         return;
-      let y = { type: "remove", id: l }, E = `word/media/${b}`, g = c.nodes.image.create({
-        src: E,
+      let y = { type: "remove", id: l }, S = `word/media/${b}`, g = c.nodes.image.create({
+        src: S,
         size: { width: i, height: r }
       });
-      t.storage.image.media = Object.assign(t.storage.image.media, { [E]: u }), t.options.ydoc && t.commands.addImageToCollaboration({ mediaPath: E, fileData: u }), a.dispatch(
+      t.storage.image.media = Object.assign(t.storage.image.media, { [S]: u }), t.options.ydoc && t.commands.addImageToCollaboration({ mediaPath: S, fileData: u }), a.dispatch(
         a.state.tr.replaceWith(v, v, g).setMeta(Ne, y)
       );
     },
@@ -1573,9 +1573,18 @@ const x = (t) => {
 };
 var L, lt, ve, We, at, rt, Pe, ct, fe;
 class Mo extends qt {
+  /**
+   * Creates a new SuperToolbar instance
+   * @param {ToolbarConfig} config - The configuration for the toolbar
+   * @returns {void}
+   */
   constructor(o) {
     super();
     Oe(this, L);
+    /**
+     * Default configuration for the toolbar
+     * @type {ToolbarConfig}
+     */
     Re(this, "config", {
       selector: null,
       toolbarGroups: ["left", "center", "right"],
@@ -1589,7 +1598,19 @@ class Mo extends qt {
       aiApiKey: null,
       aiEndpoint: null
     });
+    /**
+     * Custom commands that override default behavior
+     * @private
+     * @type {Object.<string, function(CommandItem): void>}
+     */
     Oe(this, ve, {
+      /**
+       * Handles zoom level changes
+       * @param {Object} params - Command parameters
+       * @param {CommandItem} params.item - The command item
+       * @param {string|number} params.argument - The zoom level (percentage)
+       * @returns {void}
+       */
       setZoom: ({ item: o, argument: n }) => {
         if (!n) return;
         o.onActivate({ zoom: n }), this.emit("superdoc-command", { item: o, argument: n });
@@ -1598,65 +1619,153 @@ class Mo extends qt {
         const i = typeof screen.orientation < "u", r = window.matchMedia("(max-width: 834px)").matches;
         i && r ? (e.style.transformOrigin = "0 0", e.style.transform = `scale(${parseInt(n) / 100})`) : e.style.zoom = parseInt(n) / 100, this.superdoc.superdocStore.activeZoom = parseInt(n);
       },
+      /**
+       * Sets the document mode
+       * @param {Object} params - Command parameters
+       * @param {CommandItem} params.item - The command item
+       * @param {string} params.argument - The document mode to set
+       * @returns {void}
+       */
       setDocumentMode: ({ item: o, argument: n }) => {
         n && this.emit("superdoc-command", { item: o, argument: n });
       },
+      /**
+       * Sets the font size for text
+       * @param {Object} params - Command parameters
+       * @param {CommandItem} params.item - The command item
+       * @param {string|number} params.argument - The font size to set
+       * @returns {void}
+       */
       setFontSize: ({ item: o, argument: n }) => {
         z(this, L, fe).call(this, { item: o, argument: n }, () => {
           this.activeEditor?.commands.setFieldAnnotationsFontSize(n, !0);
         });
       },
+      /**
+       * Sets the font family for text
+       * @param {Object} params - Command parameters
+       * @param {CommandItem} params.item - The command item
+       * @param {string} params.argument - The font family to set
+       * @returns {void}
+       */
       setFontFamily: ({ item: o, argument: n }) => {
         z(this, L, fe).call(this, { item: o, argument: n }, () => {
           this.activeEditor?.commands.setFieldAnnotationsFontFamily(n, !0);
         });
       },
+      /**
+       * Sets the text color
+       * @param {Object} params - Command parameters
+       * @param {CommandItem} params.item - The command item
+       * @param {string} params.argument - The color to set
+       * @returns {void}
+       */
       setColor: ({ item: o, argument: n }) => {
         z(this, L, fe).call(this, { item: o, argument: n }, () => {
           this.activeEditor?.commands.setFieldAnnotationsTextColor(n, !0);
         });
       },
+      /**
+       * Sets the highlight color for text
+       * @param {Object} params - Command parameters
+       * @param {CommandItem} params.item - The command item
+       * @param {string} params.argument - The highlight color to set
+       * @returns {void}
+       */
       setHighlight: ({ item: o, argument: n }) => {
         z(this, L, fe).call(this, { item: o, argument: n, noArgumentCallback: !0 }, () => {
           let e = n !== "none" ? n : null;
           this.activeEditor?.commands.setFieldAnnotationsTextHighlight(e, !0), this.activeEditor?.commands.setCellBackground(e);
         });
       },
-      toggleRuler: ({ item: o, argument: n }) => {
+      /**
+       * Toggles the ruler visibility
+       * @param {Object} [_params=null] - Command parameters (not used)
+       * @returns {void}
+       */
+      toggleRuler: (o = null) => {
         this.superdoc.toggleRuler();
       },
-      startImageUpload: async ({ item: o, argument: n }) => {
-        let i = await ro()();
-        i?.file && po({
+      /**
+       * Initiates the image upload process
+       * @async
+       * @param {Object} [_params=null - Command parameters (not used)
+       * @returns {Promise<void>}
+       */
+      startImageUpload: async (o = null) => {
+        let e = await ro()();
+        e?.file && po({
           editor: this.activeEditor,
           view: this.activeEditor.view,
-          file: i.file
+          file: e.file
         });
       },
+      /**
+       * Increases text indentation or list level
+       * @param {Object} params - Command parameters
+       * @param {CommandItem} params.item - The command item
+       * @param {*} params.argument - Command arguments
+       * @returns {void}
+       */
       increaseTextIndent: ({ item: o, argument: n }) => {
         let e = o.command, { state: i } = this.activeEditor;
         if (Ge((l) => l.type.name === "listItem")(i.selection))
           return this.activeEditor.commands.increaseListIndent();
         e in this.activeEditor.commands && this.activeEditor.commands[e](n);
       },
+      /**
+       * Decreases text indentation or list level
+       * @param {Object} params - Command parameters
+       * @param {CommandItem} params.item - The command item
+       * @param {*} params.argument - Command arguments
+       * @returns {boolean}
+       */
       decreaseTextIndent: ({ item: o, argument: n }) => {
         let e = o.command, { state: i } = this.activeEditor;
         if (Ge((l) => l.type.name === "listItem")(i.selection))
           return this.activeEditor.commands.decreaseListIndent();
         e in this.activeEditor.commands && this.activeEditor.commands[e](n);
       },
+      /**
+       * Toggles bold formatting for text
+       * @param {Object} params - Command parameters
+       * @param {CommandItem} params.item - The command item
+       * @param {*} params.argument - Command arguments
+       * @returns {void}
+       */
       toggleBold: ({ item: o, argument: n }) => {
         let e = o.command;
         e in this.activeEditor.commands && (this.activeEditor.commands[e](n), this.activeEditor.commands.toggleFieldAnnotationsFormat("bold", !0)), this.updateToolbarState();
       },
+      /**
+       * Toggles italic formatting for text
+       * @param {Object} params - Command parameters
+       * @param {CommandItem} params.item - The command item
+       * @param {*} params.argument - Command arguments
+       * @returns {void}
+       */
       toggleItalic: ({ item: o, argument: n }) => {
         let e = o.command;
         e in this.activeEditor.commands && (this.activeEditor.commands[e](n), this.activeEditor.commands.toggleFieldAnnotationsFormat("italic", !0)), this.updateToolbarState();
       },
+      /**
+       * Toggles underline formatting for text
+       * @param {Object} params - Command parameters
+       * @param {CommandItem} params.item - The command item
+       * @param {*} params.argument - Command arguments
+       * @returns {void}
+       */
       toggleUnderline: ({ item: o, argument: n }) => {
         let e = o.command;
         e in this.activeEditor.commands && (this.activeEditor.commands[e](n), this.activeEditor.commands.toggleFieldAnnotationsFormat("underline", !0)), this.updateToolbarState();
       },
+      /**
+       * Toggles link formatting and updates cursor position
+       * @param {Object} params - Command parameters
+       * @param {CommandItem} params.item - The command item
+       * @param {*} params.argument - Command arguments
+       * @returns {void}
+       */
       toggleLink: ({ item: o, argument: n }) => {
         let e = o.command;
         if (e in this.activeEditor.commands) {
@@ -1668,15 +1777,34 @@ class Mo extends qt {
         }
         this.updateToolbarState();
       },
+      /**
+       * Inserts a table into the document
+       * @param {Object} params - Command parameters
+       * @param {CommandItem} params.item - The command item
+       * @param {Object} params.argument - Table configuration
+       * @returns {void}
+       */
       insertTable: ({ item: o, argument: n }) => {
         z(this, L, fe).call(this, { item: o, argument: n });
       },
+      /**
+       * Executes a table-related command
+       * @param {Object} params - Command parameters
+       * @param {CommandItem} params.item - The command item
+       * @param {Object} params.argument - The table command and its parameters
+       * @param {string} params.argument.command - The specific table command to execute
+       * @returns {void}
+       */
       executeTableCommand: ({ item: o, argument: n }) => {
         if (!n) return;
         let e = n.command;
         e in this.activeEditor.commands && this.activeEditor.commands[e](n), this.updateToolbarState();
       }
     });
+    /**
+     * Handler for toolbar resize events
+     * @returns {void}
+     */
     Re(this, "onToolbarResize", () => {
       z(this, L, We).call(this, this, this.config.icons, this.isDev), this.role === "viewer" && z(this, L, Pe).call(this);
     });
@@ -1691,29 +1819,51 @@ class Mo extends qt {
     }
     this.app = Nt(Pt), this.app.directive("click-outside", Ht), this.app.config.globalProperties.$toolbar = this, n && (this.toolbar = this.app.mount(n)), this.activeEditor = o.editor || null, this.updateToolbarState();
   }
+  /**
+   * Log debug information to the console
+   * @param {...*} args - Arguments to log
+   * @returns {void}
+   */
   log(...o) {
     console.debug("[🎨 super-toolbar]", ...o);
   }
+  /**
+   * Set the zoom level
+   * @param {number} percent_int - The zoom percentage as an integer
+   * @returns {void}
+   */
   setZoom(o) {
     const e = [...this.toolbarItems, ...this.overflowItems].find((i) => i.name.value === "zoom");
     Ae(this, ve).setZoom({ item: e, argument: o });
   }
   /**
    * The toolbar expects an active Super Editor instance.
-   * @param {*} editor
+   * @param {Object} editor - The editor instance to attach to the toolbar
+   * @returns {void}
    */
   setActiveEditor(o) {
     this.activeEditor = o, this.activeEditor.on("transaction", this.onEditorTransaction.bind(this));
   }
+  /**
+   * Get toolbar items by group name
+   * @param {string} groupName - The name of the group
+   * @returns {ToolbarItem[]} An array of toolbar items in the specified group
+   */
   getToolbarItemByGroup(o) {
     return this.toolbarItems.filter((n) => n.group.value === o);
   }
+  /**
+   * Get a toolbar item by name
+   * @param {string} name - The name of the toolbar item
+   * @returns {ToolbarItem|undefined} The toolbar item with the specified name or undefined if not found
+   */
   getToolbarItemByName(o) {
     return this.toolbarItems.find((n) => n.name.value === o);
   }
   /**
-   * Update the toolbar state. Expects a list of marks in the form: { name, attrs }
-   * @param {Object} marks
+   * Update the toolbar state based on the current editor state
+   * Updates active/inactive state of all toolbar items
+   * @returns {void}
    */
   updateToolbarState() {
     if (z(this, L, ct).call(this), z(this, L, at).call(this), z(this, L, rt).call(this), !this.activeEditor || this.documentMode === "viewing") {
@@ -1747,16 +1897,21 @@ class Mo extends qt {
   }
   /**
    * React to editor transactions. Might want to debounce this.
+   * @param {Object} params - Transaction parameters
+   * @param {Object} params.editor - The editor instance (not used)
+   * @param {Object} params.transaction - The transaction object
+   * @returns {void}
    */
   onEditorTransaction({ editor: o, transaction: n }) {
     !n.docChanged && !n.selectionSet || this.updateToolbarState();
   }
   /**
-   * Main handler for toolbar commands.
-   *
-   * @param {Object} item is an instance of the useToolbarItem composable
-   * @param {Object} argument is the argument passed to the command
-   */
+   * Main handler for toolbar commands
+   * @param {CommandItem} params - Command parameters
+   * @param {ToolbarItem} params.item - An instance of the useToolbarItem composable
+   * @param {*} [params.argument] - The argument passed to the command
+   * @returns {*} The result of the executed command, undefined if no result is returned
+  */
   emitCommand({ item: o, argument: n }) {
     this.activeEditor?.focus();
     const { command: e } = o;
@@ -1770,9 +1925,22 @@ class Mo extends qt {
     }
   }
 }
-L = new WeakSet(), lt = function() {
+L = new WeakSet(), /**
+* Initiate toolbar groups
+* @private
+* @returns {void}
+*/
+lt = function() {
   this.config.groups && !Array.isArray(this.config.groups) && Object.keys(this.config.groups).length && (this.config.toolbarGroups = Object.keys(this.config.groups));
-}, ve = new WeakMap(), We = function(o, n, e = !1) {
+}, ve = new WeakMap(), /**
+ * Create toolbar items based on configuration
+ * @private
+ * @param {SuperToolbar} superToolbar - The toolbar instance
+ * @param {Object} icons - Icons to use for toolbar items
+ * @param {boolean} [isDev=false] - Whether in development mode
+ * @returns {void}
+ */
+We = function(o, n, e = !1) {
   const i = document.documentElement.clientWidth, { defaultItems: r, overflowItems: l } = lo(o, e, i, this.role, n);
   let s = [
     ...r.map((d) => d.name.value),
@@ -1781,13 +1949,23 @@ L = new WeakSet(), lt = function() {
   this.config.groups && (s = Object.values(this.config.groups).flatMap((d) => d));
   const c = r.filter((d) => s.includes(d.name.value)).filter((d) => !this.config.excludeItems.includes(d.name.value));
   this.toolbarItems = c, this.overflowItems = l.filter((d) => s.includes(d.name.value));
-}, at = function() {
+}, /**
+ * Initialize default fonts from the editor
+ * @private
+ * @returns {void}
+ */
+at = function() {
   if (!this.activeEditor || !this.activeEditor.converter) return;
   const { typeface: o = "Arial", fontSizePt: n = 12 } = this.activeEditor.converter.getDocumentDefaultStyles() ?? {}, e = this.toolbarItems.find((r) => r.name.value === "fontSize");
   e && (e.defaultLabel.value = n);
   const i = this.toolbarItems.find((r) => r.name.value === "fontFamily");
   i && (i.defaultLabel.value = o);
-}, rt = function() {
+}, /**
+ * Update highlight color options based on document colors
+ * @private
+ * @returns {void}
+ */
+rt = function() {
   if (!this.activeEditor || !this.activeEditor.converter || !this.activeEditor.converter.docHiglightColors.size) return;
   const o = this.toolbarItems.find((l) => l.name.value === "highlight"), n = Vn(), e = 7, i = Array.from(this.activeEditor.converter.docHiglightColors).reduce((l, s, c) => {
     const d = Math.floor(c / e);
@@ -1798,14 +1976,34 @@ L = new WeakSet(), lt = function() {
     render: () => Ve(this, o, i, !0)
   };
   o.nestedOptions.value = [r];
-}, Pe = function() {
+}, /**
+ * Deactivate all toolbar items
+ * @private
+ * @returns {void}
+ */
+Pe = function() {
   this.activeEditor = null, this.toolbarItems.forEach((o) => {
     const { allowWithoutEditor: n } = o;
     n.value || o.setDisabled(!0);
   });
-}, ct = function() {
-  this.activeEditor && (this.undoDepth = xt(this.activeEditor.state), this.redoDepth = Et(this.activeEditor.state));
-}, fe = function({ item: o, argument: n, noArgumentCallback: e = !1 }, i) {
+}, /**
+ * Update undo/redo history state in the toolbar
+ * @private
+ * @returns {void}
+ */
+ct = function() {
+  this.activeEditor && (this.undoDepth = xt(this.activeEditor.state), this.redoDepth = St(this.activeEditor.state));
+}, /**
+ * Run a command that requires an argument
+ * @private
+ * @param {CommandItem} params - Command parameters
+ * @param {ToolbarItem} params.item - The toolbar item
+ * @param {*} params.argument - The argument for the command
+ * @param {boolean} params.noArgumentCallback - Whether to call callback even if argument === 'none'
+ * @param {Function} [callback] - Optional callback to run after the command
+ * @returns {void}
+ */
+fe = function({ item: o, argument: n, noArgumentCallback: e = !1 }, i) {
   if (!n || !this.activeEditor) return;
   let r = o.command;
   const l = o.noArgumentCommand;
@@ -1838,8 +2036,8 @@ const fo = (t, a) => {
   if (s) {
     let c = s;
     if (l) {
-      const b = e.state.doc.resolve(s).textOffset, v = e.state.doc.nodeAt(s), E = v?.text?.charAt(b);
-      c = v?.isText && E !== " " ? s - 1 : s;
+      const b = e.state.doc.resolve(s).textOffset, v = e.state.doc.nodeAt(s), S = v?.text?.charAt(b);
+      c = v?.isText && S !== " " ? s - 1 : s;
     }
     const d = e.state.tr.setSelection(
       Ye.create(e.state.doc, c)
@@ -1864,7 +2062,7 @@ const fo = (t, a) => {
   },
   emits: ["margin-change"],
   setup(t, { emit: a }) {
-    const o = a, n = t, e = f(null), i = f([]), r = f("#CCCCCC"), l = f("#2563EB66"), s = f(null), c = f(null), d = f(!1), u = f(null), b = Ke({ side: "left", x: 0 }), v = Ke({ side: "right", x: 0 }), y = f(!1), E = f(0);
+    const o = a, n = t, e = f(null), i = f([]), r = f("#CCCCCC"), l = f("#2563EB66"), s = f(null), c = f(null), d = f(!1), u = f(null), b = Ke({ side: "left", x: 0 }), v = Ke({ side: "right", x: 0 }), y = f(!1), S = f(0);
     let g = 0;
     const F = () => {
       if (n.editor.options.mode !== "docx") return;
@@ -1903,13 +2101,13 @@ const fo = (t, a) => {
     }), N = (I) => {
       d.value = !0, ye();
       const M = I.currentTarget.id;
-      u.value = M === "left-margin-handle" ? b : v, E.value = u.value.x, g = I.clientX - u.value.x, y.value = !0;
+      u.value = M === "left-margin-handle" ? b : v, S.value = u.value.x, g = I.clientX - u.value.x, y.value = !0;
     }, V = (I) => {
       if (!d.value) return;
       const M = I.clientX - g;
       u.value.x = M, u.value.side === "left" ? M <= 0 ? u.value.x = 0 : M >= v.x - Te && (u.value.x = v.x - Te) : M >= s.value.width * 96 ? u.value.x = s.value.width * 96 : M <= b.x + Te && (u.value.x = b.x + Te);
     }, te = () => {
-      if (d.value = !1, y.value = !1, Z(), u.value && u.value.x !== E.value) {
+      if (d.value = !1, y.value = !1, Z(), u.value && u.value.x !== S.value) {
         const I = re();
         o("margin-change", {
           side: u.value.side,
@@ -2031,7 +2229,7 @@ const fo = (t, a) => {
         _.on("synced", T);
       }
     }, v = () => {
-      const p = St();
+      const p = Et();
       return n.options.pagination ? p : p.filter((_) => _.name !== "pagination");
     }, y = async ({ content: p, media: _ = {}, mediaFiles: T = {}, fonts: N = {} } = {}) => {
       i.value = new ze({
@@ -2053,7 +2251,7 @@ const fo = (t, a) => {
           e.value = !0;
         }, 150);
       });
-    }, E = (p) => {
+    }, S = (p) => {
       o("editor-keydown", { editor: i.value });
     }, g = (p) => {
       o("editor-click", { editor: i.value });
@@ -2085,7 +2283,7 @@ const fo = (t, a) => {
         class: "super-editor",
         ref_key: "editorWrapper",
         ref: r,
-        onKeydown: E,
+        onKeydown: S,
         onClick: g,
         onMousedown: F
       }, [
@@ -2158,7 +2356,7 @@ const fo = (t, a) => {
       }, null, 32)
     ]));
   }
-}, xo = ["innerHTML"], Eo = {
+}, xo = ["innerHTML"], So = {
   __name: "SuperInput",
   props: {
     modelValue: {
@@ -2183,8 +2381,8 @@ const fo = (t, a) => {
   emits: ["update:modelValue", "focus", "blur"],
   setup(t, { emit: a }) {
     const o = a, n = t, e = nt(), i = f(null), r = f(!1), l = ({ editor: v, transaction: y }) => {
-      const E = v.getHTML();
-      o("update:modelValue", E);
+      const S = v.getHTML();
+      o("update:modelValue", S);
     }, s = ({ editor: v, transaction: y }) => {
       r.value = !0, b(), o("focus", { editor: v, transaction: y });
     }, c = ({ editor: v, transaction: y }) => {
@@ -2223,7 +2421,7 @@ const fo = (t, a) => {
       }, null, 512)
     ], 2));
   }
-}, Ho = /* @__PURE__ */ q(Eo, [["__scopeId", "data-v-4d5cff52"]]), Bo = {
+}, Ho = /* @__PURE__ */ q(So, [["__scopeId", "data-v-4d5cff52"]]), Bo = {
   Node: Mt,
   Attribute: Lt,
   Extension: It,
@@ -2249,7 +2447,7 @@ export {
   mo as getAllowedImageDimensions,
   Wo as getMarksFromSelection,
   Tt as getRichTextExtensions,
-  St as getStarterExtensions,
+  Et as getStarterExtensions,
   Po as helpers,
   jo as trackChangesHelpers
 };