@harbour-enterprises/superdoc 1.0.0-beta.3 → 1.0.0-beta.5

package/dist/chunks/{PdfViewer-CxHbcDGx.cjs → PdfViewer-B2yJpudB.cjs}

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const vue = require("./vue-ARQSyfaw.cjs");
-const superdoc = require("./index-Dp3rVMnX.cjs");
+const superdoc = require("./index-DcKcwu3F.cjs");
 function self(vars) {
   const {
     opacityDisabled,

package/dist/chunks/{PdfViewer-CKzs9Ct5.es.js → PdfViewer-Ebg4DPUi.es.js}

@@ -1,5 +1,5 @@
 import { y as defineComponent, z as h, O as Transition, $ as process$1, J as watchEffect, a as computed, r as ref, j as onMounted, W as onUnmounted, b as createElementBlock, o as openBlock, f as createBaseVNode, e as createCommentVNode, u as createVNode, v as unref } from "./vue-CztqUvm1.es.js";
-import { d as derived, c, a as cB, f as fadeInTransition, b as cM, N as NBaseLoading, w as warnOnce, u as useConfig, e as useTheme, p as pxfy, g as createKey, h as useThemeClass, i as useCompitable, _ as _export_sfc, j as useSuperdocStore, s as storeToRefs, k as useSelection } from "./index-DukSDI8_.es.js";
+import { d as derived, c, a as cB, f as fadeInTransition, b as cM, N as NBaseLoading, w as warnOnce, u as useConfig, e as useTheme, p as pxfy, g as createKey, h as useThemeClass, i as useCompitable, _ as _export_sfc, j as useSuperdocStore, s as storeToRefs, k as useSelection } from "./index-6_t69RiQ.es.js";
 function self(vars) {
   const {
     opacityDisabled,

package/dist/chunks/{index-DukSDI8_.es.js → index-6_t69RiQ.es.js}

@@ -1,4 +1,4 @@
-import { q as index, C as CommentsPluginKey, h as TrackChangesBasePluginKey, E as Editor, n as getRichTextExtensions, f as SuperInput, P as PresentationEditor, e as SuperEditor, A as AIWriter, g as SuperToolbar, i as createZip } from "./super-editor.es-BRKZG90h.es.js";
+import { q as index, C as CommentsPluginKey, h as TrackChangesBasePluginKey, E as Editor, n as getRichTextExtensions, f as SuperInput, P as PresentationEditor, e as SuperEditor, A as AIWriter, g as SuperToolbar, i as createZip } from "./super-editor.es-0TS__OEc.es.js";
 import { B as BlankDOCX } from "./blank-docx-ABm6XYAA.es.js";
 import { E as EventEmitter } from "./eventemitter3-ByBH0NYV.es.js";
 import { HocuspocusProvider, HocuspocusProviderWebsocket } from "@hocuspocus/provider";
@@ -17210,7 +17210,7 @@ const _sfc_main = {
   __name: "SuperDoc",
   emits: ["selection-update"],
   setup(__props, { emit: __emit }) {
-    const PdfViewer = defineAsyncComponent(() => import("./PdfViewer-CKzs9Ct5.es.js"));
+    const PdfViewer = defineAsyncComponent(() => import("./PdfViewer-Ebg4DPUi.es.js"));
     const superdocStore = useSuperdocStore();
     const commentsStore = useCommentsStore();
     const {
@@ -18063,7 +18063,7 @@ class SuperDoc extends EventEmitter {
     this.config.colors = shuffleArray(this.config.colors);
     this.userColorMap = /* @__PURE__ */ new Map();
     this.colorIndex = 0;
-    this.version = "1.0.0-beta.3";
+    this.version = "1.0.0-beta.5";
     this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
     this.superdocId = config.superdocId || v4();
     this.colors = this.config.colors;

package/dist/chunks/{index-CJUy3fVi-D8zt9F3Z.es.js → index-D653XgvV-B-4_BIjA.es.js}

@@ -1,4 +1,4 @@
-import { s as getDefaultExportFromCjs$2 } from "./super-editor.es-BRKZG90h.es.js";
+import { s as getDefaultExportFromCjs$2 } from "./super-editor.es-0TS__OEc.es.js";
 import { V as VFile } from "./index-CvBqQJbG-CvBqQJbG.es.js";
 function bail(error) {
   if (error) {

package/dist/chunks/{index-CJUy3fVi-BGLfCP5B.cjs → index-D653XgvV-BN--CbY4.cjs}

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const superEditor_es = require("./super-editor.es-CDiTp9Fe.cjs");
+const superEditor_es = require("./super-editor.es-Bt9VCC9D.cjs");
 const indexCvBqQJbG = require("./index-CvBqQJbG-Dwm0THD7.cjs");
 function bail(error) {
   if (error) {

package/dist/chunks/{index-Dp3rVMnX.cjs → index-DcKcwu3F.cjs}

@@ -1,5 +1,5 @@
 "use strict";
-const superEditor_es = require("./super-editor.es-CDiTp9Fe.cjs");
+const superEditor_es = require("./super-editor.es-Bt9VCC9D.cjs");
 const blankDocx = require("./blank-docx-DfW3Eeh2.cjs");
 const eventemitter3 = require("./eventemitter3-CFCpOk3d.cjs");
 const provider = require("@hocuspocus/provider");
@@ -17227,7 +17227,7 @@ const _sfc_main = {
   __name: "SuperDoc",
   emits: ["selection-update"],
   setup(__props, { emit: __emit }) {
-    const PdfViewer = vue.defineAsyncComponent(() => Promise.resolve().then(() => require("./PdfViewer-CxHbcDGx.cjs")));
+    const PdfViewer = vue.defineAsyncComponent(() => Promise.resolve().then(() => require("./PdfViewer-B2yJpudB.cjs")));
     const superdocStore = useSuperdocStore();
     const commentsStore = useCommentsStore();
     const {
@@ -18080,7 +18080,7 @@ class SuperDoc extends eventemitter3.EventEmitter {
     this.config.colors = shuffleArray(this.config.colors);
     this.userColorMap = /* @__PURE__ */ new Map();
     this.colorIndex = 0;
-    this.version = "1.0.0-beta.3";
+    this.version = "1.0.0-beta.5";
     this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
     this.superdocId = config.superdocId || uuid.v4();
     this.colors = this.config.colors;

package/dist/chunks/{super-editor.es-BRKZG90h.es.js → super-editor.es-0TS__OEc.es.js}

@@ -35563,7 +35563,7 @@ const _SuperConverter = class _SuperConverter2 {
   static getStoredSuperdocVersion(docx) {
     return _SuperConverter2.getStoredCustomProperty(docx, "SuperdocVersion");
   }
-  static setStoredSuperdocVersion(docx = this.convertedXml, version2 = "1.0.0-beta.3") {
+  static setStoredSuperdocVersion(docx = this.convertedXml, version2 = "1.0.0-beta.5") {
     return _SuperConverter2.setStoredCustomProperty(docx, "SuperdocVersion", version2, false);
   }
   /**
@@ -52270,7 +52270,7 @@ const isHeadless = (editor) => {
 const shouldSkipNodeView = (editor) => {
   return isHeadless(editor);
 };
-const summaryVersion = "1.0.0-beta.3";
+const summaryVersion = "1.0.0-beta.5";
 const nodeKeys = ["group", "content", "marks", "inline", "atom", "defining", "code", "tableRole", "summary"];
 const markKeys = ["group", "inclusive", "excludes", "spanning", "code"];
 function mapAttributes(attrs) {
@@ -53049,7 +53049,7 @@ const _Editor = class _Editor2 extends EventEmitter$1 {
       { default: remarkStringify },
       { default: remarkGfm }
     ] = await Promise.all([
-      import("./index-CJUy3fVi-D8zt9F3Z.es.js"),
+      import("./index-D653XgvV-B-4_BIjA.es.js"),
       import("./index-DRCvimau-Cw339678.es.js"),
       import("./index-C_x_N6Uh-DJn8hIEt.es.js"),
       import("./index-D_sWOSiG-DE96TaT5.es.js"),
@@ -53254,7 +53254,7 @@ const _Editor = class _Editor2 extends EventEmitter$1 {
    * Process collaboration migrations
    */
   processCollaborationMigrations() {
-    console.debug("[checkVersionMigrations] Current editor version", "1.0.0-beta.3");
+    console.debug("[checkVersionMigrations] Current editor version", "1.0.0-beta.5");
     if (!this.options.ydoc) return;
     const metaMap = this.options.ydoc.getMap("meta");
     let docVersion = metaMap.get("version");
@@ -55085,6 +55085,19 @@ const sanitizeFontFamily = (fontFamily2) => {
   }
   return sanitized;
 };
+const normalizeFontSizePx = (value) => {
+  if (isFiniteNumber(value)) return value;
+  if (typeof value !== "string") return void 0;
+  const trimmed = value.trim();
+  if (!trimmed) return void 0;
+  const numeric = Number.parseFloat(trimmed);
+  if (!Number.isFinite(numeric)) return void 0;
+  const unit = trimmed.match(/[a-zA-Z%]+$/)?.[0]?.toLowerCase();
+  if (unit === "pt") {
+    return ptToPx(numeric);
+  }
+  return numeric;
+};
 const applyTextStyleMark = (run2, attrs, themeColors) => {
   const resolvedColor = resolveColorFromAttributes(attrs, themeColors);
   if (resolvedColor) {
@@ -55096,9 +55109,9 @@ const applyTextStyleMark = (run2, attrs, themeColors) => {
       run2.fontFamily = sanitized;
     }
   }
-  const fontSizeValue = pickNumber(attrs.fontSize);
-  if (fontSizeValue !== void 0 && fontSizeValue >= 1 && fontSizeValue <= 1e3) {
-    run2.fontSize = fontSizeValue;
+  const fontSizePx = normalizeFontSizePx(attrs.fontSize);
+  if (fontSizePx !== void 0 && fontSizePx >= 1 && fontSizePx <= 1e3) {
+    run2.fontSize = fontSizePx;
   }
   if (isFiniteNumber(attrs.letterSpacing)) {
     const spacing = Number(attrs.letterSpacing);
@@ -65358,8 +65371,59 @@ const _DomPainter = class _DomPainter2 {
     this.headerProvider = header;
     this.footerProvider = footer;
   }
-  setData(blocks, measures) {
+  /**
+   * Updates the painter's block and measure data.
+   *
+   * @param blocks - Main document blocks
+   * @param measures - Measures corresponding to main document blocks
+   * @param headerBlocks - Optional header blocks from header/footer layout results
+   * @param headerMeasures - Optional measures corresponding to header blocks
+   * @param footerBlocks - Optional footer blocks from header/footer layout results
+   * @param footerMeasures - Optional measures corresponding to footer blocks
+   */
+  setData(blocks, measures, headerBlocks, headerMeasures, footerBlocks, footerMeasures) {
+    if (blocks.length !== measures.length) {
+      throw new Error(
+        `setData: blocks and measures arrays must have the same length. Got blocks.length=${blocks.length}, measures.length=${measures.length}`
+      );
+    }
+    const hasHeaderBlocks = headerBlocks !== void 0;
+    const hasHeaderMeasures = headerMeasures !== void 0;
+    if (hasHeaderBlocks !== hasHeaderMeasures) {
+      throw new Error(
+        `setData: headerBlocks and headerMeasures must both be provided or both be omitted. Got headerBlocks=${hasHeaderBlocks ? "provided" : "omitted"}, headerMeasures=${hasHeaderMeasures ? "provided" : "omitted"}`
+      );
+    }
+    if (hasHeaderBlocks && hasHeaderMeasures && headerBlocks.length !== headerMeasures.length) {
+      throw new Error(
+        `setData: headerBlocks and headerMeasures arrays must have the same length. Got headerBlocks.length=${headerBlocks.length}, headerMeasures.length=${headerMeasures.length}`
+      );
+    }
+    const hasFooterBlocks = footerBlocks !== void 0;
+    const hasFooterMeasures = footerMeasures !== void 0;
+    if (hasFooterBlocks !== hasFooterMeasures) {
+      throw new Error(
+        `setData: footerBlocks and footerMeasures must both be provided or both be omitted. Got footerBlocks=${hasFooterBlocks ? "provided" : "omitted"}, footerMeasures=${hasFooterMeasures ? "provided" : "omitted"}`
+      );
+    }
+    if (hasFooterBlocks && hasFooterMeasures && footerBlocks.length !== footerMeasures.length) {
+      throw new Error(
+        `setData: footerBlocks and footerMeasures arrays must have the same length. Got footerBlocks.length=${footerBlocks.length}, footerMeasures.length=${footerMeasures.length}`
+      );
+    }
     const nextLookup = this.buildBlockLookup(blocks, measures);
+    if (headerBlocks && headerMeasures) {
+      const headerLookup = this.buildBlockLookup(headerBlocks, headerMeasures);
+      headerLookup.forEach((entry, id) => {
+        nextLookup.set(id, entry);
+      });
+    }
+    if (footerBlocks && footerMeasures) {
+      const footerLookup = this.buildBlockLookup(footerBlocks, footerMeasures);
+      footerLookup.forEach((entry, id) => {
+        nextLookup.set(id, entry);
+      });
+    }
     const changed = /* @__PURE__ */ new Set();
     nextLookup.forEach((entry, id) => {
       const previous = this.blockLookup.get(id);
@@ -65682,6 +65746,14 @@ const _DomPainter = class _DomPainter2 {
     container.style.height = `${data.height}px`;
     container.style.top = `${Math.max(0, offset2)}px`;
     container.style.zIndex = "1";
+    let footerYOffset = 0;
+    if (kind === "footer" && data.fragments.length > 0) {
+      const contentHeight = typeof data.contentHeight === "number" ? data.contentHeight : data.fragments.reduce((max2, f2) => {
+        const fragHeight = "height" in f2 && typeof f2.height === "number" ? f2.height : this.estimateFragmentHeight(f2);
+        return Math.max(max2, f2.y + Math.max(0, fragHeight));
+      }, 0);
+      footerYOffset = Math.max(0, data.height - contentHeight);
+    }
     const context = {
       pageNumber: page.number,
       totalPages: this.totalPages,
@@ -65690,6 +65762,10 @@ const _DomPainter = class _DomPainter2 {
     };
     data.fragments.forEach((fragment) => {
       const fragEl = this.renderFragment(fragment, context);
+      if (footerYOffset > 0) {
+        const currentTop = parseFloat(fragEl.style.top) || fragment.y;
+        fragEl.style.top = `${currentTop + footerYOffset}px`;
+      }
       container.appendChild(fragEl);
     });
     if (!existing) {
@@ -66001,13 +66077,13 @@ const _DomPainter = class _DomPainter2 {
       const markerEl = this.doc.createElement("span");
       markerEl.classList.add("superdoc-list-marker");
       const wordLayout = item.paragraph.attrs?.wordLayout;
-      if (wordLayout?.marker) {
-        const marker = wordLayout.marker;
-        markerEl.textContent = marker.markerText;
+      const marker = wordLayout?.marker;
+      if (marker) {
+        markerEl.textContent = marker.markerText ?? null;
         markerEl.style.display = "inline-block";
         markerEl.style.width = `${Math.max(0, fragment.markerWidth - LIST_MARKER_GAP$1)}px`;
         markerEl.style.paddingRight = `${LIST_MARKER_GAP$1}px`;
-        markerEl.style.textAlign = marker.justification;
+        markerEl.style.textAlign = marker.justification ?? "";
         markerEl.style.fontFamily = marker.run.fontFamily;
         markerEl.style.fontSize = `${marker.run.fontSize}px`;
         if (marker.run.bold) markerEl.style.fontWeight = "bold";
@@ -66756,6 +66832,33 @@ const _DomPainter = class _DomPainter2 {
       }
     }
   }
+  /**
+   * Estimates the height of a fragment when explicit height is not available.
+   *
+   * This method provides fallback height calculations for footer bottom-alignment
+   * by consulting measure data for paragraphs and list items, or using the
+   * fragment's height property for tables, images, and drawings.
+   *
+   * @param fragment - The fragment to estimate height for
+   * @returns Estimated height in pixels, or 0 if height cannot be determined
+   */
+  estimateFragmentHeight(fragment) {
+    const lookup2 = this.blockLookup.get(fragment.blockId);
+    const measure = lookup2?.measure;
+    if (fragment.kind === "para" && measure?.kind === "paragraph") {
+      return measure.totalHeight;
+    }
+    if (fragment.kind === "list-item" && measure?.kind === "list") {
+      return measure.totalHeight;
+    }
+    if (fragment.kind === "table") {
+      return fragment.height;
+    }
+    if (fragment.kind === "image" || fragment.kind === "drawing") {
+      return fragment.height;
+    }
+    return 0;
+  }
   buildBlockLookup(blocks, measures) {
     if (blocks.length !== measures.length) {
       throw new Error("DomPainter requires the same number of blocks and measures");
@@ -67224,8 +67327,8 @@ const createDomPainter = (options) => {
     paint(layout, mount2) {
       painter.paint(layout, mount2);
     },
-    setData(blocks, measures) {
-      painter.setData(blocks, measures);
+    setData(blocks, measures, headerBlocks, headerMeasures, footerBlocks, footerMeasures) {
+      painter.setData(blocks, measures, headerBlocks, headerMeasures, footerBlocks, footerMeasures);
     },
     // Non-standard extension for demo app to avoid re-instantiating on provider changes
     setProviders(header, footer) {
@@ -70614,7 +70717,30 @@ rerender_fn = async function() {
   if (typeof painter.setProviders === "function") {
     painter.setProviders(__privateGet$1(this, _headerDecorationProvider), __privateGet$1(this, _footerDecorationProvider));
   }
-  painter.setData?.(blocks, measures);
+  const headerBlocks = [];
+  const headerMeasures = [];
+  if (headerLayouts) {
+    for (const headerResult of headerLayouts) {
+      headerBlocks.push(...headerResult.blocks);
+      headerMeasures.push(...headerResult.measures);
+    }
+  }
+  const footerBlocks = [];
+  const footerMeasures = [];
+  if (footerLayouts) {
+    for (const footerResult of footerLayouts) {
+      footerBlocks.push(...footerResult.blocks);
+      footerMeasures.push(...footerResult.measures);
+    }
+  }
+  painter.setData?.(
+    blocks,
+    measures,
+    headerBlocks.length > 0 ? headerBlocks : void 0,
+    headerMeasures.length > 0 ? headerMeasures : void 0,
+    footerBlocks.length > 0 ? footerBlocks : void 0,
+    footerMeasures.length > 0 ? footerMeasures : void 0
+  );
   painter.paint(layout, __privateGet$1(this, _painterHost));
   __privateSet(this, _layoutError, null);
   __privateSet(this, _layoutErrorState, "healthy");
@@ -70784,7 +70910,8 @@ createDecorationProvider_fn = function(kind, layout) {
     const finalHeaderId = headerId ?? fallbackId ?? void 0;
     return {
       fragments: slotPage.fragments,
-      height: variant.layout.height ?? box.height,
+      height: box.height,
+      contentHeight: variant.layout.height ?? box.height,
       offset: box.offset,
       marginLeft: box.x,
       contentWidth: box.width,
@@ -70811,18 +70938,19 @@ computeDecorationBox_fn = function(kind, pageMargins, pageHeight) {
   const left2 = margins.left ?? DEFAULT_MARGINS.left;
   const right2 = margins.right ?? DEFAULT_MARGINS.right;
   const width = Math.max(pageSize.w - (left2 + right2), 1);
-  const defaultHeight = kind === "header" ? margins.top ?? DEFAULT_MARGINS.top : margins.bottom ?? DEFAULT_MARGINS.bottom;
-  const { headerSpace, footerSpace } = extractHeaderFooterSpace(margins);
-  const target = kind === "header" ? headerSpace : footerSpace;
-  const height = Math.max(target || defaultHeight || 1, 1);
   const totalHeight = pageHeight ?? pageSize.h;
-  const offset2 = kind === "header" ? 0 : Math.max(0, totalHeight - height);
-  return {
-    x: left2,
-    width,
-    height,
-    offset: offset2
-  };
+  if (kind === "header") {
+    const headerMargin = margins.header ?? 0;
+    const topMargin = margins.top ?? DEFAULT_MARGINS.top ?? 0;
+    const height = Math.max(topMargin - headerMargin, 1);
+    return { x: left2, width, height, offset: headerMargin };
+  } else {
+    const footerMargin = margins.footer ?? 0;
+    const bottomMargin = margins.bottom ?? DEFAULT_MARGINS.bottom ?? 0;
+    const height = Math.max(bottomMargin - footerMargin, 1);
+    const offset2 = Math.max(0, totalHeight - footerMargin - height);
+    return { x: left2, width, height, offset: offset2 };
+  }
 };
 rebuildHeaderFooterRegions_fn = function(layout) {
   __privateGet$1(this, _headerRegions).clear();
@@ -89243,13 +89371,22 @@ function checkWordBoundary(state2, pos) {
   return !/\p{L}$/u.test(before.text) || !/^\p{L}/u.test(after.text);
 }
 class SearchState {
-  constructor(query, range2, deco) {
+  /**
+   * Create a new SearchState instance.
+   *
+   * @param {SearchQuery} query - The search query to execute
+   * @param {{from: number, to: number}|null} range - Optional range to restrict search to, or null for entire document
+   * @param {boolean} highlight - Whether to apply CSS classes for visual highlighting of matches
+   * @param {DecorationSet} deco - The decoration set containing match highlights
+   */
+  constructor(query, range2, highlight, deco) {
     this.query = query;
     this.range = range2;
+    this.highlight = highlight;
     this.deco = deco;
   }
 }
-function buildMatchDeco(state2, query, range2) {
+function buildMatchDeco(state2, query, range2, highlight = true) {
   if (!query.valid) return DecorationSet.empty;
   let deco = [];
   let sel = state2.selection;
@@ -89257,7 +89394,8 @@ function buildMatchDeco(state2, query, range2) {
     let next = query.findNext(state2, pos, end2);
     if (!next) break;
     let cls = next.from == sel.from && next.to == sel.to ? "ProseMirror-active-search-match" : "ProseMirror-search-match";
-    deco.push(Decoration.inline(next.from, next.to, { class: cls }));
+    const attrs = highlight ? { class: cls } : {};
+    deco.push(Decoration.inline(next.from, next.to, attrs));
     pos = next.to;
   }
   return DecorationSet.create(state2.doc, deco);
@@ -89270,11 +89408,20 @@ function search(options = {}) {
       init(_config, state2) {
         let query = options.initialQuery || new SearchQuery({ search: "" });
         let range2 = options.initialRange || null;
-        return new SearchState(query, range2, buildMatchDeco(state2, query, range2));
+        const highlight = options.initialHighlight ?? true;
+        return new SearchState(query, range2, highlight, buildMatchDeco(state2, query, range2, highlight));
       },
       apply(tr, search2, _oldState, state2) {
         let set = tr.getMeta(searchKey);
-        if (set) return new SearchState(set.query, set.range, buildMatchDeco(state2, set.query, set.range));
+        if (set) {
+          const highlight = typeof set.highlight === "boolean" ? set.highlight : true;
+          return new SearchState(
+            set.query,
+            set.range,
+            highlight,
+            buildMatchDeco(state2, set.query, set.range, highlight)
+          );
+        }
         if (tr.docChanged || tr.selectionSet) {
           let range2 = search2.range;
           if (range2) {
@@ -89282,7 +89429,13 @@ function search(options = {}) {
             let to = tr.mapping.map(range2.to, -1);
             range2 = from2 < to ? { from: from2, to } : null;
           }
-          search2 = new SearchState(search2.query, range2, buildMatchDeco(state2, search2.query, range2));
+          const highlight = typeof search2.highlight === "boolean" ? search2.highlight : true;
+          search2 = new SearchState(
+            search2.query,
+            range2,
+            highlight,
+            buildMatchDeco(state2, search2.query, range2, highlight)
+          );
         }
         return search2;
       }
@@ -89296,8 +89449,12 @@ function getMatchHighlights(state2) {
   let search2 = searchKey.getState(state2);
   return search2 ? search2.deco : DecorationSet.empty;
 }
-function setSearchState(tr, query, range2 = null) {
-  return tr.setMeta(searchKey, { query, range: range2 });
+function setSearchState(tr, query, range2 = null, options = {}) {
+  if (options != null && (typeof options !== "object" || Array.isArray(options))) {
+    throw new TypeError("setSearchState options must be an object");
+  }
+  const highlight = typeof options?.highlight === "boolean" ? options.highlight : true;
+  return tr.setMeta(searchKey, { query, range: range2, highlight });
 }
 const isRegExp = (value) => Object.prototype.toString.call(value) === "[object RegExp]";
 const Search = Extension.create({
@@ -89358,14 +89515,25 @@ const Search = Extension.create({
        * Search for string matches in editor content
        * @category Command
        * @param {String|RegExp} patternInput - Search string or pattern
+       * @param {SearchCommandOptions} [options={}] - Options to control search behavior
        * @example
+       * // Basic search with highlighting (default)
        * const matches = editor.commands.search('test string')
+       *
+       * // Regex search
        * const regexMatches = editor.commands.search(/test/i)
+       *
+       * // Search without visual highlighting
+       * const silentMatches = editor.commands.search('test', { highlight: false })
        * @note Returns array of SearchMatch objects with positions and IDs
        */
-      search: (patternInput) => (
+      search: (patternInput, options = {}) => (
         /** @returns {SearchMatch[]} */
         (({ state: state2, dispatch }) => {
+          if (options != null && (typeof options !== "object" || Array.isArray(options))) {
+            throw new TypeError("Search options must be an object");
+          }
+          const highlight = typeof options?.highlight === "boolean" ? options.highlight : true;
           let pattern;
           let caseSensitive = false;
           let regexp = false;
@@ -89392,7 +89560,7 @@ const Search = Extension.create({
             regexp,
             wholeWord
           });
-          const tr = setSearchState(state2.tr, query);
+          const tr = setSearchState(state2.tr, query, null, { highlight });
           dispatch(tr);
           const newState = state2.apply(tr);
           const decoSet = getMatchHighlights(newState);