@vscode/markdown-editor 0.0.2-30 → 0.0.2-31

package/dist/index.d.ts

@@ -1243,13 +1243,25 @@ export declare class EditorView extends Disposable {
     showReadonlyEditingAttempt(): void;
     focus(): void;
     /**
-     * Focuses the editor when it opens, but only if doing so will not steal
-     * focus from an explicit user target: the window must already be focused and
-     * no other element may have claimed focus yet. Returns whether focus was
-     * taken. Intended for the single editable editor on open; a no-op for a
-     * background window or when the user has already focused something else.
+     * One-shot guarded focus attempt: focuses the editor only if doing so will
+     * not steal focus from an explicit user target — the window must already be
+     * focused and no other element may have claimed focus yet. Returns whether
+     * focus was taken. A no-op for a background window or when the user has
+     * already focused something else. {@link autoFocusOnOpen} builds the
+     * open-time behavior on top of this primitive.
      */
     tryAutoFocus(): boolean;
+    /**
+     * Focuses the editor when it opens without ever stealing focus from an
+     * explicit user target. Tries once immediately ({@link tryAutoFocus}); if the
+     * window is not focused yet — a common open-time race where the editor is
+     * mounted before the host routes focus to its window — the guarded attempt is
+     * deferred to the next time the window gains focus and re-evaluated then. The
+     * deferral is one-shot, so a later, unrelated window refocus never grabs
+     * focus, and the re-check still respects any target the user has claimed in
+     * the meantime.
+     */
+    autoFocusOnOpen(): void;
     /**
      * Own point→offset resolution. When `true` (the default),
      * {@link resolveOffsetFromPoint} ignores the platform DOM hit-test