superdoc 1.0.0-beta.33 → 1.0.0-beta.34

package/dist/superdoc.umd.js

@@ -41859,7 +41859,7 @@ Please report this to https://github.com/markedjs/marked.`, e) {
     static getStoredSuperdocVersion(docx) {
       return _SuperConverter2.getStoredCustomProperty(docx, "SuperdocVersion");
     }
-    static setStoredSuperdocVersion(docx = this.convertedXml, version2 = "1.0.0-beta.33") {
+    static setStoredSuperdocVersion(docx = this.convertedXml, version2 = "1.0.0-beta.34") {
       return _SuperConverter2.setStoredCustomProperty(docx, "SuperdocVersion", version2, false);
     }
     /**
@@ -53022,7 +53022,7 @@ Please report this to https://github.com/markedjs/marked.`, e) {
   var __privateAdd$1 = (obj, member, value) => member.has(obj) ? __typeError$1("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
   var __privateSet = (obj, member, value, setter) => (__accessCheck$1(obj, member, "write to private field"), member.set(obj, value), value);
   var __privateMethod$1 = (obj, member, method) => (__accessCheck$1(obj, member, "access private method"), method);
-  var _Attribute_static, getGlobalAttributes_fn, getNodeAndMarksAttributes_fn, _Schema_static, createNodesSchema_fn, createMarksSchema_fn, _events, _ExtensionService_instances, setupExtensions_fn, attachEditorEvents_fn, _editor, _stateValidators, _xmlValidators, _requiredNodeTypes, _requiredMarkTypes, _SuperValidator_instances, initializeValidators_fn, collectValidatorRequirements_fn, analyzeDocument_fn, dispatchWithFallback_fn, _commandService, _Editor_instances, initContainerElement_fn, init_fn, initRichText_fn, onFocus_fn, checkHeadless_fn, registerCopyHandler_fn, insertNewFileData_fn, getPluginKeyName_fn, createExtensionService_fn, createCommandService_fn, createConverter_fn, initMedia_fn, initFonts_fn, checkFonts_fn, determineUnsupportedFonts_fn, createSchema_fn, generatePmData_fn, createView_fn, onCollaborationReady_fn, initComments_fn, dispatchTransaction_fn, handleNodeSelection_fn, prepareDocumentForImport_fn, prepareDocumentForExport_fn, endCollaboration_fn, validateDocumentInit_fn, validateDocumentExport_fn, initDevTools_fn, _map, _editor2, _descriptors, _collections, _editorEntries, _maxCachedEditors, _editorAccessOrder, _pendingCreations, _cacheHits, _cacheMisses, _evictions, _HeaderFooterEditorManager_instances, hasConverter_fn, extractCollections_fn, collectDescriptors_fn, teardownMissingEditors_fn, teardownEditors_fn, createEditor_fn, createEditorContainer_fn, registerConverterEditor_fn, unregisterConverterEditor_fn, updateAccessOrder_fn, enforceCacheSizeLimit_fn, _manager, _mediaFiles, _blockCache, _HeaderFooterLayoutAdapter_instances, getBlocks_fn, getConverterContext_fn, _selectionOverlay, _activeEditorHost, _activeDecorationContainer, _activeRegion, _borderLine, _dimmingOverlay, _EditorOverlayManager_instances, findDecorationContainer_fn, ensureEditorHost_fn, positionEditorHost_fn, showHeaderFooterBorder_fn, hideHeaderFooterBorder_fn, _instances, _options, _editor3, _visibleHost, _viewportHost, _painterHost, _selectionOverlay2, _hiddenHost, _layoutOptions, _layoutState, _domPainter, _dragHandlerCleanup, _layoutError, _layoutErrorState, _errorBanner, _errorBannerMessage, _telemetryEmitter, _renderScheduled, _pendingDocChange, _isRerendering, _selectionUpdateScheduled, _remoteCursorUpdateScheduled, _rafHandle, _editorListeners, _sectionMetadata, _documentMode, _inputBridge, _trackedChangesMode, _trackedChangesEnabled, _trackedChangesOverrides, _headerFooterManager, _headerFooterAdapter, _headerFooterIdentifier, _multiSectionIdentifier, _headerLayoutResults, _footerLayoutResults, _headerLayoutsByRId, _footerLayoutsByRId, _headerDecorationProvider, _footerDecorationProvider, _headerFooterManagerCleanups, _headerRegions, _footerRegions, _session, _activeHeaderFooterEditor, _overlayManager, _hoverOverlay, _hoverTooltip, _modeBanner, _ariaLiveRegion, _hoverRegion, _clickCount, _lastClickTime, _lastClickPosition, _lastSelectedImageBlockId, _dragAnchor, _isDragging, _dragExtensionMode, _remoteCursorState, _remoteCursorDirty, _remoteCursorOverlay, _localSelectionLayer, _awarenessCleanup, _scrollCleanup, _remoteCursorRafHandle, _scrollTimeout, _PresentationEditor_instances, collectCommentPositions_fn, aggregateLayoutBounds_fn, safeCleanup_fn, setupEditorListeners_fn, setupCollaborationCursors_fn, normalizeAwarenessStates_fn, getFallbackColor_fn, getValidatedColor_fn, scheduleRemoteCursorUpdate_fn, scheduleRemoteCursorReRender_fn, updateRemoteCursors_fn, renderRemoteCursors_fn, renderRemoteCaret_fn, renderRemoteCursorLabel_fn, renderRemoteSelection_fn, setupPointerHandlers_fn, setupDragHandlers_fn, setupInputBridge_fn, initHeaderFooterRegistry_fn, _handlePointerDown, getFirstTextPosition_fn, registerPointerClick_fn, selectWordAt_fn, selectParagraphAt_fn, calculateExtendedSelection_fn, isWordCharacter_fn, _handlePointerMove, _handlePointerLeave, _handlePointerUp, _handleDragOver, _handleDrop, _handleDoubleClick, _handleKeyDown, focusHeaderFooterShortcut_fn, scheduleRerender_fn, flushRerenderQueue_fn, rerender_fn, ensurePainter_fn, scheduleSelectionUpdate_fn, updateSelection_fn, resolveLayoutOptions_fn, buildHeaderFooterInput_fn, computeHeaderFooterConstraints_fn, layoutPerRIdHeaderFooters_fn, updateDecorationProviders_fn, createDecorationProvider_fn, findHeaderFooterPageForPageNumber_fn, computeDecorationBox_fn, rebuildHeaderFooterRegions_fn, hitTestHeaderFooterRegion_fn, pointInRegion_fn, activateHeaderFooterRegion_fn, enterHeaderFooterMode_fn, exitHeaderFooterMode_fn, getActiveDomTarget_fn, emitHeaderFooterModeChanged_fn, emitHeaderFooterEditingContext_fn, updateAwarenessSession_fn, updateModeBanner_fn, announce_fn, validateHeaderFooterEditPermission_fn, emitHeaderFooterEditBlocked_fn, resolveDescriptorForRegion_fn, createDefaultHeaderFooter_fn, getPageElement_fn, scrollPageIntoView_fn, waitForPageMount_fn, getBodyPageHeight_fn, getHeaderFooterPageHeight_fn, renderSelectionRects_fn, renderHoverRegion_fn, clearHoverRegion_fn, renderCaretOverlay_fn, getHeaderFooterContext_fn, computeHeaderFooterSelectionRects_fn, syncTrackedChangesPreferences_fn, deriveTrackedChangesMode_fn, deriveTrackedChangesEnabled_fn, getTrackChangesPluginState_fn, computeDefaultLayoutDefaults_fn, parseColumns_fn, inchesToPx_fn, applyZoom_fn, createLayoutMetrics_fn, convertPageLocalToOverlayCoords_fn, normalizeClientPoint_fn, computeCaretLayoutRect_fn, computeCaretLayoutRectFromDOM_fn, computeTableCaretLayoutRect_fn, findLineContainingPos_fn, lineHeightBeforeIndex_fn, getCurrentPageIndex_fn, findRegionForPage_fn, handleLayoutError_fn, decorateError_fn, showLayoutErrorBanner_fn, dismissErrorBanner_fn, createHiddenHost_fn, _windowRoot, _layoutSurfaces, _getTargetDom, _isEditable, _onTargetChanged, _listeners, _currentTarget, _destroyed, _useWindowFallback, _PresentationInputBridge_instances, addListener_fn, dispatchToTarget_fn, forwardKeyboardEvent_fn, forwardTextEvent_fn, forwardCompositionEvent_fn, forwardContextMenu_fn, isEventOnActiveTarget_fn, shouldSkipSurface_fn, isInLayoutSurface_fn, getListenerTargets_fn, isPlainCharacterKey_fn, _DocumentSectionView_instances, init_fn2, addToolTip_fn, _ParagraphNodeView_instances, checkShouldUpdate_fn, updateHTMLAttributes_fn, updateDOMStyles_fn, resolveNeighborParagraphProperties_fn, updateListStyles_fn, initList_fn, checkIsList_fn, createMarker_fn, createSeparator_fn, calculateTabSeparatorStyle_fn, calculateMarkerStyle_fn, removeList_fn, getParagraphContext_fn, scheduleAnimation_fn, cancelScheduledAnimation_fn, _FieldAnnotationView_instances, createAnnotation_fn, _AutoPageNumberNodeView_instances, renderDom_fn, scheduleUpdateNodeStyle_fn, _VectorShapeView_instances, ensureParentPositioned_fn, _ShapeGroupView_instances, ensureParentPositioned_fn2;
+  var _Attribute_static, getGlobalAttributes_fn, getNodeAndMarksAttributes_fn, _Schema_static, createNodesSchema_fn, createMarksSchema_fn, _events, _ExtensionService_instances, setupExtensions_fn, attachEditorEvents_fn, _editor, _stateValidators, _xmlValidators, _requiredNodeTypes, _requiredMarkTypes, _SuperValidator_instances, initializeValidators_fn, collectValidatorRequirements_fn, analyzeDocument_fn, dispatchWithFallback_fn, _commandService, _Editor_instances, initContainerElement_fn, init_fn, initRichText_fn, onFocus_fn, checkHeadless_fn, registerCopyHandler_fn, insertNewFileData_fn, getPluginKeyName_fn, createExtensionService_fn, createCommandService_fn, createConverter_fn, initMedia_fn, initFonts_fn, checkFonts_fn, determineUnsupportedFonts_fn, createSchema_fn, generatePmData_fn, createView_fn, onCollaborationReady_fn, initComments_fn, dispatchTransaction_fn, handleNodeSelection_fn, prepareDocumentForImport_fn, prepareDocumentForExport_fn, endCollaboration_fn, validateDocumentInit_fn, validateDocumentExport_fn, initDevTools_fn, _map, _editor2, _descriptors, _collections, _editorEntries, _maxCachedEditors, _editorAccessOrder, _pendingCreations, _cacheHits, _cacheMisses, _evictions, _HeaderFooterEditorManager_instances, hasConverter_fn, extractCollections_fn, collectDescriptors_fn, teardownMissingEditors_fn, teardownEditors_fn, createEditor_fn, createEditorContainer_fn, registerConverterEditor_fn, unregisterConverterEditor_fn, updateAccessOrder_fn, enforceCacheSizeLimit_fn, _manager, _mediaFiles, _blockCache, _HeaderFooterLayoutAdapter_instances, getBlocks_fn, getConverterContext_fn, _selectionOverlay, _activeEditorHost, _activeDecorationContainer, _activeRegion, _borderLine, _dimmingOverlay, _EditorOverlayManager_instances, findDecorationContainer_fn, ensureEditorHost_fn, positionEditorHost_fn, showHeaderFooterBorder_fn, hideHeaderFooterBorder_fn, _instances, _options, _editor3, _visibleHost, _viewportHost, _painterHost, _selectionOverlay2, _hiddenHost, _layoutOptions, _layoutState, _domPainter, _dragHandlerCleanup, _layoutError, _layoutErrorState, _errorBanner, _errorBannerMessage, _telemetryEmitter, _renderScheduled, _pendingDocChange, _isRerendering, _selectionUpdateScheduled, _remoteCursorUpdateScheduled, _rafHandle, _editorListeners, _sectionMetadata, _documentMode, _inputBridge, _trackedChangesMode, _trackedChangesEnabled, _trackedChangesOverrides, _headerFooterManager, _headerFooterAdapter, _headerFooterIdentifier, _multiSectionIdentifier, _headerLayoutResults, _footerLayoutResults, _headerLayoutsByRId, _footerLayoutsByRId, _headerDecorationProvider, _footerDecorationProvider, _headerFooterManagerCleanups, _headerRegions, _footerRegions, _session, _activeHeaderFooterEditor, _overlayManager, _hoverOverlay, _hoverTooltip, _modeBanner, _ariaLiveRegion, _hoverRegion, _clickCount, _lastClickTime, _lastClickPosition, _lastSelectedImageBlockId, _dragAnchor, _isDragging, _dragExtensionMode, _remoteCursorState, _remoteCursorElements, _remoteCursorDirty, _remoteCursorOverlay, _localSelectionLayer, _awarenessCleanup, _scrollCleanup, _scrollTimeout, _lastRemoteCursorRenderTime, _remoteCursorThrottleTimeout, _PresentationEditor_instances, collectCommentPositions_fn, aggregateLayoutBounds_fn, safeCleanup_fn, setupEditorListeners_fn, setupCollaborationCursors_fn, updateLocalAwarenessCursor_fn, normalizeAwarenessStates_fn, getFallbackColor_fn, getValidatedColor_fn, scheduleRemoteCursorUpdate_fn, scheduleRemoteCursorReRender_fn, updateRemoteCursors_fn, renderRemoteCursors_fn, renderRemoteCaret_fn, renderRemoteCursorLabel_fn, renderRemoteSelection_fn, setupPointerHandlers_fn, setupDragHandlers_fn, setupInputBridge_fn, initHeaderFooterRegistry_fn, _handlePointerDown, getFirstTextPosition_fn, registerPointerClick_fn, selectWordAt_fn, selectParagraphAt_fn, calculateExtendedSelection_fn, isWordCharacter_fn, _handlePointerMove, _handlePointerLeave, _handlePointerUp, _handleDragOver, _handleDrop, _handleDoubleClick, _handleKeyDown, focusHeaderFooterShortcut_fn, scheduleRerender_fn, flushRerenderQueue_fn, rerender_fn, ensurePainter_fn, scheduleSelectionUpdate_fn, updateSelection_fn, resolveLayoutOptions_fn, buildHeaderFooterInput_fn, computeHeaderFooterConstraints_fn, layoutPerRIdHeaderFooters_fn, updateDecorationProviders_fn, createDecorationProvider_fn, findHeaderFooterPageForPageNumber_fn, computeDecorationBox_fn, rebuildHeaderFooterRegions_fn, hitTestHeaderFooterRegion_fn, pointInRegion_fn, activateHeaderFooterRegion_fn, enterHeaderFooterMode_fn, exitHeaderFooterMode_fn, getActiveDomTarget_fn, emitHeaderFooterModeChanged_fn, emitHeaderFooterEditingContext_fn, updateAwarenessSession_fn, updateModeBanner_fn, announce_fn, validateHeaderFooterEditPermission_fn, emitHeaderFooterEditBlocked_fn, resolveDescriptorForRegion_fn, createDefaultHeaderFooter_fn, getPageElement_fn, scrollPageIntoView_fn, computeAnchorMap_fn, waitForPageMount_fn, getBodyPageHeight_fn, getHeaderFooterPageHeight_fn, renderSelectionRects_fn, renderHoverRegion_fn, clearHoverRegion_fn, renderCaretOverlay_fn, getHeaderFooterContext_fn, computeHeaderFooterSelectionRects_fn, syncTrackedChangesPreferences_fn, deriveTrackedChangesMode_fn, deriveTrackedChangesEnabled_fn, getTrackChangesPluginState_fn, computeDefaultLayoutDefaults_fn, parseColumns_fn, inchesToPx_fn, applyZoom_fn, createLayoutMetrics_fn, convertPageLocalToOverlayCoords_fn, normalizeClientPoint_fn, computeCaretLayoutRect_fn, computeCaretLayoutRectFromDOM_fn, computeTableCaretLayoutRect_fn, findLineContainingPos_fn, lineHeightBeforeIndex_fn, getCurrentPageIndex_fn, findRegionForPage_fn, handleLayoutError_fn, decorateError_fn, showLayoutErrorBanner_fn, dismissErrorBanner_fn, createHiddenHost_fn, _windowRoot, _layoutSurfaces, _getTargetDom, _isEditable, _onTargetChanged, _listeners, _currentTarget, _destroyed, _useWindowFallback, _PresentationInputBridge_instances, addListener_fn, dispatchToTarget_fn, forwardKeyboardEvent_fn, forwardTextEvent_fn, forwardCompositionEvent_fn, forwardContextMenu_fn, isEventOnActiveTarget_fn, shouldSkipSurface_fn, isInLayoutSurface_fn, getListenerTargets_fn, isPlainCharacterKey_fn, _DocumentSectionView_instances, init_fn2, addToolTip_fn, _ParagraphNodeView_instances, checkShouldUpdate_fn, updateHTMLAttributes_fn, updateDOMStyles_fn, resolveNeighborParagraphProperties_fn, updateListStyles_fn, initList_fn, checkIsList_fn, createMarker_fn, createSeparator_fn, calculateTabSeparatorStyle_fn, calculateMarkerStyle_fn, removeList_fn, getParagraphContext_fn, scheduleAnimation_fn, cancelScheduledAnimation_fn, _FieldAnnotationView_instances, createAnnotation_fn, _AutoPageNumberNodeView_instances, renderDom_fn, scheduleUpdateNodeStyle_fn, _VectorShapeView_instances, ensureParentPositioned_fn, _ShapeGroupView_instances, ensureParentPositioned_fn2;
   var GOOD_LEAF_SIZE = 200;
   var RopeSequence = function RopeSequence2() {
   };
@@ -66889,7 +66889,7 @@ Please report this to https://github.com/markedjs/marked.`, e) {
   const shouldSkipNodeView = (editor) => {
     return isHeadless(editor);
   };
-  const summaryVersion = "1.0.0-beta.33";
+  const summaryVersion = "1.0.0-beta.34";
   const nodeKeys = ["group", "content", "marks", "inline", "atom", "defining", "code", "tableRole", "summary"];
   const markKeys = ["group", "inclusive", "excludes", "spanning", "code"];
   function mapAttributes(attrs) {
@@ -67678,7 +67678,7 @@ Please report this to https://github.com/markedjs/marked.`, e) {
         { default: remarkStringify2 },
         { default: remarkGfm2 }
       ] = await Promise.all([
-        Promise.resolve().then(() => indexHX4H5xPH),
+        Promise.resolve().then(() => indexCQeXM6oB),
         Promise.resolve().then(() => indexDRCvimau),
         Promise.resolve().then(() => indexC_x_N6Uh),
         Promise.resolve().then(() => indexD_sWOSiG),
@@ -67883,7 +67883,7 @@ Please report this to https://github.com/markedjs/marked.`, e) {
      * Process collaboration migrations
      */
     processCollaborationMigrations() {
-      console.debug("[checkVersionMigrations] Current editor version", "1.0.0-beta.33");
+      console.debug("[checkVersionMigrations] Current editor version", "1.0.0-beta.34");
       if (!this.options.ydoc) return;
       const metaMap = this.options.ydoc.getMap("meta");
       let docVersion = metaMap.get("version");
@@ -90596,7 +90596,7 @@ ${l}
   const MULTI_CLICK_TIME_THRESHOLD_MS = 400;
   const MULTI_CLICK_DISTANCE_THRESHOLD_PX = 5;
   const HEADER_FOOTER_INIT_BUDGET_MS = 200;
-  const SCROLL_DEBOUNCE_MS = 100;
+  const SCROLL_DEBOUNCE_MS = 32;
   const MAX_ZOOM_WARNING_THRESHOLD = 10;
   const MAX_SELECTION_RECTS_PER_USER = 100;
   const DEFAULT_STALE_TIMEOUT_MS = 5 * 60 * 1e3;
@@ -90613,7 +90613,7 @@ ${l}
       __privateAdd$1(this, _selectionOverlay2);
       __privateAdd$1(this, _hiddenHost);
       __privateAdd$1(this, _layoutOptions);
-      __privateAdd$1(this, _layoutState, { blocks: [], measures: [], layout: null });
+      __privateAdd$1(this, _layoutState, { blocks: [], measures: [], layout: null, bookmarks: /* @__PURE__ */ new Map() });
       __privateAdd$1(this, _domPainter, null);
       __privateAdd$1(this, _dragHandlerCleanup, null);
       __privateAdd$1(this, _layoutError, null);
@@ -90663,18 +90663,31 @@ ${l}
       __privateAdd$1(this, _isDragging, false);
       __privateAdd$1(this, _dragExtensionMode, "char");
       __privateAdd$1(this, _remoteCursorState, /* @__PURE__ */ new Map());
+      __privateAdd$1(this, _remoteCursorElements, /* @__PURE__ */ new Map());
       __privateAdd$1(this, _remoteCursorDirty, false);
       __privateAdd$1(this, _remoteCursorOverlay, null);
       __privateAdd$1(this, _localSelectionLayer, null);
       __privateAdd$1(this, _awarenessCleanup, null);
       __privateAdd$1(this, _scrollCleanup, null);
-      __privateAdd$1(this, _remoteCursorRafHandle, null);
       __privateAdd$1(this, _scrollTimeout);
+      __privateAdd$1(this, _lastRemoteCursorRenderTime, 0);
+      __privateAdd$1(this, _remoteCursorThrottleTimeout, null);
       __privateAdd$1(this, _handlePointerDown, (event) => {
         if (event.button !== 0) {
           return;
         }
         const target = event.target;
+        const linkEl = target?.closest?.("a.superdoc-link");
+        if (linkEl) {
+          const href = linkEl.getAttribute("href") ?? "";
+          const isAnchorLink = href.startsWith("#") && href.length > 1;
+          if (isAnchorLink) {
+            event.preventDefault();
+            event.stopPropagation();
+            this.goToAnchor(href);
+            return;
+          }
+        }
         const isDraggableAnnotation = target?.closest?.('[data-draggable="true"]') != null;
         if (!__privateGet$1(this, _layoutState).layout) {
           if (!isDraggableAnnotation) {
@@ -91934,12 +91947,11 @@ ${l}
           __privateSet(this, _rafHandle, null);
         }, "Layout RAF");
       }
-      if (__privateGet$1(this, _remoteCursorRafHandle) !== null) {
+      if (__privateGet$1(this, _remoteCursorThrottleTimeout) !== null) {
         __privateMethod$1(this, _PresentationEditor_instances, safeCleanup_fn).call(this, () => {
-          const win = __privateGet$1(this, _visibleHost)?.ownerDocument?.defaultView ?? window;
-          win.cancelAnimationFrame(__privateGet$1(this, _remoteCursorRafHandle));
-          __privateSet(this, _remoteCursorRafHandle, null);
-        }, "Remote cursor RAF");
+          clearTimeout(__privateGet$1(this, _remoteCursorThrottleTimeout));
+          __privateSet(this, _remoteCursorThrottleTimeout, null);
+        }, "Remote cursor throttle");
       }
       __privateGet$1(this, _editorListeners).forEach(({ event, handler: handler2 }) => __privateGet$1(this, _editor3)?.off(event, handler2));
       __privateSet(this, _editorListeners, []);
@@ -91963,6 +91975,7 @@ ${l}
         __privateSet(this, _scrollCleanup, null);
       }
       __privateGet$1(this, _remoteCursorState).clear();
+      __privateGet$1(this, _remoteCursorElements).clear();
       __privateSet(this, _remoteCursorOverlay, null);
       if (__privateGet$1(this, _options)?.documentId) {
         __privateGet$1(_PresentationEditor2, _instances).delete(__privateGet$1(this, _options).documentId);
@@ -92005,6 +92018,94 @@ ${l}
         __privateGet$1(this, _editor3).destroy();
       }
     }
+    /**
+     * Navigate to a bookmark/anchor in the current document (e.g., TOC links).
+     *
+     * This method performs asynchronous navigation to support virtualized page rendering:
+     * 1. Normalizes the anchor by removing leading '#' if present
+     * 2. Looks up the bookmark in the document's bookmark registry
+     * 3. Determines which page contains the target position
+     * 4. Scrolls the page into view (may be virtualized)
+     * 5. Waits up to 2000ms for the page to mount in the DOM
+     * 6. Moves the editor caret to the bookmark position
+     *
+     * @param anchor - Bookmark name or fragment identifier (with or without leading '#')
+     * @returns Promise resolving to true if navigation succeeded, false otherwise
+     *
+     * @remarks
+     * Navigation fails and returns false if:
+     * - The anchor parameter is empty or becomes empty after normalization
+     * - No layout has been computed yet
+     * - The bookmark does not exist in the document
+     * - The bookmark's page cannot be determined
+     * - The page fails to mount within the timeout period (2000ms)
+     *
+     * Note: This method does not throw errors. All failures are logged and result in
+     * a false return value. An 'error' event is emitted for unhandled exceptions.
+     *
+     * @throws Never throws directly - errors are caught, logged, and emitted as events
+     */
+    async goToAnchor(anchor) {
+      try {
+        if (!anchor) return false;
+        const layout = __privateGet$1(this, _layoutState).layout;
+        if (!layout) return false;
+        const normalized = anchor.startsWith("#") ? anchor.slice(1) : anchor;
+        if (!normalized) return false;
+        const pmPos = __privateGet$1(this, _layoutState).bookmarks.get(normalized);
+        if (pmPos == null) return false;
+        const rects = selectionToRects(layout, __privateGet$1(this, _layoutState).blocks, __privateGet$1(this, _layoutState).measures, pmPos, pmPos + 1) ?? [];
+        const rect = rects[0];
+        let pageIndex = rect?.pageIndex ?? null;
+        if (pageIndex == null) {
+          let nextFragmentPage = null;
+          let nextFragmentStart = null;
+          for (const page of layout.pages) {
+            for (const fragment of page.fragments) {
+              if (fragment.kind !== "para") continue;
+              const fragStart = fragment.pmStart;
+              const fragEnd = fragment.pmEnd;
+              if (fragStart == null || fragEnd == null) continue;
+              if (pmPos >= fragStart && pmPos < fragEnd) {
+                pageIndex = page.number - 1;
+                break;
+              }
+              if (fragStart > pmPos && (nextFragmentStart === null || fragStart < nextFragmentStart)) {
+                nextFragmentPage = page.number - 1;
+                nextFragmentStart = fragStart;
+              }
+            }
+            if (pageIndex != null) break;
+          }
+          if (pageIndex == null && nextFragmentPage != null) {
+            pageIndex = nextFragmentPage;
+          }
+        }
+        if (pageIndex == null) return false;
+        __privateMethod$1(this, _PresentationEditor_instances, scrollPageIntoView_fn).call(this, pageIndex);
+        await __privateMethod$1(this, _PresentationEditor_instances, waitForPageMount_fn).call(this, pageIndex, { timeout: _PresentationEditor2.ANCHOR_NAV_TIMEOUT_MS });
+        const pageEl = __privateGet$1(this, _painterHost)?.querySelector(`[data-page-index="${pageIndex}"]`);
+        if (pageEl) {
+          pageEl.scrollIntoView({ behavior: "instant", block: "start" });
+        }
+        const activeEditor = this.getActiveEditor();
+        if (activeEditor?.commands?.setTextSelection) {
+          activeEditor.commands.setTextSelection({ from: pmPos, to: pmPos });
+        } else {
+          console.warn(
+            "[PresentationEditor] goToAnchor: Navigation succeeded but could not move caret (editor commands unavailable)"
+          );
+        }
+        return true;
+      } catch (error) {
+        console.error("[PresentationEditor] goToAnchor failed:", error);
+        this.emit("error", {
+          error,
+          context: "goToAnchor"
+        });
+        return false;
+      }
+    }
   };
   _instances = /* @__PURE__ */ new WeakMap();
   _options = /* @__PURE__ */ new WeakMap();
@@ -92065,13 +92166,15 @@ ${l}
   _isDragging = /* @__PURE__ */ new WeakMap();
   _dragExtensionMode = /* @__PURE__ */ new WeakMap();
   _remoteCursorState = /* @__PURE__ */ new WeakMap();
+  _remoteCursorElements = /* @__PURE__ */ new WeakMap();
   _remoteCursorDirty = /* @__PURE__ */ new WeakMap();
   _remoteCursorOverlay = /* @__PURE__ */ new WeakMap();
   _localSelectionLayer = /* @__PURE__ */ new WeakMap();
   _awarenessCleanup = /* @__PURE__ */ new WeakMap();
   _scrollCleanup = /* @__PURE__ */ new WeakMap();
-  _remoteCursorRafHandle = /* @__PURE__ */ new WeakMap();
   _scrollTimeout = /* @__PURE__ */ new WeakMap();
+  _lastRemoteCursorRenderTime = /* @__PURE__ */ new WeakMap();
+  _remoteCursorThrottleTimeout = /* @__PURE__ */ new WeakMap();
   _PresentationEditor_instances = /* @__PURE__ */ new WeakSet();
   collectCommentPositions_fn = function() {
     const editorState = __privateGet$1(this, _editor3)?.state;
@@ -92132,9 +92235,13 @@ ${l}
         __privateSet(this, _pendingDocChange, true);
         __privateMethod$1(this, _PresentationEditor_instances, scheduleRerender_fn).call(this);
       }
+      if (transaction?.docChanged) {
+        __privateMethod$1(this, _PresentationEditor_instances, updateLocalAwarenessCursor_fn).call(this);
+      }
     };
     const handleSelection = () => {
       __privateMethod$1(this, _PresentationEditor_instances, scheduleSelectionUpdate_fn).call(this);
+      __privateMethod$1(this, _PresentationEditor_instances, updateLocalAwarenessCursor_fn).call(this);
     };
     __privateGet$1(this, _editor3).on("update", handleUpdate);
     __privateGet$1(this, _editor3).on("selectionUpdate", handleSelection);
@@ -92204,6 +92311,29 @@ ${l}
     });
     handleAwarenessChange();
   };
+  updateLocalAwarenessCursor_fn = function() {
+    const provider2 = __privateGet$1(this, _options).collaborationProvider;
+    if (!provider2?.awareness) return;
+    if (typeof provider2.awareness.setLocalStateField !== "function") {
+      return;
+    }
+    const ystate = ySyncPluginKey.getState(__privateGet$1(this, _editor3).state);
+    if (!ystate?.binding?.mapping) return;
+    const { selection } = __privateGet$1(this, _editor3).state;
+    const { anchor, head } = selection;
+    try {
+      const relAnchor = absolutePositionToRelativePosition(anchor, ystate.type, ystate.binding.mapping);
+      const relHead = absolutePositionToRelativePosition(head, ystate.type, ystate.binding.mapping);
+      if (relAnchor && relHead) {
+        const cursorData = {
+          anchor: relAnchor,
+          head: relHead
+        };
+        provider2.awareness.setLocalStateField("cursor", cursorData);
+      }
+    } catch {
+    }
+  };
   normalizeAwarenessStates_fn = function() {
     const provider2 = __privateGet$1(this, _options).collaborationProvider;
     if (!provider2?.awareness) return /* @__PURE__ */ new Map();
@@ -92271,27 +92401,45 @@ ${l}
     if (__privateGet$1(this, _layoutOptions).presence?.enabled === false) return;
     if (__privateGet$1(this, _remoteCursorUpdateScheduled)) return;
     __privateSet(this, _remoteCursorUpdateScheduled, true);
-    const win = __privateGet$1(this, _visibleHost).ownerDocument?.defaultView ?? window;
-    __privateSet(this, _remoteCursorRafHandle, win.requestAnimationFrame(() => {
-      __privateSet(this, _remoteCursorUpdateScheduled, false);
-      __privateSet(this, _remoteCursorRafHandle, null);
-      __privateMethod$1(this, _PresentationEditor_instances, updateRemoteCursors_fn).call(this);
-    }));
+    queueMicrotask(() => {
+      if (!__privateGet$1(this, _remoteCursorUpdateScheduled)) return;
+      const now = performance.now();
+      const elapsed = now - __privateGet$1(this, _lastRemoteCursorRenderTime);
+      const THROTTLE_MS = 16;
+      if (elapsed >= THROTTLE_MS) {
+        if (__privateGet$1(this, _remoteCursorThrottleTimeout) !== null) {
+          clearTimeout(__privateGet$1(this, _remoteCursorThrottleTimeout));
+          __privateSet(this, _remoteCursorThrottleTimeout, null);
+        }
+        __privateSet(this, _remoteCursorUpdateScheduled, false);
+        __privateSet(this, _lastRemoteCursorRenderTime, now);
+        __privateMethod$1(this, _PresentationEditor_instances, updateRemoteCursors_fn).call(this);
+        return;
+      }
+      const remaining = THROTTLE_MS - elapsed;
+      __privateSet(this, _remoteCursorThrottleTimeout, window.setTimeout(() => {
+        __privateSet(this, _remoteCursorUpdateScheduled, false);
+        __privateSet(this, _remoteCursorThrottleTimeout, null);
+        __privateSet(this, _lastRemoteCursorRenderTime, performance.now());
+        __privateMethod$1(this, _PresentationEditor_instances, updateRemoteCursors_fn).call(this);
+      }, remaining));
+    });
   };
   scheduleRemoteCursorReRender_fn = function() {
     if (__privateGet$1(this, _layoutOptions).presence?.enabled === false) return;
     if (__privateGet$1(this, _remoteCursorUpdateScheduled)) return;
     __privateSet(this, _remoteCursorUpdateScheduled, true);
     const win = __privateGet$1(this, _visibleHost).ownerDocument?.defaultView ?? window;
-    __privateSet(this, _remoteCursorRafHandle, win.requestAnimationFrame(() => {
+    win.requestAnimationFrame(() => {
       __privateSet(this, _remoteCursorUpdateScheduled, false);
-      __privateSet(this, _remoteCursorRafHandle, null);
+      __privateSet(this, _lastRemoteCursorRenderTime, performance.now());
       __privateMethod$1(this, _PresentationEditor_instances, renderRemoteCursors_fn).call(this);
-    }));
+    });
   };
   updateRemoteCursors_fn = function() {
     if (__privateGet$1(this, _layoutOptions).presence?.enabled === false) {
       __privateGet$1(this, _remoteCursorState).clear();
+      __privateGet$1(this, _remoteCursorElements).clear();
       if (__privateGet$1(this, _remoteCursorOverlay)) {
         __privateGet$1(this, _remoteCursorOverlay).innerHTML = "";
       }
@@ -92320,9 +92468,6 @@ ${l}
     }
   };
   renderRemoteCursors_fn = function() {
-    if (__privateGet$1(this, _remoteCursorOverlay)) {
-      __privateGet$1(this, _remoteCursorOverlay).innerHTML = "";
-    }
     const layout = __privateGet$1(this, _layoutState)?.layout;
     const blocks2 = __privateGet$1(this, _layoutState)?.blocks;
     const measures = __privateGet$1(this, _layoutState)?.measures;
@@ -92331,37 +92476,63 @@ ${l}
     }
     const maxVisible = __privateGet$1(this, _layoutOptions).presence?.maxVisible ?? 20;
     const sortedCursors = Array.from(__privateGet$1(this, _remoteCursorState).values()).sort((a2, b2) => b2.updatedAt - a2.updatedAt).slice(0, maxVisible);
+    const visibleClientIds = /* @__PURE__ */ new Set();
     sortedCursors.forEach((cursor) => {
+      visibleClientIds.add(cursor.clientId);
       if (cursor.anchor === cursor.head) {
         __privateMethod$1(this, _PresentationEditor_instances, renderRemoteCaret_fn).call(this, cursor);
       } else {
         __privateMethod$1(this, _PresentationEditor_instances, renderRemoteSelection_fn).call(this, cursor);
       }
     });
+    __privateGet$1(this, _remoteCursorElements).forEach((element2, clientId) => {
+      if (!visibleClientIds.has(clientId)) {
+        element2.remove();
+        __privateGet$1(this, _remoteCursorElements).delete(clientId);
+      }
+    });
   };
   renderRemoteCaret_fn = function(cursor) {
     const caretLayout = __privateMethod$1(this, _PresentationEditor_instances, computeCaretLayoutRect_fn).call(this, cursor.head);
-    if (!caretLayout) return;
-    const coords = __privateMethod$1(this, _PresentationEditor_instances, convertPageLocalToOverlayCoords_fn).call(this, caretLayout.pageIndex, caretLayout.x, caretLayout.y);
-    if (!coords) return;
     const zoom = __privateGet$1(this, _layoutOptions).zoom ?? 1;
     const doc2 = __privateGet$1(this, _visibleHost).ownerDocument ?? document;
     const color2 = __privateMethod$1(this, _PresentationEditor_instances, getValidatedColor_fn).call(this, cursor);
-    const caretEl = doc2.createElement("div");
-    caretEl.className = "presentation-editor__remote-caret";
-    caretEl.style.position = "absolute";
-    caretEl.style.left = `${coords.x}px`;
-    caretEl.style.top = `${coords.y}px`;
-    caretEl.style.width = `${_PresentationEditor.CURSOR_STYLES.CARET_WIDTH}px`;
+    let caretEl = __privateGet$1(this, _remoteCursorElements).get(cursor.clientId);
+    const isNewElement = !caretEl;
+    if (isNewElement) {
+      caretEl = doc2.createElement("div");
+      caretEl.className = "presentation-editor__remote-caret";
+      caretEl.style.position = "absolute";
+      caretEl.style.width = `${_PresentationEditor.CURSOR_STYLES.CARET_WIDTH}px`;
+      caretEl.style.borderLeft = `${_PresentationEditor.CURSOR_STYLES.CARET_WIDTH}px solid ${color2}`;
+      caretEl.style.pointerEvents = "none";
+      caretEl.style.transition = "transform 50ms ease-out, height 50ms ease-out, opacity 100ms ease-out";
+      caretEl.style.willChange = "transform";
+      caretEl.setAttribute("data-client-id", cursor.clientId.toString());
+      caretEl.setAttribute("aria-hidden", "true");
+      if (__privateGet$1(this, _layoutOptions).presence?.showLabels !== false) {
+        __privateMethod$1(this, _PresentationEditor_instances, renderRemoteCursorLabel_fn).call(this, caretEl, cursor);
+      }
+      __privateGet$1(this, _remoteCursorElements).set(cursor.clientId, caretEl);
+      __privateGet$1(this, _remoteCursorOverlay)?.appendChild(caretEl);
+    }
+    if (!caretLayout) {
+      caretEl.style.opacity = "0";
+      return;
+    }
+    const coords = __privateMethod$1(this, _PresentationEditor_instances, convertPageLocalToOverlayCoords_fn).call(this, caretLayout.pageIndex, caretLayout.x, caretLayout.y);
+    if (!coords) {
+      caretEl.style.opacity = "0";
+      return;
+    }
+    caretEl.style.opacity = "1";
+    caretEl.style.transform = `translate(${coords.x}px, ${coords.y}px)`;
     caretEl.style.height = `${Math.max(1, caretLayout.height * zoom)}px`;
-    caretEl.style.borderLeft = `${_PresentationEditor.CURSOR_STYLES.CARET_WIDTH}px solid ${color2}`;
-    caretEl.style.pointerEvents = "none";
-    caretEl.setAttribute("data-client-id", cursor.clientId.toString());
-    caretEl.setAttribute("aria-hidden", "true");
-    if (__privateGet$1(this, _layoutOptions).presence?.showLabels !== false) {
-      __privateMethod$1(this, _PresentationEditor_instances, renderRemoteCursorLabel_fn).call(this, caretEl, cursor);
+    caretEl.style.borderLeftColor = color2;
+    const labelEl = caretEl.querySelector(".presentation-editor__remote-label");
+    if (labelEl) {
+      labelEl.style.backgroundColor = color2;
     }
-    __privateGet$1(this, _remoteCursorOverlay)?.appendChild(caretEl);
   };
   renderRemoteCursorLabel_fn = function(caretEl, cursor) {
     const labelFormatter = __privateGet$1(this, _layoutOptions).presence?.labelFormatter;
@@ -92796,6 +92967,7 @@ ${l}
     }
     const sectionMetadata = [];
     let blocks2;
+    let bookmarks = /* @__PURE__ */ new Map();
     try {
       const converter2 = __privateGet$1(this, _editor3).converter;
       const converterContext = converter2 ? {
@@ -92814,6 +92986,7 @@ ${l}
         converterContext
       });
       blocks2 = result.blocks;
+      bookmarks = result.bookmarks ?? /* @__PURE__ */ new Map();
     } catch (error) {
       __privateMethod$1(this, _PresentationEditor_instances, handleLayoutError_fn).call(this, "render", __privateMethod$1(this, _PresentationEditor_instances, decorateError_fn).call(this, error, "toFlowBlocks"));
       return;
@@ -92861,7 +93034,8 @@ ${l}
     __privateSet(this, _sectionMetadata, sectionMetadata);
     const converter = __privateGet$1(this, _editor3).converter;
     __privateSet(this, _multiSectionIdentifier, buildMultiSectionIdentifier(sectionMetadata, converter?.pageStyles));
-    __privateSet(this, _layoutState, { blocks: blocks2, measures, layout });
+    const anchorMap = __privateMethod$1(this, _PresentationEditor_instances, computeAnchorMap_fn).call(this, bookmarks, layout);
+    __privateSet(this, _layoutState, { blocks: blocks2, measures, layout, bookmarks, anchorMap });
     __privateSet(this, _headerLayoutResults, headerLayouts ?? null);
     __privateSet(this, _footerLayoutResults, footerLayouts ?? null);
     await __privateMethod$1(this, _PresentationEditor_instances, layoutPerRIdHeaderFooters_fn).call(this, headerFooterInput, layout, sectionMetadata);
@@ -93520,9 +93694,9 @@ ${l}
     __privateMethod$1(this, _PresentationEditor_instances, announce_fn).call(this, __privateGet$1(this, _session).mode === "body" ? "Exited header/footer edit mode." : `Editing ${__privateGet$1(this, _session).kind === "header" ? "Header" : "Footer"} (${__privateGet$1(this, _session).sectionType ?? "default"})`);
   };
   updateAwarenessSession_fn = function() {
-    const provider2 = __privateGet$1(this, _editor3).options?.collaborationProvider;
+    const provider2 = __privateGet$1(this, _options).collaborationProvider;
     const awareness = provider2?.awareness;
-    if (!awareness?.setLocalStateField) {
+    if (!awareness || typeof awareness.setLocalStateField !== "function") {
       return;
     }
     if (__privateGet$1(this, _session).mode === "body") {
@@ -93631,6 +93805,62 @@ ${l}
       __privateGet$1(this, _visibleHost).scrollTop = yPosition;
     }
   };
+  computeAnchorMap_fn = function(bookmarks, layout) {
+    const anchorMap = /* @__PURE__ */ new Map();
+    const blockPmRanges = /* @__PURE__ */ new Map();
+    const computeBlockRange = (blockId) => {
+      if (blockPmRanges.has(blockId)) {
+        const cached = blockPmRanges.get(blockId);
+        return { pmStart: cached.pmStart, pmEnd: cached.pmEnd };
+      }
+      const block = __privateGet$1(this, _layoutState).blocks.find((b2) => b2.id === blockId);
+      if (!block || block.kind !== "paragraph") {
+        blockPmRanges.set(blockId, { pmStart: null, pmEnd: null, hasFragmentPositions: false });
+        return { pmStart: null, pmEnd: null };
+      }
+      let pmStart = null;
+      let pmEnd = null;
+      for (const run2 of block.runs) {
+        if (run2.pmStart != null) {
+          pmStart = pmStart == null ? run2.pmStart : Math.min(pmStart, run2.pmStart);
+        }
+        if (run2.pmEnd != null) {
+          pmEnd = pmEnd == null ? run2.pmEnd : Math.max(pmEnd, run2.pmEnd);
+        }
+      }
+      blockPmRanges.set(blockId, { pmStart, pmEnd, hasFragmentPositions: false });
+      return { pmStart, pmEnd };
+    };
+    bookmarks.forEach((pmPosition, bookmarkName) => {
+      for (const page of layout.pages) {
+        for (const fragment of page.fragments) {
+          if (fragment.kind !== "para") continue;
+          let fragStart = fragment.pmStart;
+          let fragEnd = fragment.pmEnd;
+          if (fragStart == null || fragEnd == null) {
+            const range2 = computeBlockRange(fragment.blockId);
+            if (range2.pmStart != null && range2.pmEnd != null) {
+              fragStart = range2.pmStart;
+              fragEnd = range2.pmEnd;
+            }
+          } else {
+            const cached = blockPmRanges.get(fragment.blockId);
+            blockPmRanges.set(fragment.blockId, {
+              pmStart: cached?.pmStart ?? fragStart,
+              pmEnd: cached?.pmEnd ?? fragEnd,
+              hasFragmentPositions: true
+            });
+          }
+          if (fragStart == null || fragEnd == null) continue;
+          if (pmPosition >= fragStart && pmPosition < fragEnd) {
+            anchorMap.set(bookmarkName, page.number);
+            return;
+          }
+        }
+      }
+    });
+    return anchorMap;
+  };
   waitForPageMount_fn = async function(pageIndex, options = {}) {
     const timeout2 = options.timeout ?? 2e3;
     const startTime = performance.now();
@@ -94250,6 +94480,7 @@ ${l}
     SELECTION_BORDER_RADIUS: "2px",
     MAX_LABEL_LENGTH: 30
   };
+  _PresentationEditor.ANCHOR_NAV_TIMEOUT_MS = 2e3;
   let PresentationEditor = _PresentationEditor;
   class PresentationInputBridge {
     /**
@@ -129803,7 +130034,8 @@ ${style2}
         if (!surface) {
           return;
         }
-        moveCursorToMouseEvent(event.detail, props.editor);
+        const detail = event?.detail ?? {};
+        moveCursorToMouseEvent(detail, props.editor);
         setTimeout(() => {
           const currentState = props.editor.state;
           const hasLink = selectionHasNodeOrMark(currentState, "link", { requireEnds: true });
@@ -129818,8 +130050,8 @@ ${style2}
                 closePopover: props.closePopover
               },
               {
-                left: `${event.detail.clientX - surfaceRect.left}px`,
-                top: `${event.detail.clientY - surfaceRect.top + 15}px`
+                left: `${detail.clientX - surfaceRect.left}px`,
+                top: `${detail.clientY - surfaceRect.top + 15}px`
               }
             );
           }
@@ -147502,7 +147734,7 @@ ${style2}
       this.config.colors = shuffleArray(this.config.colors);
       this.userColorMap = /* @__PURE__ */ new Map();
       this.colorIndex = 0;
-      this.version = "1.0.0-beta.33";
+      this.version = "1.0.0-beta.34";
       this.#log("🦋 [superdoc] Using SuperDoc version:", this.version);
       this.superdocId = config2.superdocId || v4();
       this.colors = this.config.colors;
@@ -149946,7 +150178,7 @@ ${style2}
       value && typeof value === "object" && "byteLength" in value && "byteOffset" in value
     );
   }
-  const indexHX4H5xPH = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  const indexCQeXM6oB = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
     __proto__: null,
     unified
   }, Symbol.toStringTag, { value: "Module" }));