npm - @vscode/markdown-editor - Versions diffs - 0.0.2-30 → 0.0.2-32 - Mend

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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (7) hide show

package/dist/index.d.ts +43 -7
package/dist/index.js +1346 -1189
package/dist/index.js.map +1 -1
package/package.json +1 -1
package/src/view/editor.css +63 -2
package/src/view/themes/vscode-default.css +7 -3
package/src/view/themes/vscode-github.css +8 -1

package/dist/index.d.ts CHANGED Viewed

@@ -1146,6 +1146,8 @@ export declare class EditorView extends Disposable {
     private readonly _gutterMarkersView;
     private readonly _diffHighlightsView;
     private _readonlyToggleButton;
+    private _readonlyEditAtButton;
+    private _readonlyEditTarget;
     /**
      * The mounted block sequence, in source order. Rebuilt (not mutated) each
      * frame by {@link DocumentViewNode.create}; the view just swaps one
@@ -1239,17 +1241,50 @@ export declare class EditorView extends Disposable {
      * for any CSS hooks.
      */
     private _setupReadonlyToggle;
+    /**
+     * Creates the transient click-local affordance that unlocks the editor at the
+     * source offset captured by {@link showReadonlyEditAt}.
+     */
+    private _setupReadonlyEditAt;
+    /**
+     * Shows an unlock affordance beside a locked-content click. `point` is in
+     * viewport client coordinates; `offset` is retained so activation restores
+     * the caret to the exact source position represented by that click.
+     */
+    showReadonlyEditAt(point: Point2D, offset: SourceOffset): void;
+    private _revealReadonlyEditAt;
+    private _readonlyEditVisibleRect;
+    /** Hides the transient click-local unlock affordance, if present. */
+    hideReadonlyEditAt(): void;
     /** 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.
+     * Samples the ambient focus state that decides whether taking focus on open
+     * would steal it from an explicit user target: whether the window is focused
+     * and whether focus is still unclaimed (no active element, or the `<body>`
+     * fallback).
+     */
+    private _sampleAutoFocusEnvironment;
+    /**
+     * 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; 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
@@ -1322,8 +1357,9 @@ export declare interface EditorViewOptions extends BlockViewOptions {
     readonly classNames?: readonly string[];
     /**
      * Whether to render the sticky edit/read-only toggle at the top-right edge
-     * of the content. Defaults to `true`; set to `false` to omit it (e.g. in
-     * fixtures that focus on selection rendering).
+     * of the content and the click-local unlock affordance. Defaults to `true`;
+     * set to `false` when read-only state is host-enforced or when fixtures focus
+     * on selection rendering.
      */
     readonly showReadonlyToggle?: boolean;
     /**