@vscode/markdown-editor 0.0.2-92 → 0.0.2-94

package/dist/index.d.ts

@@ -1248,6 +1248,7 @@ export declare class EditorView extends Disposable {
     private _readonlyToggleButton;
     private readonly _editContextSuspensions;
     private readonly _revealOcclusions;
+    private _pendingTopReveal;
     private _caretRevealRaf;
     private _followedCaretBlock;
     private _followCaretAfterEdit;
@@ -1355,6 +1356,23 @@ export declare class EditorView extends Disposable {
      */
     suspendEditContextWhileFocused(element: HTMLElement): IDisposable;
     revealRangeInCenterIfOutsideViewport(range: OffsetRange, behavior?: ScrollBehavior): IDisposable;
+    /**
+     * Aligns an explicitly navigated range with the top of its nearest vertical
+     * scroll viewport, even when the range is already partially or fully visible.
+     * The alignment leaves {@link TOP_REVEAL_CONTEXT_INSET}px of navigation
+     * context above the range, grown so the range also clears any chrome
+     * registered through {@link registerRevealOcclusion} that covers the top of
+     * that viewport. Outer vertical scrollers and the window keep nearest-edge
+     * behavior so they do not jump, and horizontal scrolling stays nearest-edge.
+     *
+     * Explicit navigation also stops edit-driven caret following, so a later
+     * block resize does not scroll back to where the caret was left behind.
+     * Sticky chrome is remeasured once scrolling completes. User input, a newer
+     * reveal, or disposal cancels that deferred correction.
+     */
+    revealRangeAtTop(range: OffsetRange, behavior?: ScrollBehavior): IDisposable;
+    private _scheduleRangeReveal;
+    private _scheduleTopRangeReveal;
     /**
      * Keeps the caret visible after an editor-driven text edit. The reveal is
      * deferred until the rebuilt document has been laid out and uses nearest-edge
@@ -1464,6 +1482,31 @@ export declare class EditorView extends Disposable {
     private _measurementAt;
     private _stopFollowingCaret;
     private _isRevealOccluded;
+    /** Client rects of registered occlusions that are currently rendered and visible. */
+    private _activeRevealOcclusions;
+    /**
+     * How far registered chrome covers the top of `viewport`, measured down from
+     * `viewport.top`, across the columns `target` occupies. Clearing one occluder
+     * can slide the target behind the next one, so the tested band is re-evaluated
+     * until it settles; stacked chrome therefore reports the lowest connected
+     * bottom edge. Returns 0 when nothing covers the top.
+     */
+    private _occludedTopHeight;
+    /**
+     * Vertical inset used to top-align `target` inside `viewport`. Defaults to
+     * {@link TOP_REVEAL_CONTEXT_INSET}, and grows past registered chrome covering
+     * the viewport top so the same breathing room is kept below that chrome.
+     */
+    private _topRevealInset;
+    /**
+     * `viewport` reduced to the area an explicitly navigated target may occupy:
+     * registered top chrome is excluded, along with the breathing room below it.
+     * Nearest-edge movement parks the target just inside the rect it is given, so
+     * the inset has to be part of that rect; otherwise an outer scroller, or the
+     * window, would leave the target grazing the chrome's bottom edge after the
+     * nearest vertical viewport had already aligned it.
+     */
+    private _unoccludedViewport;
 }
 
 export declare interface EditorViewOptions extends BlockViewOptions {