@vscode/markdown-editor 0.0.2-28 → 0.0.2-29

package/dist/index.d.ts

@@ -1165,6 +1165,16 @@ export declare class EditorView extends Disposable {
     /** The current view-data tree (AST overlaid with selection flags), for debugging. */
     private readonly _viewData;
     get viewData(): IObservable<DocumentViewData | undefined>;
+    /**
+     * Whether the editor is genuinely focused: focus rests somewhere inside the
+     * editor subtree *and* its window is focused. Mirrored onto the root as
+     * `.md-focused`, which gates the painted caret — the blinking cursor is only
+     * shown while this is `true`, so it never blinks in an unfocused editor or
+     * after the window loses focus. Only the caret's visibility is affected; the
+     * logical selection and caret geometry ({@link caretRect}) are unchanged.
+     */
+    private readonly _focused;
+    get focused(): IObservable<boolean>;
     /**
      * Caret rect (editor-local coordinates) for the transient empty paragraph, or
      * `undefined` when none is armed. Set each frame from the synthetic
@@ -1209,6 +1219,15 @@ export declare class EditorView extends Disposable {
      * a plain click, but an active link only opens with the modifier held.
      */
     private _setupModifierTracking;
+    /**
+     * Tracks whether the editor is genuinely focused and mirrors it onto the
+     * root as `.md-focused` so CSS can gate the painted caret. "Focused" means
+     * focus rests somewhere inside the editor subtree *and* the window itself is
+     * focused; either condition failing (focus moving elsewhere, or the window
+     * losing focus) hides the blinking caret while leaving the logical selection
+     * and caret geometry intact.
+     */
+    private _setupFocusTracking;
     /**
      * Renders the edit/read-only mode toggle. It flips the model's
      * {@link EditorModel.readonlyMode}: when locked (read-only) every block stays
@@ -1223,6 +1242,14 @@ export declare class EditorView extends Disposable {
     /** Draws attention to the mode toggle after text input is attempted while locked. */
     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.
+     */
+    tryAutoFocus(): boolean;
     /**
      * Own point→offset resolution. When `true` (the default),
      * {@link resolveOffsetFromPoint} ignores the platform DOM hit-test