@vscode/markdown-editor 0.0.2-14 → 0.0.2-141

package/dist/index.d.ts

@@ -1,9 +1,10 @@
-import { Disposable } from './_observables/index';
-import { IDisposable } from './_observables/index';
-import { IObservable } from './_observables/index';
-import { IObservableWithChange } from './_observables/index';
-import { ISettableObservable } from './_observables/index';
-import { ITransaction } from './_observables/index';
+import { Disposable } from '@vscode/observables';
+import { IDisposable } from '@vscode/observables';
+import { IObservable } from '@vscode/observables';
+import { IObservableWithChange } from '@vscode/observables';
+import { IReader } from '@vscode/observables';
+import { ISettableObservable } from '@vscode/observables';
+import { ITransaction } from '@vscode/observables';
 import { MonarchTokenizer } from 'monaco-editor/esm/vs/editor/standalone/common/monarch/monarchLexer.js';
 
 declare interface AddedItem {
@@ -24,7 +25,7 @@ declare interface AnnotatedRange {
 }
 
 /** Every concrete node kind, for exhaustive consumer-side dispatch. */
-export declare type AnyAstNode = TextAstNode | MarkerAstNode | GlueAstNode | ThematicBreakAstNode | StrongAstNode | EmphasisAstNode | StrikethroughAstNode | InlineCodeAstNode | InlineMathAstNode | LinkAstNode | ImageAstNode | HeadingAstNode | ParagraphAstNode | CodeBlockAstNode | MathBlockAstNode | BlockQuoteAstNode | ListAstNode | ListItemAstNode | TableAstNode | TableRowAstNode | TableCellAstNode | DocumentAstNode;
+export declare type AnyAstNode = TextAstNode | MarkerAstNode | GlueAstNode | ThematicBreakAstNode | StrongAstNode | EmphasisAstNode | StrikethroughAstNode | InlineCodeAstNode | InlineMathAstNode | LinkAstNode | ImageAstNode | HeadingAstNode | ParagraphAstNode | EmptyBlockAstNode | FrontMatterAstNode | CodeBlockAstNode | MathBlockAstNode | VideoAstNode | BlockQuoteAstNode | ListAstNode | ListItemAstNode | TableAstNode | TableRowAstNode | TableCellAstNode | DocumentAstNode | UnhandledBlockAstNode;
 
 declare type AnyViewData = DocumentViewData | BlockViewData | InlineViewData | ListItemViewData | TableRowViewData | TableCellViewData | MarkerViewData | GlueViewData | DiffHunkViewData | DiffDecorationViewData;
 
@@ -72,23 +73,33 @@ declare interface AstVisualizationNode {
 }
 
 /**
- * Strategy for hosts that never deliver native clipboard events to the editor
- * — most importantly VS Code webviews, whose preload calls `preventDefault()`
- * on the Ctrl/Cmd+C/X/V keydowns, so no `copy`/`cut`/`paste` event is ever
- * dispatched. Here the keystrokes are the only signal, so this strategy
- * listens for them directly and drives the async {@link Clipboard} API
- * (`navigator.clipboard`), which webviews are granted.
+ * Strategy for hosts that intercept native clipboard shortcuts, notably
+ * VS Code webviews. Their preload prevents the default Ctrl/Cmd+C/X/V handling
+ * and forwards the keydowns to the host. This strategy handles the keystrokes
+ * directly using the async {@link Clipboard} API (`navigator.clipboard`),
+ * which webviews are granted.
  *
  * Cut deletes synchronously once the text is captured; the clipboard write is
  * fire-and-forget. Paste must wait for the async read before inserting.
+ * Handled keydowns must not reach the host, which may replay native clipboard
+ * commands even when the browser's default has been prevented.
+ *
+ * Hosts can supply a paste callback to read images or other clipboard formats.
+ * It receives the original context, whether Shift requested plain text, and
+ * native clipboard data when a paste event supplied it. Context menus focus a
+ * temporary editable target so native paste works with EditContext roots too.
+ * The callback owns asynchronous errors and stale-selection checks. It does
+ * not override copy/cut or clipboard handling in nested native inputs.
  */
 export declare class AsyncClipboardStrategy implements IClipboardStrategy {
     private readonly _clipboard;
-    constructor(_clipboard?: Clipboard);
+    private readonly _paste?;
+    constructor(_clipboard?: Clipboard, _paste?: ((context: IClipboardContext, plainText: boolean, nativeData?: NativeClipboardData) => Promise<void>) | undefined);
+    writeText(text: string): Promise<void>;
     connect(context: IClipboardContext): IDisposable;
 }
 
-export declare type BlockAstNode = HeadingAstNode | ParagraphAstNode | CodeBlockAstNode | MathBlockAstNode | ThematicBreakAstNode | BlockQuoteAstNode | ListAstNode | TableAstNode;
+export declare type BlockAstNode = HeadingAstNode | ParagraphAstNode | EmptyBlockAstNode | FrontMatterAstNode | CodeBlockAstNode | MathBlockAstNode | ThematicBreakAstNode | VideoAstNode | BlockQuoteAstNode | ListAstNode | TableAstNode | UnhandledBlockAstNode;
 
 /**
  * A block-level node. Every block may carry a {@link leadingTrivia} glue — the
@@ -109,7 +120,7 @@ declare abstract class BlockAstNodeBase extends AstNode {
 /**
  * One block's place in the rendered document.
  *
- * `height` is in CSS pixels. It is either a real DOM measurement
+ * Geometry is in editor-local CSS pixels. `height` is either a real DOM measurement
  * (`isMeasured: true`) or an estimate produced when the block is not
  * currently mounted (`isMeasured: false`). Estimates exist so virtual
  * rendering can size the scroll container without mounting every block.
@@ -124,6 +135,13 @@ export declare interface BlockMeasurement {
     readonly block: BlockAstNode;
     readonly absoluteStart: number;
     readonly height: number;
+    /** Local border box when mounted and measured. */
+    readonly rect: Rect2D | undefined;
+    /** Local horizontal padding-box clip when this block scrolls horizontally. */
+    readonly viewportClip: {
+        readonly left: number;
+        readonly right: number;
+    } | undefined;
     readonly isMeasured: boolean;
     readonly visualLineMap: VisualLineMap | undefined;
     readonly viewNode: ViewNode | undefined;
@@ -143,11 +161,22 @@ export declare class BlockQuoteAstNode extends BlockAstNodeBase {
 declare class BlockQuoteViewData {
     readonly ast: BlockQuoteAstNode;
     readonly content: readonly AnyViewData[];
+    /** False while a pending paragraph replaces the final marker-only line. */
+    readonly showFinalMarkerOnlyLine: boolean;
     readonly kind = "blockQuote";
-    constructor(ast: BlockQuoteAstNode, content: readonly AnyViewData[]);
+    constructor(ast: BlockQuoteAstNode, content: readonly AnyViewData[], 
+    /** False while a pending paragraph replaces the final marker-only line. */
+    showFinalMarkerOnlyLine: boolean);
 }
 
-declare type BlockViewData = HeadingViewData | ParagraphViewData | CodeBlockViewData | MathBlockViewData | ThematicBreakViewData | BlockQuoteViewData | ListViewData | TableViewData;
+/**
+ * All blocks whose source range intersects `[start, endExclusive]`. A
+ * collapsed range (start === endExclusive) matches the block containing
+ * that offset (with the same boundary rule as {@link findBlockAtOffset}).
+ */
+export declare function blocksIntersecting(doc: DocumentAstNode, start: SourceOffset, endExclusive: SourceOffset): BlockAstNode[];
+
+declare type BlockViewData = HeadingViewData | ParagraphViewData | EmptyBlockViewData | FrontMatterViewData | CodeBlockViewData | MathBlockViewData | ThematicBreakViewData | VideoViewData | BlockQuoteViewData | ListViewData | TableViewData | UnhandledBlockViewData;
 
 /**
  * Base view node for everything the editor renders, generic over the
@@ -168,6 +197,17 @@ export declare class BlockViewNode<T extends AnyViewData = AnyViewData> extends
     constructor(data: T, dom: globalThis.Node, children: readonly ViewNode[]);
     get block(): BlockAstNode;
     get element(): HTMLElement;
+    /**
+     * The horizontal scroll viewport for selection/caret clipping
+     * ({@link blockViewportClip}). For most blocks the scroller *is*
+     * {@link element} — a code / math / unhandled block's `element` is the very
+     * `overflow-x: auto` box that scrolls. A table is the exception: its
+     * `element` stays the inner `<table>` (so the active/markers classes and
+     * `.md-table` theme styling are unaffected), but the box that actually
+     * scrolls is the wrapping `.md-table-wrapper`, so {@link TableViewNode}
+     * overrides this to return that wrapper.
+     */
+    get scrollElement(): HTMLElement;
     /**
      * Whether this already-built node can stand in for `data` unchanged. The
      * builder preserves view-data identity for any subtree whose ast and
@@ -175,7 +215,7 @@ export declare class BlockViewNode<T extends AnyViewData = AnyViewData> extends
      * single identity check captures "nothing in my subtree changed" — and its
      * whole subtree, and any session it owns, are kept as-is.
      */
-    canReuse(data: AnyViewData): boolean;
+    canReuse(data: AnyViewData, _options: BlockViewOptions | undefined): boolean;
     /**
      * Called by the view after this block is mounted and measured, with the
      * block's rendered height in px. The default is a no-op; subclasses whose
@@ -186,14 +226,25 @@ export declare class BlockViewNode<T extends AnyViewData = AnyViewData> extends
 }
 
 export declare interface BlockViewOptions {
+    /** Writes explicit copy actions through the host clipboard; defaults to the browser API. */
+    readonly writeClipboardText?: (text: string) => Promise<void>;
+    readonly preserveSourceWhitespace?: boolean;
     readonly renderCustomCodeBlock?: (language: string, content: string) => HTMLElement | undefined;
     readonly onToggleCheckbox?: (item: ListItemAstNode, newChecked: boolean) => void;
+    /** Temporarily yields the host editor's text input while a nested control owns focus. */
+    readonly suspendEditContextWhileFocused?: (element: HTMLElement) => IDisposable;
+    /**
+     * Supplies live, declarative metadata for recognized links. The editor owns
+     * the markup and styling; providers own lookup, caching, and updates.
+     */
+    readonly linkPresentationProvider?: ILinkPresentationProvider;
     /**
      * Opens a link's URL. Called when the user activates a link: a plain click
      * while the link's block is inactive (rendered), or a Ctrl/Cmd+click while it
-     * is active (source shown). Defaults to `window.open(url, '_blank')`.
+     * is active (source shown). Return `false` to use the anchor's native
+     * navigation behavior.
      */
-    readonly onOpenLink?: (url: string, event: MouseEvent) => void;
+    readonly onOpenLink?: (url: string, event: MouseEvent) => false | void;
     /**
      * Colours fenced code blocks. When set, a code block's content is rendered
      * as a sequence of token spans instead of one plain text node. This is the
@@ -213,16 +264,47 @@ export declare interface BlockViewOptions {
      * `katexEditableIdentifiers.ts`).
      */
     readonly renderMath?: (request: MathRenderRequest) => MathRendering | undefined;
+    /**
+     * Pluggable factory for an in-place, interactive editor that replaces the
+     * *rendered* (inactive) form of a fenced code block — see
+     * {@link IEmbeddedCodeEditor}. When it returns an editor for the block's
+     * language, that editor's element is mounted instead of the highlighted
+     * code, and content flows both ways as string edits. Returning `undefined`
+     * falls back to the default rendering. EXPERIMENTAL.
+     */
+    readonly embeddedCodeEditorFactory?: IEmbeddedCodeEditorFactory;
+    /** Current read-only state forwarded to embedded code editors. */
+    readonly embeddedCodeEditorReadOnly?: boolean;
+    /** Identity used to invalidate previously created embedded editors. */
+    readonly embeddedCodeEditorFactoryVersion?: unknown;
+    /**
+     * Called when an {@link IEmbeddedCodeEditor} edits its content. `contentEdit`
+     * is in the block's *content* coordinates; the host translates it to a
+     * document edit (via {@link CodeBlockAstNode.codeOffset} and the block's
+     * offset) and applies it to the model.
+     */
+    readonly onEmbeddedCodeEditorEdit?: (block: CodeBlockAstNode, contentEdit: StringEdit) => void;
 }
 
 export declare class CodeBlockAstNode extends BlockAstNodeBase {
+    /** First token of the fenced code block info string, used for syntax highlighting. */
     readonly language: string;
+    /** Complete fenced code block info string, including metadata after the language token. */
+    readonly infoString: string;
     readonly content: readonly (MarkerAstNode | GlueAstNode)[];
     readonly leadingTrivia?: GlueAstNode | undefined;
+    /** Logical code tokens, excluding Markdown container prefixes and structural indentation. */
+    readonly codeText?: string | undefined;
     readonly kind = "codeBlock";
     private _previous?;
     private _contentEdit?;
-    constructor(language: string, content: readonly (MarkerAstNode | GlueAstNode)[], leadingTrivia?: GlueAstNode | undefined);
+    constructor(
+    /** First token of the fenced code block info string, used for syntax highlighting. */
+    language: string, 
+    /** Complete fenced code block info string, including metadata after the language token. */
+    infoString: string, content: readonly (MarkerAstNode | GlueAstNode)[], leadingTrivia?: GlueAstNode | undefined, 
+    /** Logical code tokens, excluding Markdown container prefixes and structural indentation. */
+    codeText?: string | undefined);
     get children(): readonly AstNode[];
     get openFence(): MarkerAstNode | undefined;
     get closeFence(): MarkerAstNode | undefined;
@@ -277,6 +359,8 @@ declare class CodeBlockViewData {
  * only, so a nested block currently builds a fresh session on each rebuild.
  */
 export declare class CodeBlockViewNode extends BlockViewNode<CodeBlockViewData> {
+    private readonly _contentElement;
+    private _copyAction;
     private _session;
     /**
      * Subscription that re-tokenises the rendered `<code>` in place whenever the
@@ -288,10 +372,28 @@ export declare class CodeBlockViewNode extends BlockViewNode<CodeBlockViewData>
      * its predecessor's subscription explicitly.
      */
     private _snapshotSub;
+    /**
+     * An in-place interactive editor (e.g. an iframe) mounted instead of the
+     * rendered code. Like {@link _session} it is adopted from `previous` across
+     * rebuilds so the underlying editor keeps its state, and must be disposed
+     * manually (a node reused as `previous` is never {@link dispose}d).
+     */
+    private _embeddedEditor;
+    private readonly _embeddedEditorFactoryVersion;
+    private readonly _embeddedEditorReadOnly;
+    canReuse(data: AnyViewData, options: BlockViewOptions | undefined): boolean;
     constructor(data: CodeBlockViewData, options: BlockViewOptions | undefined, previous: ViewNode | undefined);
+    get element(): HTMLElement;
     dispose(): void;
 }
 
+/**
+ * Canonical editor command catalog. Standalone keyboard handling and host
+ * integrations derive their command registration and default keybindings from
+ * this list.
+ */
+export declare const commands: readonly EditorCommandDefinition[];
+
 /** A persistent comment anchored to a source range. */
 declare interface Comment_2 {
     readonly id: string;
@@ -307,16 +409,10 @@ declare interface Comment_2 {
 export { Comment_2 as Comment }
 
 /**
- * A self-contained comment input box — a rounded panel with an auto-growing
- * textarea and a send button, styled after the gdocs/Word "add a comment"
- * affordance.
- *
- * This widget is *positioning-agnostic*: it only owns its own DOM and state.
- * A host (the comment-mode controller, or a fixture) mounts {@link element}
- * wherever it likes and is responsible for placing it relative to a selection.
+ * The compact editing state for a markdown comment.
  *
- * State is observable-driven (no framework): {@link value} reflects the live
- * textarea content; submit/cancel are reported through the option callbacks.
+ * The widget owns its DOM and draft state but not its position. The comment-mode
+ * controller mounts it next to the active selection.
  */
 export declare class CommentInputWidget extends Disposable {
     private readonly _options?;
@@ -327,25 +423,24 @@ export declare class CommentInputWidget extends Disposable {
     private readonly _value;
     /** Live, untrimmed textarea content. */
     get value(): IObservable<string>;
-    /** The raw textarea, exposed so a host can move focus into it (e.g. on Tab). */
+    /** The raw textarea, exposed so a host can move focus into it. */
     get inputElement(): HTMLTextAreaElement;
     constructor(_options?: CommentInputWidgetOptions | undefined);
-    /** Move focus into the textarea (caret at the end). */
     focus(): void;
-    /** Replace the textarea content. */
     setText(text: string): void;
-    /** Clear the textarea. */
     clear(): void;
     private _submit;
     private _autoSize;
 }
 
 export declare interface CommentInputWidgetOptions {
-    /** Placeholder shown while the textarea is empty. Defaults to "Add Comment". */
+    /** Placeholder shown while the textarea is empty. Defaults to "Add comment". */
     readonly placeholder?: string;
+    /** Called after the textarea changes size. */
+    readonly onDidChangeSize?: () => void;
     /**
-     * Called when the user submits a non-empty comment (Enter or the send
-     * button). The text is trimmed; never called with an empty string.
+     * Called when the user submits a non-empty comment (Enter or the add button).
+     * The text is trimmed; never called with an empty string.
      */
     readonly onSubmit?: (text: string) => void;
     /** Called when the user dismisses the input (Escape). */
@@ -353,7 +448,7 @@ export declare interface CommentInputWidgetOptions {
 }
 
 /**
- * Comment mode — a gdocs/Word-style "add a comment" affordance layered on top of
+ * Comment mode — a compact "add a comment" affordance layered on top of
  * the editor *without modifying it*. It reads the editor's public observables
  * ({@link EditorModel.readonlyMode}, {@link EditorModel.selection}) and the
  * exposed {@link EditorView.caretRect} geometry, and mounts a
@@ -361,37 +456,38 @@ export declare interface CommentInputWidgetOptions {
  *
  * Behaviour:
  *  - Only active in read-only mode (the "review" view).
- *  - When the selection is non-empty, the input box appears next to the caret
- *    (the selection's active end) but does NOT take focus, so keyboard selection
- *    keeps working. Press Tab to move focus into the box, then type.
+ *  - When a user-created selection is non-empty, the input box appears next to
+ *    the caret (the selection's active end) but does NOT take focus, so keyboard
+ *    selection keeps working. Programmatic selections such as find matches do
+ *    not summon it. Press Tab to move focus into the box, then type.
  *  - The box appears on mouse-up, not mid-drag, so it doesn't flicker/jump
  *    while a selection is being dragged out (keyboard selection shows at once).
  *  - While the box has focus or holds a draft it is frozen in place (selection
  *    changes, drags and clicks no longer move it). It is dismissed by Escape,
  *    by submitting, or by blurring an empty box.
- *  - The editor's painted caret is hidden only while the box has focus (the
- *    blinking caret then belongs to the comment input); it stays visible while
- *    the box is merely shown, so keyboard selection remains visible.
+ *  - The editor's logical caret geometry remains available for anchoring in
+ *    read-only mode even though the painted caret is hidden. While the box has
+ *    focus, `.md-comment-active` also suppresses the painted caret in any mode.
  */
 export declare class CommentModeController extends Disposable {
     private readonly _model;
     private readonly _view;
     private readonly _options?;
+    private static _isCommentableSelectionSource;
     private readonly _widget;
     private readonly _gap;
     private _visible;
+    private _anchorX;
     private _pinnedRange;
     /**
-     * The range a comment was just submitted for. The box stays hidden for it
-     * until the selection changes, so submitting doesn't immediately re-summon an
-     * empty box on the still-selected text.
+     * Keep a dismissed comment hidden across layout updates until the selection
+     * changes, whether the user submitted it or pressed Escape.
      */
-    private _submittedRange;
-    /** True while a mouse button is held over the editor (a selection drag in progress). */
-    private readonly _mouseDown;
+    private _dismissedRange;
     constructor(_model: EditorModel, _view: EditorView, _options?: CommentModeControllerOptions | undefined);
     private _update;
     private _show;
+    private _layoutHorizontally;
     /** Force-hide and clear the box (used by Escape and submit). */
     private _hide;
     /**
@@ -419,20 +515,10 @@ export declare interface CommentModeControllerOptions {
     readonly gap?: number;
 }
 
-/** Human-readable labels (for pickers / dropdowns). */
-export declare const COMMENTS_DESIGN_LABELS: Record<CommentsDesign, string>;
-
-/** design id → presenter factory over a shared CommentsModel + EditorView. */
-export declare const COMMENTS_DESIGNS: Record<CommentsDesign, CommentsPresenterFactory>;
-
-/** The available comment rendering designs. */
-export declare type CommentsDesign = 'connected' | 'vscode' | 'vscode-v2';
-
 /**
- * Seedable store of {@link Comment}s for the comment-mode contribution. Owns the
- * comment list and the shared hover state; it has no opinion on rendering or
- * persistence — a host seeds it via {@link set}/{@link add} and observes
- * {@link comments}.
+ * Seedable store of {@link Comment}s for the comment-mode contribution. It has
+ * no opinion on rendering or persistence — a host seeds it via
+ * {@link set}/{@link add} and observes {@link comments}.
  */
 export declare class CommentsModel {
     private readonly _comments;
@@ -440,11 +526,6 @@ export declare class CommentsModel {
     private _sequence;
     /** The current comments, in insertion order. */
     get comments(): IObservable<readonly Comment_2[]>;
-    /**
-     * The comment currently hovered (by its card or its highlight), or
-     * `undefined`. Shared so the card and the highlight can react together.
-     */
-    readonly hoveredId: ISettableObservable<string | undefined>;
     /** Replace the whole comment set. */
     set(comments: readonly Comment_2[]): void;
     /**
@@ -463,57 +544,54 @@ export declare class CommentsModel {
     remove(id: string): void;
 }
 
-/** Optional, design-specific context a presenter may use (ignored by others). */
-export declare interface CommentsPresenterContext {
-    /** Light/dark hint for the token-wrapped VS Code widget designs. */
-    readonly theme?: 'light' | 'dark';
-    /**
-     * Resolves a source offset to a 1-based line number, for designs that show
-     * line info (the VS Code V1 card). Optional because the model itself carries
-     * no text; the host (which owns the source) supplies it.
-     */
-    readonly resolveLine?: (offset: number) => number;
-}
-
-/** Builds a presenter for a given model + editor view. */
-export declare type CommentsPresenterFactory = (model: CommentsModel, view: EditorView, context?: CommentsPresenterContext) => ICommentsPresenter;
-
 /** A comment the user submitted, with the source range it was anchored to. */
 export declare interface CommentSubmission {
     readonly text: string;
     readonly range: OffsetRange;
 }
 
-/**
- * Renders persistent comments as a gdocs-style side rail: each comment's range
- * is highlighted (reusing the editor's selection geometry via
- * {@link EditorView.rangeRects}), a leader line curves from the bottom of that
- * highlight to a card stacked in the right rail, and cards never overlap.
- *
- * Everything is mounted into {@link EditorView.overlayContainer} so it shares
- * the selection/caret coordinate space and scrolls with the document. When the
- * editor's natural right margin is too narrow for the rail, the view reserves
- * proportional space by padding the editor on the right — but only while there
- * are comments.
- */
+/** Displays posted comments beside their source ranges. */
 export declare class CommentsView extends Disposable {
     private readonly _model;
     private readonly _view;
     private readonly _layer;
     private readonly _entries;
+    private _order;
+    private _pendingRevealCommentId;
     constructor(_model: CommentsModel, _view: EditorView);
-    private _createLayer;
-    private _update;
-    /** Create/update/remove per-comment DOM to match `comments`. */
+    revealComment(id: string): void;
     private _reconcile;
-    private _createEntry;
-    private _fillCard;
-    private _disposeEntry;
-    /** Position highlights, cards (stacked) and leader lines. */
-    private _layout;
-    private _applyHover;
+    private _relayout;
+    private _revealPendingComment;
+}
+
+/** Compact posted state for a markdown comment. */
+export declare class CommentWidget {
+    private readonly _domNode;
+    private readonly _disposables;
+    get element(): HTMLElement;
+    constructor(options: CommentWidgetOptions);
+    dispose(): void;
+}
+
+export declare interface CommentWidgetOptions {
+    /** The posted comment body. */
+    readonly body: string;
+    /** If provided, shows a delete action and invokes it when activated. */
+    readonly onDelete?: () => void;
 }
 
+/** The lossless source slices of a complete block HTML comment. */
+declare interface CompleteHtmlCommentSource extends HtmlCommentSourceBase {
+    readonly kind: 'complete';
+    readonly closing: '-->';
+    readonly trailingWhitespace: string;
+}
+
+export declare const copyLinesDown: EditCommand;
+
+export declare const copyLinesUp: EditCommand;
+
 /**
  * A {@link MonacoSyntaxHighlighter} preloaded with a handful of common Monarch
  * grammars (plus the usual short aliases). Unknown languages fall back to an
@@ -524,13 +602,17 @@ export declare class CommentsView extends Disposable {
  */
 export declare function createDefaultMonacoSyntaxHighlighter(monaco: IMonarchApi, grammars: IDefaultMonarchGrammars): MonacoSyntaxHighlighter;
 
-export declare type CursorCommand = (ctx: CursorCommandContext) => SourceOffset;
+export declare type CursorCommand = (ctx: CursorCommandContext) => CursorPosition;
 
 export declare interface CursorCommandContext {
     readonly text: string;
     readonly selection: Selection_2;
     readonly document: DocumentAstNode;
     readonly activeBlock: BlockAstNode | undefined;
+    readonly markerVisibleBlocks: ReadonlySet<BlockAstNode>;
+    readonly markupSelectionRange?: OffsetRange;
+    readonly wordNavigationConfig: WordNavigationConfig;
+    readonly cursorPosition: CursorPosition;
 }
 
 export declare const cursorDocumentEnd: CursorCommand;
@@ -539,6 +621,8 @@ export declare const cursorDocumentStart: CursorCommand;
 
 export declare const cursorDown: VisualCursorCommand;
 
+export declare type CursorKeyboardAction = 'left' | 'right' | 'up' | 'down' | 'wordLeft' | 'wordRight' | 'visualLineStart' | 'visualLineEnd' | 'logicalLineStart' | 'logicalLineEnd' | 'documentStart' | 'documentEnd';
+
 export declare const cursorLeft: CursorCommand;
 
 export declare const cursorLineEnd: CursorCommand;
@@ -548,12 +632,23 @@ export declare const cursorLineStart: CursorCommand;
 export declare const cursorMoveLeft: CursorCommand;
 
 export declare interface CursorMoveResult {
-    readonly offset: SourceOffset;
+    readonly position: CursorPosition;
     readonly desiredColumn: number | undefined;
 }
 
 export declare const cursorMoveRight: CursorCommand;
 
+/** The cursor's position in either source text or a source-less visual line. */
+export declare type CursorPosition = SourceCursorPosition | {
+    readonly kind: 'virtual';
+    readonly line: VirtualCursorLine;
+};
+
+export declare namespace CursorPosition {
+    export function source(offset: SourceOffset, affinity?: SourceCursorPosition['affinity']): SourceCursorPosition;
+    export function virtual(line: VirtualCursorLine): CursorPosition;
+}
+
 export declare const cursorRight: CursorCommand;
 
 export declare const cursorUp: VisualCursorCommand;
@@ -562,43 +657,57 @@ export declare const cursorUp: VisualCursorCommand;
  * Owns the blinking cursor DOM element.
  *
  * The rendering pipeline is a single `derived` whose compute callback
- * asks the {@link VisualLineMap} for the caret rect at the current
- * offset, writes it to {@link element}, and returns a
+ * asks the {@link VisualLineMap} for the caret rect at the current source or
+ * virtual position, writes it to {@link element}, and returns a
  * {@link CursorViewRendering} value as proof. An autorun keeps the
  * derived subscribed.
  */
 export declare class CursorView extends Disposable {
-    private readonly _parent;
     readonly element: HTMLElement;
     readonly rendering: IObservable<CursorViewRendering>;
-    constructor(_parent: HTMLElement, options: CursorViewOptions);
+    constructor(options: CursorViewOptions);
 }
 
 export declare interface CursorViewOptions {
-    readonly offset: IObservable<SourceOffset | undefined>;
+    readonly position: IObservable<CursorPosition | undefined>;
     readonly visualLineMap: IObservable<VisualLineMap>;
     /**
-     * When set, the caret is drawn over the transient empty paragraph instead
-     * of at {@link offset} — its rect (in client coordinates) comes straight
-     * from that synthetic element's geometry, since it has no visual-line-map
-     * entry. Takes priority over the normal offset-based placement.
+     * The mounted blocks, used to hide the caret when it sits at an offset that
+     * has been scrolled out of its (horizontally scrolling) block's viewport —
+     * matching how the selection is clipped there.
      */
-    readonly pendingCaretRect?: IObservable<Rect2D | undefined>;
+    readonly blocks?: IObservable<readonly SelectionBlock[]>;
 }
 
 export declare class CursorViewRendering {
-    readonly offset: SourceOffset;
+    readonly position: CursorPosition;
     readonly visible: boolean;
     readonly rect: Rect2D;
-    constructor(offset: SourceOffset, visible: boolean, rect: Rect2D);
+    constructor(position: CursorPosition, visible: boolean, rect: Rect2D);
 }
 
+export declare const cursorVisualLineEnd: VisualCursorCommand;
+
+export declare const cursorVisualLineStart: VisualCursorCommand;
+
 export declare const cursorWordLeft: CursorCommand;
 
 export declare const cursorWordRight: CursorCommand;
 
+export declare const DEFAULT_INDENTATION_CONFIG: IndentationConfig;
+
+export declare const DEFAULT_WORD_NAVIGATION_CONFIG: WordNavigationConfig;
+
+export declare const DEFAULT_WORD_SEPARATORS = "`~!@#$%^&*()-=+[{]}\\|;:'\",.<>/?";
+
 export declare const deleteLeft: EditCommand;
 
+export declare const deleteLineLeft: EditCommand;
+
+export declare const deleteLineRight: EditCommand;
+
+export declare const deleteLines: EditCommand;
+
 export declare const deleteRight: EditCommand;
 
 export declare const deleteWordLeft: EditCommand;
@@ -768,7 +877,7 @@ declare class DocumentViewData {
 export declare class DocumentViewNode extends ViewNode {
     readonly blocks: readonly DocumentBlock[];
     /** The transient empty-paragraph element, when one is armed. */
-    readonly pendingElement?: HTMLElement | undefined;
+    readonly pendingParagraph?: PendingParagraphViewNode | undefined;
     static create(viewData: DocumentViewData, options: BlockViewOptions | undefined, previous: DocumentViewNode | undefined): DocumentViewNode;
     private constructor();
     /** The stable content element this document mounts its children into. */
@@ -790,6 +899,26 @@ export declare type EditCommand = (ctx: CursorCommandContext) => {
     readonly selection: Selection_2;
 } | undefined;
 
+export declare type EditKeyboardAction = 'deleteLeft' | 'deleteRight' | 'deleteWordLeft' | 'deleteWordRight' | 'deleteLineLeft' | 'deleteLineRight' | 'copyLinesUp' | 'copyLinesDown' | 'moveLinesUp' | 'moveLinesDown' | 'deleteLines' | 'joinLines';
+
+export declare interface EditorCommandDefinition {
+    readonly id: `markdown.editor.${string}`;
+    readonly title: string;
+    readonly action: EditorKeyboardAction;
+    readonly keybindings: readonly EditorCommandKeybinding[];
+    /**
+     * Local commands must execute synchronously in the webview instead of being
+     * forwarded through the VS Code keybinding service.
+     */
+    readonly routing?: 'host' | 'local';
+}
+
+export declare interface EditorCommandKeybinding {
+    readonly key: string;
+    readonly modifiers?: KeyboardModifiers;
+    readonly platforms?: readonly KeyboardPlatform[];
+}
+
 /**
  * Translates raw browser input (mouse, keyboard, EditContext) into model
  * mutations. Knows about DOM event types but never reads/writes the DOM
@@ -798,19 +927,48 @@ export declare type EditCommand = (ctx: CursorCommandContext) => {
  *
  * Owns the only non-derivable controller state:
  * - `_desiredColumn` — sticky column for up/down navigation
+ * - `_clickCount` / `_lastPointerDown` — multi-click detection for pointer
+ *   input, since `pointerdown` events (unlike `mousedown`) don't populate
+ *   `detail` with a click count.
  */
 export declare class EditorController extends Disposable {
     private readonly _model;
     private readonly _view;
+    readonly findController: FindController | undefined;
     private _desiredColumn;
+    private readonly _keyboardPlatform;
+    private readonly _keyboardProfile;
+    private readonly _forwardedKeyboardProfile;
+    private readonly _historyStrategy;
+    private readonly _indentation;
+    private readonly _tabFocusStatus;
+    private _tabMovesFocus;
+    /** Indentation copied by the most recent fenced-code Enter, while still untouched. */
+    private _generatedIndentation;
+    /** Running click count for the current multi-click sequence (1, 2, 3, …). */
+    private _clickCount;
+    /** Timestamp and position of the previous pointer-down, for multi-click detection. */
+    private _lastPointerDown;
+    /** Timestamp of the last locked-mode reveal caused by a pointer click. */
+    private _lastReadonlyClickRevealTime;
     constructor(_model: EditorModel, _view: EditorView, options?: EditorControllerOptions);
     private readonly _handleTextUpdate;
-    private readonly _handleMouseDown;
+    insertText(text: string, selectionOverride?: Selection_2): void;
+    private _insertText;
+    private _remainingGeneratedIndentation;
+    /** Handle typed, pasted, or command-generated text while a paragraph is pending. */
+    private _handlePendingInput;
+    private _deletePendingText;
+    private readonly _handlePointerDown;
     private _makeCursorContext;
     private _makeVisualCursorContext;
     private _executeCursorCommand;
     private _executeEditCommand;
+    private _runUndoableEdit;
     private _executeVisualCursorCommand;
+    private _cursorDown;
+    private _setUserSelection;
+    private _applyCursorPosition;
     /** Move the cursor down one visual line (Arrow Down). */
     cursorDown(extend?: boolean): void;
     /** Move the cursor up one visual line (Arrow Up). */
@@ -818,12 +976,34 @@ export declare class EditorController extends Disposable {
     private _selectedText;
     private readonly _updateModifierState;
     private readonly _clearModifierState;
+    /**
+     * Drop any native DOM selection over the rendered text.
+     *
+     * The editor paints selection from `model.selection`, so a browser
+     * selection there is always spurious: nothing reads it (copy/cut read the
+     * model, hit-testing uses the measured layout) and nothing clears it, so it
+     * lingers as a second highlight even after the caret moves away.
+     * {@link isCaretMotionKey} stops the common source synchronously; this is
+     * the backstop for the rest of the browser's editing commands, which are
+     * platform- and version-specific and cannot be enumerated (Shift+PageDown
+     * and macOS Shift+Ctrl+B both reach one today).
+     *
+     * Scoped twice so it only ever discards selections the editor owns: the
+     * range must touch the rendered text (overlays such as comment widgets sit
+     * beside it and stay selectable), and input focus must still be inside this
+     * editor (so a host find-in-page, which selects while its own input is
+     * focused, is left alone).
+     */
+    private readonly _discardNativeSelection;
     private readonly _handleKeyDown;
+    executeCommand(command: EditorCommandDefinition): void;
+    private _executeKeyboardAction;
     /**
      * Context-aware Enter: splits / line-breaks via {@link insertSmartEnter}, or
      * arms a transient empty paragraph when at the end of a paragraph.
      */
     private _smartEnter;
+    private _registerTabFocusAccessibility;
 }
 
 /** Options for an {@link EditorController}. */
@@ -834,10 +1014,81 @@ export declare interface EditorControllerOptions {
      * strategy (e.g. `AsyncClipboardStrategy`) in hosts that swallow them.
      */
     readonly clipboardStrategy?: IClipboardStrategy;
+    /**
+     * Where undo and redo are executed: `LocalHistoryStrategy` for a
+     * self-contained editor, or a strategy that forwards to the host's own
+     * document history. Left unset, the chords are passed on to the host.
+     */
+    readonly historyStrategy?: IHistoryStrategy;
+    readonly keyboardPlatform?: KeyboardPlatform;
+    readonly keyboardProfile?: KeyboardProfile;
+    /**
+     * Bindings owned by the host. Matching events have their browser default
+     * suppressed but continue propagating so the host keybinding service sees them.
+     */
+    readonly forwardedKeyboardProfile?: KeyboardProfile;
+    /** Tab-stop settings used outside semantic list indentation. */
+    readonly indentation?: IndentationConfig;
+    readonly find?: false;
 }
 
+/**
+ * The editor overlay's local CSS-pixel coordinate space.
+ *
+ * Browser geometry and pointer APIs expose viewport client coordinates. This
+ * boundary converts them immediately into the coordinate system shared by the
+ * editor content and its overlays. Range rectangles are axis-aligned, so the
+ * current implementation deliberately supports positive axis-aligned scale and
+ * translation only.
+ */
+export declare class EditorCoordinateSpace {
+    private readonly _getLocalToClientMatrix;
+    static forSvgOverlay(overlay: SVGSVGElement): EditorCoordinateSpace;
+    private constructor();
+    capture(): EditorCoordinateTransform;
+}
+
+/** A stable coordinate conversion captured for one measurement operation. */
+export declare class EditorCoordinateTransform {
+    private readonly _localToClient;
+    private readonly _clientToLocal;
+    constructor(_localToClient: DOMMatrix);
+    toLocalPoint(point: Pick<Point2D, 'x' | 'y'>): Point2D;
+    toClientPoint(point: Pick<Point2D, 'x' | 'y'>): Point2D;
+    toLocalRect(rect: Pick<DOMRectReadOnly, 'left' | 'top' | 'width' | 'height'>): Rect2D;
+    toClientRect(rect: Pick<Rect2D, 'left' | 'top' | 'width' | 'height'>): Rect2D;
+    private _convertRect;
+}
+
+export declare type EditorKeyboardAction = {
+    readonly kind: 'cursor';
+    readonly command: CursorKeyboardAction;
+    readonly extend: boolean;
+} | {
+    readonly kind: 'edit';
+    readonly command: EditKeyboardAction;
+} | {
+    readonly kind: 'history';
+    readonly command: HistoryKeyboardAction;
+} | {
+    readonly kind: 'tab';
+    readonly command: TabKeyboardAction;
+} | {
+    readonly kind: 'toggleTabFocus';
+} | {
+    readonly kind: 'toggleReadonly';
+} | {
+    readonly kind: 'selectAll';
+} | {
+    readonly kind: 'enter';
+    readonly command: 'smartEnter' | 'insertParagraph' | 'insertHardLineBreak';
+};
+
 export declare class EditorModel {
     private readonly _parser;
+    private readonly _sourceEditListeners;
+    private readonly _sourceTextIds;
+    private _lastSourceTextId;
     /**
      * The most recent edit applied to {@link sourceText}, used by
      * {@link document} to let the parser link incrementally edited code
@@ -846,21 +1097,18 @@ export declare class EditorModel {
      */
     private _pendingEdit;
     readonly sourceText: ISettableObservable<StringValue, void>;
-    /**
-     * Read-only mode. When `true`, the editor never reveals a block's source
-     * markers (markdown special characters like `**`, `#`, list bullets, code
-     * fences, `$…$`) — every block stays in its clean rendered form regardless
-     * of where the caret/selection is — and source-mutating edits are ignored.
-     * Plain text selection still works everywhere (so the user can copy). The
-     * default (`false`) is the normal editing mode where the active block
-     * reveals its markers.
-     */
+    readonly wordNavigationConfig: ISettableObservable<WordNavigationConfig, void>;
+    /** Disables text editing, independently of parsing, layout and markup visibility. */
     readonly readonlyMode: ISettableObservable<boolean, void>;
+    readonly presentation: ISettableObservable<EditorPresentation, void>;
+    readonly renderMarkupText: ISettableObservable<RenderMarkupText, void>;
+    readonly presentationPolicy: IObservableWithChange<PresentationPolicy, void>;
     /**
      * The current selection, or `undefined` when the editor has no caret
      * (e.g. an inactive/unfocused rendering).
      */
     readonly selection: ISettableObservable<Selection_2 | undefined, void>;
+    readonly selectionSource: ISettableObservable<SelectionSource, void>;
     /**
      * Whether a Ctrl/Cmd modifier is currently held. Set by the controller from
      * live keyboard state; the view reads it to show the link-open affordance
@@ -868,6 +1116,14 @@ export declare class EditorModel {
      * whose block is active.
      */
     readonly ctrlOrMetaDown: ISettableObservable<boolean, void>;
+    /**
+     * Whether a pointer-driven selection drag is currently in progress. Set by
+     * the controller between the pointer-down that starts the drag and the
+     * pointer-up/cancel that ends it. Contributions read it to defer UI that
+     * would otherwise flicker mid-drag (e.g. the comment input box appears only
+     * once the drag ends).
+     */
+    readonly isSelecting: ISettableObservable<boolean, void>;
     /**
      * Gutter markers (source-control style change indicators) painted in the
      * left gutter. Each entry maps a source {@link OffsetRange} to a change kind
@@ -887,16 +1143,19 @@ export declare class EditorModel {
      * The transient empty-paragraph editing state, or `undefined` when none is
      * armed. See {@link PendingParagraph}. This is *not* document data — it is
      * cleared by any source edit and lives only between the Enter that armed it
-     * and the next keystroke.
+     * and the next content-producing edit.
      */
     readonly pendingParagraph: ISettableObservable<PendingParagraph | undefined, void>;
+    /** Switches between editing and locked mode and clears transient edit intent. */
+    toggleReadonlyMode(): void;
     readonly cursorOffset: IObservableWithChange<number | undefined, void>;
+    readonly cursorPosition: IObservableWithChange<CursorPosition | undefined, void>;
     /**
      * The parsed document. Threads the previous document into the parser so
      * unchanged blocks keep their object identity across reparses (see
      * {@link MarkdownParser.parse}). Writing `previous` inside the compute is
-     * a safe optimization: `derived` only recomputes when `sourceText`
-     * changes, and the result is structurally identical to a full reparse.
+     * safe: unchanged source reuses it directly, while changed source produces
+     * a result structurally identical to a full reparse.
      */
     readonly document: IObservableWithChange<DocumentAstNode, void>;
     /**
@@ -932,26 +1191,56 @@ export declare class EditorModel {
     insertedRanges: OffsetRange[];
     changedBlocks: Set<BlockAstNode>;
     } | undefined, void>;
+    readonly markerVisibleBlocks: IObservableWithChange<Set<BlockAstNode>, void>;
+    getMarkupSelectionRange(selectionRange: OffsetRange | undefined, reader?: IReader): OffsetRange | undefined;
+    onWillApplySourceEdit(listener: (event: SourceEditEvent) => void): IDisposable;
+    /** Returns a stable per-object identity without retaining the source text. */
+    getSourceTextId(sourceText: StringValue): number;
     /**
      * Arm a {@link PendingParagraph} at the given gap, minting a fresh synthetic
      * AST node for it, and park the caret at the gap start. No source edit is
      * applied — the blank line exists only in the view until it is materialized.
      */
-    armPendingParagraph(req: {
-        anchorBlock: BlockAstNode;
-        replaceRange: OffsetRange;
-        atEof: boolean;
-    }): void;
+    armPendingParagraph(req: Omit<PendingParagraph, 'syntheticAst' | 'cursorLine' | 'text'>): void;
     /** Discard the pending paragraph (if any) without touching the source. */
     cancelPendingParagraph(): void;
+    /**
+     * Replace the source with an authoritative value from the host, mapping the
+     * selection through the changed span and atomically discarding transient
+     * state anchored to the previous parse.
+     */
+    replaceSourceText(text: StringValue): void;
+    /** Replace the transient horizontal whitespace on the pending line. */
+    setPendingParagraphText(text: string): void;
     /**
      * Turn the pending paragraph into real source: rewrite its gap so the typed
-     * `text` becomes its own paragraph, separated from its neighbours by blank
-     * lines, and place the caret after the inserted text.
+     * text, including any transient indentation, is separated from its neighbours
+     * by blank lines, and place the caret after it.
      */
     materializePendingParagraph(text: string): void;
-    applyEdit(edit: StringEdit): void;
+    /** Sets a rendered task checkbox state in either editing or read-only mode. */
+    setTaskCheckboxChecked(item: ListItemAstNode, checked: boolean): void;
+    applyEdit(edit: StringEdit, selection?: Selection_2): void;
     applyEditForSelection(edit: StringEdit): void;
+    private _applySourceEdit;
+    private _identifySourceEdit;
+    private _emitWillApplySourceEdit;
+}
+
+export declare type EditorOverlayPosition = 'top-chrome' | 'below-selection' | 'above-decorations';
+
+export declare type EditorPresentation = 'reading' | 'editing';
+
+/** Text updates and browser attachment are separate so hosts can supply a local transport. */
+declare interface EditorTextInput {
+    readonly context: EditorTextInputContext;
+    readonly nativeContext: IObservable<EditContext | null>;
+}
+
+declare interface EditorTextInputContext extends EventTarget {
+    readonly text: string;
+    updateText(start: number, end: number, text: string): void;
+    updateSelection(start: number, end: number): void;
 }
 
 /**
@@ -981,8 +1270,13 @@ export declare class EditorView extends Disposable {
     private readonly _model;
     private readonly _options?;
     readonly element: HTMLElement;
-    readonly editContext: EditContext;
+    readonly editContext: EditorTextInputContext;
+    private readonly _nativeEditContext;
     readonly measuredLayout: MeasuredLayoutModel;
+    readonly coordinateSpace: EditorCoordinateSpace;
+    readonly forcedMarkerVisibleBlocks: ISettableObservable<ReadonlySet<BlockAstNode>, void>;
+    readonly showReadonlyToggle: ISettableObservable<boolean, void>;
+    readonly highlightActiveBlock: ISettableObservable<boolean, void>;
     /**
      * Inner container that holds the rendered document and the cursor/selection
      * overlays. The outer {@link element} spans the full width; this container
@@ -990,10 +1284,18 @@ export declare class EditorView extends Disposable {
      * to their parent's box) stay aligned with the content.
      */
     private readonly _contentContainer;
+    private readonly _resizeObserver;
     private readonly _cursorView;
     private readonly _selectionView;
     private readonly _gutterMarkersView;
     private readonly _diffHighlightsView;
+    private _readonlyToggleButton;
+    private readonly _editContextSuspensions;
+    private readonly _revealOcclusions;
+    private _pendingTopReveal;
+    private _caretRevealRaf;
+    private _followedCaretBlock;
+    private _followCaretAfterEdit;
     /**
      * The mounted block sequence, in source order. Rebuilt (not mutated) each
      * frame by {@link DocumentViewNode.create}; the view just swaps one
@@ -1001,8 +1303,17 @@ export declare class EditorView extends Disposable {
      * (those go through the measured-layout model).
      */
     private readonly _document;
+    private readonly _embeddedCodeEditorFactoryVersion;
+    private readonly _suspendEditContextForBlockControl;
+    private _clipboardWriter;
+    private readonly _writeClipboardText;
+    /** Connects explicit copy actions to the controller's host clipboard strategy. */
+    setClipboardWriter(writeText: (text: string) => Promise<void>): IDisposable;
+    private _renderedSourceEditing;
     /** The current view-node tree (AST overlaid with rendered DOM), for debugging. */
     get documentViewNode(): IObservable<DocumentViewNode | undefined>;
+    /** Re-resolves embedded code editors while preserving the surrounding editor view. */
+    refreshEmbeddedCodeEditors(): void;
     /**
      * Last frame's view-data overlay, threaded back into
      * {@link buildDocumentViewData} so any subtree whose ast and selection flags
@@ -1014,12 +1325,15 @@ export declare class EditorView extends Disposable {
     private readonly _viewData;
     get viewData(): IObservable<DocumentViewData | undefined>;
     /**
-     * Caret rect (client coords) for the transient empty paragraph, or
-     * `undefined` when none is armed. Set each frame from the synthetic
-     * paragraph element's geometry and fed to the {@link CursorView}, which has
-     * no visual-line-map entry to place the caret from otherwise.
+     * 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 _pendingCaretRect;
+    private readonly _focused;
+    get focused(): IObservable<boolean>;
     /**
      * The block cache projected for views (selection painting) that need to
      * react to mount/unmount. Derived from {@link _document}, so it stays in
@@ -1050,6 +1364,7 @@ export declare class EditorView extends Disposable {
      */
     rangeRects(range: OffsetRange): IObservable<readonly SelectionRect[]>;
     constructor(_model: EditorModel, _options?: EditorViewOptions | undefined);
+    private _setupEmptyDocumentSelection;
     /**
      * Mirrors the model's live Ctrl/Cmd state onto the editor root as
      * `.md-mod-down` so CSS can show the link-open underline and pointer cursor
@@ -1058,34 +1373,109 @@ export declare class EditorView extends Disposable {
      */
     private _setupModifierTracking;
     /**
-     * Renders the edit/read-only lock toggle. It flips the model's
-     * {@link EditorModel.readonlyMode}: when locked (read-only) every block stays
+     * 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;
+    private _setupCaretScrollPadding;
+    /**
+     * Renders the locked/rich/source editing mode toggle. When locked every block stays
      * in its clean rendered form (no markdown markers revealed) and edits are
      * ignored, while text selection still works. The control lives in a
-     * zero-height *sticky* host so the lock stays pinned to the top-right corner
-     * of the scroll container as the document scrolls. The current mode is also
-     * mirrored onto the root as `.md-readonly` for any CSS hooks.
+     * zero-height sticky host, using the right margin when it fits and
+     * overlapping content when narrow, without changing the document's geometry.
+     * The current mode is also mirrored onto the root as `.md-readonly`
+     * for any CSS hooks.
      */
     private _setupReadonlyToggle;
+    /** Draws attention to the mode toggle after text input is attempted while locked. */
+    showReadonlyEditingAttempt(): void;
     focus(): void;
-    /**
-     * Opt-in "own" point→offset resolution (a debug/experimental flag). When
-     * `false` (default), {@link resolveOffsetFromPoint} uses the platform DOM
-     * hit-test (`caretPositionFromPoint`). When `true`, it ignores the DOM
-     * hit-test and snaps the point to the nearest offset purely from the
-     * rendered {@link VisualLineMap} geometry — picking the nearest visual line
-     * by `y`, then the nearest offset on it by `x`. Because a table row's cells
-     * share one horizontal line band, this makes the whole width of a row
-     * resolve into that row (rather than only the cell boxes), with no visible
-     * layout change.
-     */
-    readonly geometricHitTest: ISettableObservable<boolean, void>;
+    mountOverlay(element: HTMLElement | SVGSVGElement, position: EditorOverlayPosition): IDisposable;
+    /** Registers floating editor chrome that should count as covering a range during reveal. */
+    registerRevealOcclusion(element: Element): IDisposable;
+    /**
+     * Temporarily detaches the root {@link EditContext} while focus is inside
+     * nested editor chrome. Chromium otherwise reclaims focus from non-text
+     * controls inside the EditContext host, breaking keyboard access to controls
+     * such as the find actions and read-only toggle.
+     */
+    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
+     * scrolling so ordinary typing only moves the containing viewport as far as
+     * needed. While this mode is active, a later resize of the same active block
+     * also re-reveals the caret (for asynchronous code, math, or diagram layout).
+     */
+    revealCaretAfterEdit(): void;
+    /** Keeps a keyboard-moved caret visible without enabling edit-resize following. */
+    revealCaretAfterKeyboardNavigation(): void;
+    /** Stops edit-driven caret following before pointer-based selection begins. */
+    stopFollowingCaret(): void;
+    /**
+     * 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;
     /**
      * Client coordinates → absolute source offset (any block). Used during
      * drag to keep extending the selection even when the pointer leaves the
-     * original block. Honours {@link geometricHitTest}.
+     * original block. Snaps to the nearest visual line and source offset.
      */
     resolveOffsetFromPoint(point: Point2D): SourceOffset | undefined;
+    resolveCursorPositionFromPoint(point: Point2D): SourceCursorPosition | undefined;
+    private _resolveControlFreeVideoOffset;
+    /**
+     * Resolve table-cell hits that have no measurable text run. Empty cells map
+     * from their own box instead of snapping to a neighboring cell; element-only
+     * content (for example an inactive image) maps through the hit element's view
+     * node. Text-bearing cells keep the normal pixel-precise line-map path.
+     */
+    private _resolveTableCellOffset;
     /**
      * Whether a client point falls on the rendered document content, as
      * opposed to the surrounding editor padding (the green area). Uses DOM
@@ -1095,6 +1485,14 @@ export declare class EditorView extends Disposable {
      * have `pointer-events: none`, so the hit-test sees through them.
      */
     isPointInContent(point: Point2D): boolean;
+    /**
+     * Whether `range` intersects the rendered source text — the region whose
+     * selection this editor paints itself from `model.selection`. This also
+     * catches select-all ranges whose endpoints surround the rendered content.
+     * Overlays anchored beside the text (comment widgets and the like) are *not*
+     * part of it and keep their own native selection behaviour.
+     */
+    intersectsRenderedContent(range: Range): boolean;
     private readonly _renderAutorun;
     /** Current mounted blocks, or empty before the first render. */
     private get _blocks();
@@ -1113,9 +1511,46 @@ export declare class EditorView extends Disposable {
      */
     private _paintDiff;
     private _clearDiff;
+    private _syncEditContextAttachment;
+    private _revealRange;
+    private _revealTarget;
+    private _scheduleCaretReveal;
+    private _revealCaretNearest;
+    private _revealCaretAfterActiveBlockResize;
+    private _caretBlockAt;
+    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 {
+    readonly presentation?: EditorPresentation;
+    readonly textInput?: EditorTextInput;
     /**
      * Extra class names added to the editor root element, e.g. a theme class
      * such as `'md-theme-default'` or `'github-markdown-theme'`. Theme styles
@@ -1123,6 +1558,14 @@ export declare interface EditorViewOptions extends BlockViewOptions {
      * only) unless a theme class is supplied.
      */
     readonly classNames?: readonly string[];
+    /**
+     * Whether to render the 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).
+     */
+    readonly showReadonlyToggle?: boolean;
+    /** Whether to paint the active block's background and glow. Defaults to `true`. */
+    readonly highlightActiveBlock?: boolean;
     /**
      * Controls "limited width mode". The observable yields the maximum content
      * width in pixels, or `undefined` to let the content fill the available
@@ -1145,10 +1588,10 @@ export declare interface EditorViewOptions extends BlockViewOptions {
 
 export declare class EmphasisAstNode extends AstNode {
     readonly openMarker: MarkerAstNode;
-    readonly content: readonly (InlineAstNode | GlueAstNode)[];
+    readonly content: readonly InlineContentAstNode[];
     readonly closeMarker: MarkerAstNode;
     readonly kind = "emphasis";
-    constructor(openMarker: MarkerAstNode, content: readonly (InlineAstNode | GlueAstNode)[], closeMarker: MarkerAstNode);
+    constructor(openMarker: MarkerAstNode, content: readonly InlineContentAstNode[], closeMarker: MarkerAstNode);
     get children(): readonly AstNode[];
     mapChildren(m: ReadonlyMap<AstNode, AstNode>): AstNode;
 }
@@ -1160,6 +1603,129 @@ declare class EmphasisViewData {
     constructor(ast: EmphasisAstNode, content: readonly AnyViewData[]);
 }
 
+/** One blank source line, or the empty final line after a terminating newline. */
+export declare class EmptyBlockAstNode extends BlockAstNodeBase {
+    readonly content: readonly GlueAstNode[];
+    readonly leadingTrivia?: GlueAstNode | undefined;
+    readonly kind = "emptyBlock";
+    constructor(content: readonly GlueAstNode[], leadingTrivia?: GlueAstNode | undefined);
+    get children(): readonly AstNode[];
+    mapChildren(m: ReadonlyMap<AstNode, AstNode>): AstNode;
+    withLeadingTrivia(trivia: GlueAstNode | undefined): EmptyBlockAstNode;
+}
+
+declare class EmptyBlockViewData {
+    readonly ast: EmptyBlockAstNode;
+    readonly content: readonly AnyViewData[];
+    readonly kind = "emptyBlock";
+    constructor(ast: EmptyBlockAstNode, content: readonly AnyViewData[]);
+}
+
+export declare function escapeFindRegex(value: string): string;
+
+export declare const FIND_MATCH_LIMIT = 19999;
+
+export declare function findBlockAtOffset(doc: DocumentAstNode, offset: SourceOffset): BlockAstNode | undefined;
+
+export declare class FindController extends Disposable {
+    private readonly _editorModel;
+    private readonly _view;
+    private readonly _options;
+    readonly model: FindModel;
+    readonly widget: FindWidget;
+    private readonly _selectionForScope;
+    private _forcedMatch;
+    private _selectedMatch;
+    private _observedSourceTextId;
+    private readonly _sourceEditTracker;
+    private _revealRequest;
+    constructor(_editorModel: EditorModel, _view: EditorView, _options: FindControllerOptions);
+    private _setForcedMarkerVisibleBlocks;
+    openAndFocus(): void;
+    close(): void;
+    private _handleKeyDown;
+    private _cancelRevealRequest;
+    private _findByKeyboard;
+    private _querySeed;
+    private _prepareSeed;
+    private _selectedSingleLineText;
+    private _toggleFindInSelection;
+}
+
+export declare interface FindControllerOptions {
+    readonly keyboardPlatform: KeyboardPlatform;
+}
+
+export declare type FindDirection = 'next' | 'previous';
+
+export declare class FindHighlightsView extends Disposable {
+    private readonly _view;
+    private readonly _matchesLayer;
+    private readonly _currentLayer;
+    private readonly _highlightRegistration;
+    private readonly _resizeObserver;
+    private readonly _resizeObservedElements;
+    private _snapshot;
+    private _paintRaf;
+    constructor(_view: EditorView, findModel: FindModel);
+    private _schedulePaint;
+    private _paint;
+    private _observeResizeAncestors;
+    private _paintRanges;
+}
+
+export declare interface FindMatchesResult {
+    readonly matches: readonly OffsetRange[];
+    readonly isCapped: boolean;
+}
+
+export declare class FindModel extends Disposable {
+    private readonly _editorModel;
+    readonly isRevealed: ISettableObservable<boolean, void>;
+    readonly searchString: ISettableObservable<string, void>;
+    readonly isRegex: ISettableObservable<boolean, void>;
+    readonly matchCase: ISettableObservable<boolean, void>;
+    readonly wholeWord: ISettableObservable<boolean, void>;
+    readonly searchScope: ISettableObservable<OffsetRange | undefined, void>;
+    readonly currentMatch: ISettableObservable<OffsetRange | undefined, void>;
+    readonly loop: ISettableObservable<boolean, void>;
+    readonly searchResult: IObservableWithChange<    {
+    kind: "invalid";
+    error: Error;
+    pattern?: undefined;
+    matches?: undefined;
+    isCapped?: undefined;
+    } | {
+    kind: "valid";
+    pattern: FindPattern;
+    matches: readonly OffsetRange[];
+    isCapped: boolean;
+    error?: undefined;
+    }, void>;
+    readonly matchesCount: IObservableWithChange<number, void>;
+    readonly isCapped: IObservableWithChange<boolean, void>;
+    readonly currentMatchPosition: IObservableWithChange<number, void>;
+    private _searchOrigin;
+    private readonly _sourceEditTracker;
+    private _pendingInitialDirection;
+    constructor(_editorModel: EditorModel);
+    reveal(options: {
+        readonly origin: number;
+        readonly searchString?: string;
+        readonly direction?: FindDirection;
+    }): void;
+    hide(): void;
+    setSearchOrigin(offset: number): void;
+    setSearchScope(scope: OffsetRange | undefined): void;
+    moveToNextMatch(): OffsetRange | undefined;
+    moveToPreviousMatch(): OffsetRange | undefined;
+    private _move;
+    private _selectFromOrigin;
+    private _mapStateThroughEdit;
+    private _inputSnapshot;
+    private _readInputSnapshot;
+}
+
 /**
  * Source offset (relative to `root`) of the node with `target`'s id, or
  * `undefined` when it is not in the tree. Ids are stable across edits, so this
@@ -1167,14 +1733,117 @@ declare class EmphasisViewData {
  */
 export declare function findNodeOffsetById(root: AstNode, target: AstNode): number | undefined;
 
-export declare function findWordAt(text: string, offset: number): {
+export declare class FindPattern {
+    private readonly _source;
+    private readonly _flags;
+    private readonly _wholeWord;
+    private readonly _wordSeparators;
+    readonly isEmpty: boolean;
+    private constructor();
+    static create(query: FindQuery): FindQueryResult;
+    findMatches(text: string, scope?: OffsetRange, limit?: number): FindMatchesResult;
+    findNextMatch(text: string, after: number, scope?: OffsetRange, loop?: boolean, skip?: OffsetRange): OffsetRange | undefined;
+    findPreviousMatch(text: string, before: number, scope?: OffsetRange, loop?: boolean, skip?: OffsetRange): OffsetRange | undefined;
+    private _forEachMatch;
+}
+
+export declare interface FindQuery {
+    readonly searchString: string;
+    readonly isRegex: boolean;
+    readonly matchCase: boolean;
+    readonly wholeWord: boolean;
+    readonly wordSeparators: string;
+}
+
+export declare type FindQueryResult = {
+    readonly kind: 'valid';
+    readonly pattern: FindPattern;
+} | {
+    readonly kind: 'invalid';
+    readonly error: Error;
+};
+
+export declare type FindSearchResult = {
+    readonly kind: 'valid';
+    readonly pattern: FindPattern;
+    readonly matches: readonly OffsetRange[];
+    readonly isCapped: boolean;
+} | {
+    readonly kind: 'invalid';
+    readonly error: Error;
+};
+
+export declare class FindWidget extends Disposable {
+    private readonly _view;
+    private readonly _options;
+    readonly element: HTMLElement;
+    readonly panelElement: HTMLElement;
+    readonly focused: ISettableObservable<boolean, void>;
+    private readonly _inputShell;
+    private readonly _input;
+    private readonly _matchesCount;
+    private readonly _previousButton;
+    private readonly _nextButton;
+    private readonly _selectionButton;
+    private readonly _caseButton;
+    private readonly _wholeWordButton;
+    private readonly _regexButton;
+    private readonly _error;
+    constructor(_view: EditorView, _options: FindWidgetOptions);
+    focusAndSelect(): void;
+    private _registerButton;
+    private _render;
+}
+
+export declare interface FindWidgetOptions {
+    readonly findModel: FindModel;
+    readonly canFindInSelection: IObservable<boolean>;
+    readonly onNext: () => void;
+    readonly onPrevious: () => void;
+    readonly onToggleFindInSelection: () => void;
+    readonly onClose: () => void;
+}
+
+export declare function findWordAt(text: string, offset: number, config?: WordNavigationConfig): {
     start: number;
     end: number;
 };
 
-export declare function findWordBoundaryLeft(text: string, offset: number): number;
+export declare function findWordBoundaryLeft(text: string, offset: number, config?: WordNavigationConfig): number;
+
+export declare function findWordBoundaryRight(text: string, offset: number, config?: WordNavigationConfig): number;
+
+export declare function findWordDeleteBoundaryLeft(text: string, offset: number, config?: WordNavigationConfig): number;
+
+export declare function findWordDeleteBoundaryRight(text: string, offset: number, config?: WordNavigationConfig): number;
+
+/**
+ * A leading YAML front matter block. The YAML value is intentionally opaque:
+ * only the two fences and the exact source between them are modeled.
+ */
+export declare class FrontMatterAstNode extends BlockAstNodeBase {
+    readonly content: readonly (MarkerAstNode | GlueAstNode)[];
+    readonly leadingTrivia?: GlueAstNode | undefined;
+    readonly kind = "frontMatter";
+    constructor(content: readonly (MarkerAstNode | GlueAstNode)[], leadingTrivia?: GlueAstNode | undefined);
+    get children(): readonly AstNode[];
+    get openFence(): MarkerAstNode | undefined;
+    get closeFence(): MarkerAstNode | undefined;
+    get value(): MarkerAstNode | undefined;
+    mapChildren(m: ReadonlyMap<AstNode, AstNode>): AstNode;
+    withLeadingTrivia(trivia: GlueAstNode | undefined): FrontMatterAstNode;
+}
 
-export declare function findWordBoundaryRight(text: string, offset: number): number;
+declare class FrontMatterViewData {
+    readonly ast: FrontMatterAstNode;
+    /** Active: render both fences; inactive: render only the opaque YAML value. */
+    readonly showMarkup: boolean;
+    readonly content: readonly AnyViewData[];
+    readonly kind = "frontMatter";
+    constructor(ast: FrontMatterAstNode, 
+    /** Active: render both fences; inactive: render only the opaque YAML value. */
+    showMarkup: boolean, content: readonly AnyViewData[]);
+}
 
 export declare function getAnnotatedSource(node: AstNode, source: string, offset?: number): string;
 
@@ -1197,6 +1866,8 @@ declare class GlueViewData {
      * block children) the break is already visible, so no `↵` is drawn.
      */
     readonly decorateNewline: boolean;
+    readonly showWhitespace: boolean;
+    readonly listContinuation?: ListContinuation | undefined;
     readonly kind = "glue";
     constructor(ast: GlueAstNode, visible: boolean, 
     /**
@@ -1205,7 +1876,7 @@ declare class GlueViewData {
      * the line ending hiding there; between block-level siblings (list items,
      * block children) the break is already visible, so no `↵` is drawn.
      */
-    decorateNewline: boolean);
+    decorateNewline: boolean, showWhitespace?: boolean, listContinuation?: ListContinuation | undefined);
 }
 
 /**
@@ -1234,10 +1905,10 @@ export declare type GutterMarkerType = 'added' | 'modified' | 'deleted';
 export declare class HeadingAstNode extends BlockAstNodeBase {
     readonly level: 1 | 2 | 3 | 4 | 5 | 6;
     readonly marker: MarkerAstNode;
-    readonly content: readonly (InlineAstNode | GlueAstNode)[];
+    readonly content: readonly InlineContentAstNode[];
     readonly leadingTrivia?: GlueAstNode | undefined;
     readonly kind = "heading";
-    constructor(level: 1 | 2 | 3 | 4 | 5 | 6, marker: MarkerAstNode, content: readonly (InlineAstNode | GlueAstNode)[], leadingTrivia?: GlueAstNode | undefined);
+    constructor(level: 1 | 2 | 3 | 4 | 5 | 6, marker: MarkerAstNode, content: readonly InlineContentAstNode[], leadingTrivia?: GlueAstNode | undefined);
     get children(): readonly AstNode[];
     mapChildren(m: ReadonlyMap<AstNode, AstNode>): AstNode;
     withLeadingTrivia(trivia: GlueAstNode | undefined): HeadingAstNode;
@@ -1251,6 +1922,19 @@ declare class HeadingViewData {
     constructor(ast: HeadingAstNode, content: readonly AnyViewData[]);
 }
 
+export declare function hiddenCursorRanges(doc: DocumentAstNode, markerVisibleBlocks: ReadonlySet<BlockAstNode>, selectionRange: OffsetRange): readonly OffsetRange[];
+
+export declare type HistoryKeyboardAction = 'undo' | 'redo';
+
+/** A block HTML comment, discriminated by whether its closing delimiter is present. */
+declare type HtmlCommentSource = OpenHtmlCommentSource | CompleteHtmlCommentSource;
+
+declare interface HtmlCommentSourceBase {
+    readonly leadingWhitespace: string;
+    readonly opening: '<!--';
+    readonly body: string;
+}
+
 /**
  * The editor operations a clipboard strategy drives. The strategy never
  * touches the model or the DOM directly — it asks through this seam, so the
@@ -1263,8 +1947,8 @@ export declare interface IClipboardContext {
     getSelectedText(): string | undefined;
     /** Delete the current selection (the cut half of cut). */
     deleteSelection(): void;
-    /** Insert text at the caret, replacing any selection (the paste action). */
-    insertText(text: string): void;
+    /** Paste text, linking a suitable selection when the payload is a URL unless plain text was requested. */
+    insertText(text: string, plainText?: boolean): void;
 }
 
 /**
@@ -1280,6 +1964,8 @@ export declare interface IClipboardContext {
  *   swallow the native clipboard events before they reach the editor.
  */
 export declare interface IClipboardStrategy {
+    /** Copy an explicit payload without changing the editor selection. Falls back to the browser API when omitted. */
+    writeText?(text: string): Promise<void>;
     /**
      * Wire up clipboard handling against `context`. The returned disposable
      * tears down every listener the strategy installed.
@@ -1287,9 +1973,6 @@ export declare interface IClipboardStrategy {
     connect(context: IClipboardContext): IDisposable;
 }
 
-/** A live rendering of a {@link CommentsModel}. Dispose to unmount it. */
-export declare type ICommentsPresenter = IDisposable;
-
 /** The Monarch language definitions the default highlighter wires up. */
 export declare interface IDefaultMonarchGrammars {
     typescript: unknown;
@@ -1299,6 +1982,91 @@ export declare interface IDefaultMonarchGrammars {
     python: unknown;
     rust: unknown;
     shell: unknown;
+    yaml: unknown;
+}
+
+/**
+ * A live editor embedded in place of a fenced code block's *rendered* form.
+ *
+ * This is the internal seam between the block view and a concrete embedded
+ * editor (e.g. an `<iframe>` speaking the web-editor protocol). The block view
+ * only speaks string edits: it pushes the block's content down via
+ * {@link setContent} and receives the editor's own changes back through
+ * {@link onEdit} (set by the block view on each (re)construction, so it always
+ * routes to the current AST node). The concrete implementation owns its DOM,
+ * transport, and lifecycle.
+ *
+ * A single instance is adopted across re-renders (like the highlighter session)
+ * so the underlying editor keeps its state across edits — see
+ * {@link CodeBlockViewNode}.
+ */
+declare interface IEmbeddedCodeEditor {
+    /** The element mounted as the block's rendered form. */
+    readonly element: HTMLElement;
+    /**
+     * Document → editor. The block's content changed (from any source). Must be
+     * idempotent: pushing the content the editor already holds is a no-op, which
+     * is how edits the editor itself originated are prevented from echoing back.
+     */
+    setContent(content: string): void;
+    /** Update whether the embedded editor may change its content. */
+    setReadOnly?(readOnly: boolean): void;
+    /** Mount host actions alongside the embedded editor's own presentation controls. */
+    setActions?(actions: HTMLElement): void;
+    /**
+     * Optional synchronous height (px) to reserve for `content` *before* the
+     * editor has laid out. Return `undefined` to let the editor size itself
+     * (the implementation may report its real height later). Lets a registration
+     * avoid a layout jump when it can cheaply estimate the size from content.
+     */
+    estimateHeight?(content: string): number | undefined;
+    /**
+     * Editor → document. Set by the block view on every (re)construction to
+     * route the editor's own edits, expressed in the block's *content*
+     * coordinates, to the current AST node.
+     */
+    onEdit?: (edit: StringEdit) => void;
+    dispose(): void;
+}
+
+/** Creates an {@link IEmbeddedCodeEditor} for a fenced block, or opts out. */
+declare interface IEmbeddedCodeEditorFactory {
+    /**
+     * Return an editor for a fenced block, or `undefined` to fall
+     * back to the default (highlighting / {@link BlockViewOptions.renderCustomCodeBlock}).
+     */
+    create(language: string, infoString: string, initialContent: string): IEmbeddedCodeEditor | undefined;
+    /** Reposition overlays after the document's layout has been measured. */
+    layout?(): void;
+}
+
+/**
+ * Routes undo and redo to whatever owns the document's history: the editor
+ * itself on a standalone page, or the enclosing document in a host like
+ * VS Code.
+ */
+export declare interface IHistoryStrategy {
+    undo(): void;
+    redo(): void;
+    /**
+     * Invoked around each source mutation so the strategy can record it.
+     * Implemented only by strategies that build their own history; a host that
+     * forwards edits to a VS Code `TextDocument` lets it record them instead.
+     */
+    record?(operation: () => void, edit?: StringEdit): void;
+}
+
+export declare interface ILinkPresentation extends IDisposable {
+    /** Current presentation, updated without rebuilding the editor. */
+    readonly presentation: IObservable<LinkPresentation | undefined>;
+}
+
+export declare interface ILinkPresentationProvider {
+    /**
+     * Returns `undefined` for unsupported links. The caller disposes the returned
+     * reference when the rendered link disappears.
+     */
+    createLinkPresentation(url: string): ILinkPresentation | undefined;
 }
 
 export declare class ImageAstNode extends AstNode {
@@ -1335,6 +2103,14 @@ export declare interface IMonarchApi {
     MonarchTokenizer: new (languageService: unknown, standaloneThemeService: unknown, languageId: string, lexer: unknown, configurationService: unknown) => MonarchTokenizer;
 }
 
+/** Controls tab-stop insertion and non-list line indentation. */
+export declare interface IndentationConfig {
+    /** Number of visual columns between tab stops. */
+    readonly tabSize: number;
+    /** Whether indentation uses spaces instead of tab characters. */
+    readonly insertSpaces: boolean;
+}
+
 export declare type InlineAstNode = TextAstNode | StrongAstNode | EmphasisAstNode | StrikethroughAstNode | InlineCodeAstNode | InlineMathAstNode | LinkAstNode | ImageAstNode;
 
 export declare class InlineCodeAstNode extends AstNode {
@@ -1352,6 +2128,8 @@ declare class InlineCodeViewData {
     constructor(ast: InlineCodeAstNode, content: readonly AnyViewData[]);
 }
 
+declare type InlineContentAstNode = InlineAstNode | MarkerAstNode | GlueAstNode;
+
 export declare class InlineMathAstNode extends AstNode {
     readonly content: readonly (MarkerAstNode | GlueAstNode)[];
     readonly kind = "inlineMath";
@@ -1389,17 +2167,29 @@ export declare const insertParagraph: EditCommand;
  *  - paragraph / heading / thematic break — the "rich text" thing: at the
  *    block's end arm a transient empty paragraph (see {@link SmartEnterResult});
  *    elsewhere split into two paragraphs (`\n\n`).
- *  - code block — insert a newline that preserves the current line's indentation,
- *    staying inside the fence.
+ *  - fenced code / front matter — insert a newline that preserves the current
+ *    line's indentation, staying inside the fences.
+ *  - video — leave the completed HTML block at its end; otherwise insert a
+ *    normal source line break.
  *  - block quote — continue the quote (`\n> `); an empty quote line exits it.
  *  - list — continue the list with the next marker (incrementing ordered
- *    numbers, re-emitting task checkboxes); an empty item exits the list.
+ *    numbers, re-emitting task checkboxes); an empty item outdents one level
+ *    before exiting the list.
+ *  - complete HTML comment — at the comment's end, leave it by arming a
+ *    transient paragraph; inside it (or while the comment is open), insert a
+ *    normal source line break.
  * A non-collapsed selection, or any other block, falls back to a plain soft line
  * break, preserving today's behaviour.
  */
-export declare const insertSmartEnter: (ctx: CursorCommandContext) => SmartEnterResult;
+export declare const insertSmartEnter: (ctx: CursorCommandContext, useSourceLineBreaks?: boolean) => SmartEnterResult;
 
-export declare function insertText(text: string): EditCommand;
+/**
+ * VS Code-style Tab: insert to the next tab stop for a caret or partial
+ * single-line selection, and indent every selected line for a line selection.
+ */
+export declare function insertTab(config?: IndentationConfig): EditCommand;
+
+export declare function insertText(text: string, generatedIndentation?: OffsetRange, completeFences?: boolean): EditCommand;
 
 /**
  * An immutable view of one document's tokens at a point in time. It may be a
@@ -1440,6 +2230,31 @@ export declare interface ISyntaxHighlighterDocument extends IDisposable {
     readonly snapshot: IObservableWithChange<ISyntaxHighlightedSnapshot, LengthEdit>;
 }
 
+export declare const joinLines: EditCommand;
+
+export declare interface KeyboardBinding {
+    readonly key: string;
+    readonly modifiers?: KeyboardModifiers;
+    readonly platforms?: readonly KeyboardPlatform[];
+    readonly action: EditorKeyboardAction;
+}
+
+export declare interface KeyboardModifiers {
+    readonly shift?: boolean;
+    readonly alt?: boolean;
+    readonly ctrl?: boolean;
+    readonly meta?: boolean;
+}
+
+export declare type KeyboardPlatform = 'macos' | 'windows' | 'linux';
+
+export declare interface KeyboardProfile {
+    /**
+     * Bindings in priority order. The first exact key/modifier/platform match wins.
+     */
+    readonly bindings: readonly KeyboardBinding[];
+}
+
 declare abstract class LeafAstNode extends AstNode {
     abstract readonly content: string;
     get children(): readonly AstNode[];
@@ -1488,27 +2303,64 @@ export declare class LengthReplacement {
 
 export declare class LinkAstNode extends AstNode {
     readonly url: string;
-    readonly content: readonly (MarkerAstNode | InlineAstNode | GlueAstNode)[];
+    readonly content: readonly InlineContentAstNode[];
+    readonly title?: string | undefined;
     readonly kind = "link";
-    constructor(url: string, content: readonly (MarkerAstNode | InlineAstNode | GlueAstNode)[]);
+    constructor(url: string, content: readonly InlineContentAstNode[], title?: string | undefined);
     get children(): readonly AstNode[];
     mapChildren(m: ReadonlyMap<AstNode, AstNode>): AstNode;
     protected _localEquals(o: this): boolean;
 }
 
+/**
+ * Declarative rendering data for one link. `kind` selects the package-owned
+ * visual treatment; providers never supply DOM or CSS.
+ */
+export declare interface LinkPresentation {
+    readonly kind: LinkPresentationKind;
+    readonly title?: string;
+    readonly detail?: string;
+    readonly reference?: string;
+    /** Primary resource state, such as pull-request lifecycle or session state. */
+    readonly status?: LinkPresentationStatus;
+    /** Secondary state, such as pull-request CI status. */
+    readonly secondaryStatus?: LinkPresentationStatus;
+    readonly changes?: LinkPresentationChanges;
+    readonly tooltip?: string;
+    readonly ariaLabel?: string;
+}
+
+declare interface LinkPresentationChanges {
+    readonly insertions: number;
+    readonly deletions: number;
+}
+
+export declare type LinkPresentationKind = 'resource' | 'issue' | 'pullRequest' | 'commit' | 'file' | 'folder' | 'session' | 'repository' | 'branch';
+
+export declare interface LinkPresentationStatus {
+    readonly kind: LinkPresentationStatusKind;
+    readonly label: string;
+}
+
+export declare type LinkPresentationStatusKind = 'neutral' | 'pending' | 'success' | 'warning' | 'error' | 'open' | 'closed' | 'merged' | 'draft' | 'notPlanned';
+
 declare class LinkViewData {
     readonly ast: LinkAstNode;
+    /** Active: render the Markdown source; inactive: allow a rich presentation. */
+    readonly showMarkup: boolean;
     readonly content: readonly AnyViewData[];
     readonly kind = "link";
-    constructor(ast: LinkAstNode, content: readonly AnyViewData[]);
+    constructor(ast: LinkAstNode, 
+    /** Active: render the Markdown source; inactive: allow a rich presentation. */
+    showMarkup: boolean, content: readonly AnyViewData[]);
 }
 
 export declare class ListAstNode extends BlockAstNodeBase {
     readonly ordered: boolean;
-    readonly content: readonly (ListItemAstNode | GlueAstNode)[];
+    readonly content: readonly (ListItemAstNode | EmptyBlockAstNode | GlueAstNode)[];
     readonly leadingTrivia?: GlueAstNode | undefined;
     readonly kind = "list";
-    constructor(ordered: boolean, content: readonly (ListItemAstNode | GlueAstNode)[], leadingTrivia?: GlueAstNode | undefined);
+    constructor(ordered: boolean, content: readonly (ListItemAstNode | EmptyBlockAstNode | GlueAstNode)[], leadingTrivia?: GlueAstNode | undefined);
     get children(): readonly AstNode[];
     get items(): readonly ListItemAstNode[];
     mapChildren(m: ReadonlyMap<AstNode, AstNode>): AstNode;
@@ -1516,6 +2368,14 @@ export declare class ListAstNode extends BlockAstNodeBase {
     protected _localEquals(o: this): boolean;
 }
 
+declare interface ListContinuation {
+    readonly item: ListItemAstNode;
+    readonly level: number;
+    readonly indentation: number;
+    readonly mixedTasks: boolean;
+    readonly outsideList: boolean;
+}
+
 export declare class ListItemAstNode extends AstNode {
     readonly marker: MarkerAstNode;
     readonly content: readonly (BlockAstNode | GlueAstNode)[];
@@ -1525,6 +2385,7 @@ export declare class ListItemAstNode extends AstNode {
     constructor(marker: MarkerAstNode, content: readonly (BlockAstNode | GlueAstNode)[], checked?: boolean | undefined, leadingTrivia?: GlueAstNode | undefined);
     get children(): readonly AstNode[];
     get blocks(): readonly BlockAstNode[];
+    get isIncomplete(): boolean;
     mapChildren(m: ReadonlyMap<AstNode, AstNode>): AstNode;
     withLeadingTrivia(trivia: GlueAstNode | undefined): ListItemAstNode;
     protected _localEquals(o: this): boolean;
@@ -1537,12 +2398,27 @@ declare class ListItemViewData {
     readonly content: readonly AnyViewData[];
     /** 1-based list nesting depth, used to size the indentation gutter. */
     readonly level: number;
+    /**
+     * Whether this is an inactive task item whose first paragraph begins
+     * with the `:running:` marker (see {@link TextViewData.hiddenPrefixLength}).
+     * Always `false` while the item is active — an active/editing task
+     * reveals the literal marker instead of the progress affordance.
+     */
+    readonly isRunning: boolean;
+    readonly sourceIndentation: number;
     readonly kind = "listItem";
     constructor(ast: ListItemAstNode, 
     /** Whether the selection reaches this item (reveals its markers). */
     isActive: boolean, content: readonly AnyViewData[], 
     /** 1-based list nesting depth, used to size the indentation gutter. */
-    level: number);
+    level: number, 
+    /**
+     * Whether this is an inactive task item whose first paragraph begins
+     * with the `:running:` marker (see {@link TextViewData.hiddenPrefixLength}).
+     * Always `false` while the item is active — an active/editing task
+     * reveals the literal marker instead of the progress affordance.
+     */
+    isRunning?: boolean, sourceIndentation?: number);
 }
 
 declare class ListViewData {
@@ -1552,6 +2428,41 @@ declare class ListViewData {
     constructor(ast: ListAstNode, content: readonly AnyViewData[]);
 }
 
+/**
+ * Compact in-memory history for editors that hold the only copy of the
+ * document, such as a standalone browser page. Where the surrounding host
+ * already records history — a VS Code `TextDocument` — forward to that
+ * instead.
+ */
+export declare class LocalHistoryStrategy implements IHistoryStrategy {
+    private readonly _model;
+    private readonly _past;
+    private readonly _future;
+    /**
+     * The source text as of the last change this strategy recorded or applied.
+     * Any other value means the document was replaced behind its back, so the
+     * stored edits no longer line up and must be discarded rather than applied.
+     */
+    private _lastKnownText;
+    constructor(_model: EditorModel);
+    record(operation: () => void, edit?: StringEdit): void;
+    undo(): void;
+    redo(): void;
+    /** The entry on top of `stack`, or `undefined` when it cannot be applied. */
+    private _peekApplicable;
+    private _apply;
+    private _clear;
+}
+
+export declare interface MarkdownParseOptions {
+    readonly explicitBlankLineBlocks?: boolean;
+    readonly explicitFinalEmptyLine?: boolean;
+    readonly preserveTrailingListContinuation?: boolean;
+    readonly allowEmptyListItemInterrupts?: boolean;
+    readonly requireListMarkerWhitespace?: boolean;
+    readonly allowEmptyTaskItems?: boolean;
+}
+
 /**
  * Parses markdown into a {@link DocumentAstNode}.
  *
@@ -1561,7 +2472,7 @@ declare class ListViewData {
  * blocks keep their incremental highlighting sessions.
  */
 export declare class MarkdownParser {
-    parse(text: StringValue, previous?: DocumentAstNode, edit?: StringEdit): DocumentAstNode;
+    parse(text: StringValue, previous?: DocumentAstNode, edit?: StringEdit, options?: MarkdownParseOptions): DocumentAstNode;
 }
 
 /** A semantic syntax marker (heading `#`, fences, brackets, list bullet, …). */
@@ -1658,8 +2569,8 @@ export declare class MeasuredLayoutDebugRendering {
  * Exposes two DOM nodes the caller can place independently:
  *
  *  - {@link overlayElement} — absolutely positioned; the caller mounts it
- *    inside the editor element so dashed line-bands and run-boxes line up
- *    with the editor's client coordinates.
+ *    inside the editor overlay container so dashed line-bands and run-boxes
+ *    share the measured editor-local coordinates.
  *  - {@link infoElement} — block-flow; the caller mounts it as a sibling
  *    *below* the editor. Contains the per-block summary table that used
  *    to live on the overlay.
@@ -1670,7 +2581,6 @@ export declare class MeasuredLayoutDebugRendering {
  * the derived subscribed.
  */
 export declare class MeasuredLayoutDebugView extends Disposable {
-    private readonly _overlayParent;
     readonly overlayElement: HTMLElement;
     readonly infoElement: HTMLElement;
     readonly rendering: IObservable<MeasuredLayoutDebugRendering>;
@@ -1683,6 +2593,7 @@ export declare class MeasuredLayoutDebugView extends Disposable {
 
 export declare interface MeasuredLayoutDebugViewOptions {
     readonly model: MeasuredLayoutModel;
+    readonly coordinateSpace: EditorCoordinateSpace;
     /**
      * DEBUG ONLY. Maps an absolute source offset to a fill color for that
      * character's glyph rect. The fixture passes the same function to the
@@ -1715,14 +2626,16 @@ export declare interface MeasuredLayoutDebugViewOptions {
  * through this model and never touches view fields directly.
  */
 export declare class MeasuredLayoutModel {
-    readonly measurements: ISettableObservable<readonly BlockMeasurement[], void>;
+    private readonly _measurements;
+    readonly measurements: IObservable<readonly BlockMeasurement[]>;
+    private readonly _virtualLines;
     /**
-     * Concatenated visual line map across all mounted blocks. Lines are
-     * left in DOM (client-coordinate) y order — each per-block map already
-     * uses absolute client coordinates from `getClientRects()`, so the
-     * concatenation is well-formed without re-sorting.
+     * Concatenated visual line map across all mounted blocks. Every per-block
+     * map uses the same editor-local coordinate space, so concatenation is
+     * well-formed without translation or re-sorting.
      */
     readonly visualLineMap: IObservableWithChange<VisualLineMap, void>;
+    setMeasurements(measurements: readonly BlockMeasurement[], virtualLines: readonly VirtualLineMeasurement[]): void;
 }
 
 /**
@@ -1751,6 +2664,15 @@ export declare class MonacoSyntaxHighlighter implements ISyntaxHighlighter {
     private _tokenizerFor;
 }
 
+export declare const moveLinesDown: EditCommand;
+
+export declare const moveLinesUp: EditCommand;
+
+export declare interface NativeClipboardData {
+    readonly text: string;
+    readonly files: readonly File[];
+}
+
 /**
  * Default strategy: handle the browser's native `copy`/`cut`/`paste` events,
  * reading and writing the synchronous {@link ClipboardEvent.clipboardData}.
@@ -1772,13 +2694,15 @@ declare interface NestedItem {
 }
 
 /**
- * Move the cursor one position left or right, skipping over hidden marker
+ * Move the cursor one position left or right, skipping over hidden source
  * ranges in inactive blocks (and inactive items of an active list).
  */
-export declare function nextCursorPosition(doc: DocumentAstNode, activeBlock: BlockAstNode | undefined, cursor: number, direction: 'left' | 'right'): number;
+export declare function nextCursorPosition(doc: DocumentAstNode, markerVisibleBlocks: ReadonlySet<BlockAstNode>, cursor: number, direction: 'left' | 'right', selectionRange?: OffsetRange): number;
 
 declare const NO_ACTIVE_BLOCKS: unique symbol;
 
+export declare function normalizeCursorPosition(doc: DocumentAstNode, markerVisibleBlocks: ReadonlySet<BlockAstNode>, cursor: number, target: number, direction: 'left' | 'right', includeHiddenRangeBoundary?: boolean, selectionRange?: OffsetRange): number;
+
 export declare class OffsetRange {
     readonly start: number;
     readonly endExclusive: number;
@@ -1806,11 +2730,19 @@ export declare class OffsetRange {
     toString(): string;
 }
 
+/** The lossless source slices of a block HTML comment whose closer has not been typed. */
+declare interface OpenHtmlCommentSource extends HtmlCommentSourceBase {
+    readonly kind: 'open';
+}
+
+/** Outdent the current line, or every line touched by the selection. */
+export declare function outdent(config?: IndentationConfig): EditCommand;
+
 export declare class ParagraphAstNode extends BlockAstNodeBase {
-    readonly content: readonly (InlineAstNode | GlueAstNode)[];
+    readonly content: readonly InlineContentAstNode[];
     readonly leadingTrivia?: GlueAstNode | undefined;
     readonly kind = "paragraph";
-    constructor(content: readonly (InlineAstNode | GlueAstNode)[], leadingTrivia?: GlueAstNode | undefined);
+    constructor(content: readonly InlineContentAstNode[], leadingTrivia?: GlueAstNode | undefined);
     get children(): readonly AstNode[];
     mapChildren(m: ReadonlyMap<AstNode, AstNode>): AstNode;
     withLeadingTrivia(trivia: GlueAstNode | undefined): ParagraphAstNode;
@@ -1824,23 +2756,32 @@ declare class ParagraphViewData {
 }
 
 /**
- * A *transient* editing state: the empty paragraph the user conjured by
- * pressing Enter at the end of a paragraph. Markdown has no empty-paragraph
- * node, so this never lives in {@link EditorModel.sourceText} or the parsed
- * {@link EditorModel.document} — it is pure edit intent that the view renders
- * as a synthetic blank line and that the controller either *materializes* (the
- * user types) or *cancels* (the user navigates away / backspaces).
+ * A *transient* editing state: an empty paragraph adjacent to a real block.
+ * Markdown has no empty-paragraph node, so this never lives in
+ * {@link EditorModel['sourceText']} or the parsed {@link EditorModel.document}
+ * — it is pure edit intent that the view renders as a synthetic blank line and
+ * that the controller either *materializes* (the user types) or *cancels* (the
+ * user navigates away / backspaces).
  */
 declare interface PendingParagraph {
-    /** The paragraph the blank line is rendered directly after. */
+    /** The block the blank line is rendered directly after. */
     readonly anchorBlock: BlockAstNode;
     /**
      * Source region rewritten when the pending paragraph is materialized — the
      * gap between {@link anchorBlock}'s text and whatever follows it.
      */
     readonly replaceRange: OffsetRange;
+    /** Whether materialized text needs a blank-line separator before it. */
+    readonly separateFromPreviousBlock: boolean;
     /** Whether {@link replaceRange} ends at the end of the document. */
     readonly atEof: boolean;
+    /**
+     * Horizontal whitespace typed on the source-less line. It remains transient
+     * until other input materializes the paragraph. Contains only spaces and tabs.
+     */
+    readonly text: string;
+    /** The source-less visual line occupied by the pending caret. */
+    readonly cursorLine: VirtualCursorLine;
     /**
      * A throwaway AST node that exists only to give the synthetic view child a
      * stable identity across render frames (the view pairs nodes by `ast.id`).
@@ -1849,21 +2790,51 @@ declare interface PendingParagraph {
     readonly syntheticAst: ParagraphAstNode;
 }
 
+declare interface PendingParagraphResult {
+    readonly kind: 'pending';
+    readonly anchorBlock: BlockAstNode;
+    readonly replaceRange: OffsetRange;
+    /** Whether materialized text needs a blank-line separator before it. */
+    readonly separateFromPreviousBlock: boolean;
+    readonly atEof: boolean;
+}
+
 /**
  * View-data for the transient empty paragraph (see `PendingParagraph` in the
- * model). It carries only the throwaway {@link ParagraphAstNode} that gives the
- * rendered blank line a stable identity across frames; it has no content and is
- * never measured or part of the selection geometry — the caret is positioned
- * over it via a dedicated rect, not via the visual-line map.
+ * model). It carries the throwaway {@link ParagraphAstNode} that gives the
+ * rendered line a stable identity across frames, its anchor block, source-less
+ * cursor line, and transient horizontal whitespace. It has no source content or
+ * selection range.
  */
 declare class PendingParagraphViewData {
     readonly ast: ParagraphAstNode;
+    readonly anchorBlock: BlockAstNode;
+    readonly cursorLine: VirtualCursorLine;
+    readonly text: string;
     readonly kind = "pendingParagraph";
-    constructor(ast: ParagraphAstNode);
+    constructor(ast: ParagraphAstNode, anchorBlock: BlockAstNode, cursorLine: VirtualCursorLine, text: string);
+}
+
+/**
+ * The mounted transient empty paragraph: a `<p class="md-pending-paragraph">`
+ * holding either a `<br>` or decorated transient horizontal whitespace. It is a
+ * leaf view node with no inline source content; the document view publishes its
+ * element geometry as a virtual visual line.
+ */
+declare class PendingParagraphViewNode extends ViewNode {
+    readonly element: HTMLElement;
+    readonly anchorBlock: BlockAstNode;
+    readonly cursorLine: VirtualCursorLine;
+    private _text;
+    constructor(view: PendingParagraphViewData);
+    update(text: string): void;
+    getCaretClientRect(): DOMRect;
 }
 
 /**
- * Immutable point in 2D space, in CSS-pixel client coordinates.
+ * Immutable point in a caller-defined 2D CSS-pixel coordinate space.
+ * Coordinate-owning APIs must document whether values are viewport-client or
+ * editor-local; values from different spaces must not be mixed.
  */
 export declare class Point2D {
     readonly x: number;
@@ -1873,9 +2844,25 @@ export declare class Point2D {
     translate(dx: number, dy: number): Point2D;
 }
 
+export declare const presentationPolicies: Readonly<Record<EditorPresentation, PresentationPolicy>>;
+
+declare interface PresentationPolicy {
+    readonly parseOptions: MarkdownParseOptions;
+    readonly preserveSourceWhitespace: boolean;
+    readonly useSourceLineBreaks: boolean;
+}
+
+/**
+ * Read native clipboard formats through an editable target. Electron can expose
+ * file clipboard entries here that navigator.clipboard.read() omits. EditContext
+ * roots themselves do not receive execCommand('paste') events.
+ * Returns undefined when the host does not support native programmatic paste.
+ */
+export declare function readNativeClipboard(focusTarget: HTMLElement, executePaste?: () => void): NativeClipboardData | undefined;
+
 /**
- * Immutable axis-aligned rectangle in 2D space, in CSS-pixel client
- * coordinates. `x`/`y` is the top-left corner, growing right/down.
+ * Immutable axis-aligned rectangle in a caller-defined 2D CSS-pixel coordinate
+ * space. `x`/`y` is the top-left corner, growing right/down.
  *
  * Half-open in both dimensions: `right` and `bottom` are excluded.
  */
@@ -1908,6 +2895,89 @@ declare interface RemovedItem {
     readonly deletedLocal: readonly AnnotatedRange[];
 }
 
+export declare interface RenameAnchor {
+    readonly left: number;
+    readonly top: number;
+    readonly height: number;
+}
+
+export declare class RenameModel<TContext = undefined> {
+    private readonly _options;
+    readonly name: ISettableObservable<string, void>;
+    private readonly _session;
+    private readonly _pending;
+    private readonly _failure;
+    private _submission;
+    private _disposed;
+    readonly session: IObservable<RenameSession<TContext> | undefined>;
+    readonly pending: IObservable<boolean>;
+    readonly isOpen: IObservableWithChange<boolean, void>;
+    readonly error: IObservableWithChange<Error | undefined, void>;
+    readonly validationMessage: IObservableWithChange<string | undefined, void>;
+    readonly canSubmit: IObservableWithChange<boolean, void>;
+    private readonly _nameObserver;
+    constructor(_options: RenameModelOptions<TContext>);
+    open(session: RenameSession<TContext>): void;
+    submit(): Promise<RenameSubmitResult>;
+    cancel(): void;
+    dispose(): void;
+    private _close;
+    private _abortSubmission;
+    private _isCurrent;
+}
+
+export declare interface RenameModelOptions<TContext = undefined> {
+    readonly onSubmit: (request: RenameRequest<TContext>) => void | Promise<void>;
+    readonly onCancel?: (session: RenameSession<TContext>) => void;
+    readonly validate?: (name: string, session: RenameSession<TContext>) => string | undefined;
+}
+
+export declare interface RenameRequest<TContext = undefined> extends RenameSession<TContext> {
+    readonly name: string;
+    readonly signal: AbortSignal;
+}
+
+export declare interface RenameSession<TContext = undefined> {
+    readonly initialName: string;
+    readonly context: TContext;
+}
+
+export declare type RenameSubmitResult = {
+    readonly kind: 'submitted';
+    readonly name: string;
+} | {
+    readonly kind: 'invalid';
+    readonly message: string;
+} | {
+    readonly kind: 'error';
+    readonly error: Error;
+} | {
+    readonly kind: 'closed' | 'pending' | 'cancelled' | 'superseded';
+};
+
+export declare class RenameWidget<TContext = undefined> extends Disposable {
+    private readonly _container;
+    private readonly _model;
+    private readonly _options;
+    readonly element: HTMLDivElement;
+    readonly inputElement: HTMLInputElement;
+    private readonly _message;
+    private _anchor;
+    private _focusedSession;
+    constructor(_container: HTMLElement, _model: RenameModel<TContext>, _options?: RenameWidgetOptions);
+    focusAndSelect(): void;
+    /** Anchor coordinates are relative to the positioned container's padding box. */
+    layout(anchor?: RenameAnchor): void;
+}
+
+export declare interface RenameWidgetOptions {
+    readonly autoFocus?: boolean;
+    /** Called when a focused widget closes; the host can restore editor focus. */
+    readonly onDidHide?: () => void;
+}
+
+export declare type RenderMarkupText = 'none' | 'selection' | 'all';
+
 declare interface ReplacedItem {
     readonly kind: 'replaced';
     readonly original: AstNode;
@@ -1918,6 +2988,39 @@ declare interface ReplacedItem {
     readonly deletedLocal: readonly AnnotatedRange[];
 }
 
+export declare class RichLink {
+    private readonly _displayHints?;
+    static create(options: RichLinkOptions): RichLink;
+    static mount(element: HTMLElement, authoredLabel: HTMLSpanElement, displayHints?: RichLinkDisplayHints): RichLink;
+    static clear(element: HTMLElement): void;
+    readonly element: HTMLElement;
+    readonly authoredLabel: HTMLSpanElement;
+    private readonly _icon;
+    private readonly _title;
+    private readonly _detail;
+    private readonly _reference;
+    private readonly _changes;
+    private readonly _status;
+    private readonly _secondaryStatus;
+    private constructor();
+    update(presentation: LinkPresentation | undefined): void;
+    private _renderUnavailable;
+    private _layout;
+    private _setDefaultOrder;
+}
+
+declare interface RichLinkDisplayHints {
+    readonly iconOnly?: boolean;
+    readonly maxWidthChars?: number;
+}
+
+export declare interface RichLinkOptions {
+    readonly href: string;
+    readonly authoredLabel: string;
+    readonly presentation?: LinkPresentation;
+    readonly displayHints?: RichLinkDisplayHints;
+}
+
 export declare const selectAll: SelectionCommand;
 
 export declare function selectBlock(ctx: CursorCommandContext, blockRange: OffsetRange): Selection_2;
@@ -1925,13 +3028,14 @@ export declare function selectBlock(ctx: CursorCommandContext, blockRange: Offse
 declare class Selection_2 {
     readonly anchor: SourceOffset;
     readonly active: SourceOffset;
-    static collapsed(offset: SourceOffset): Selection_2;
-    constructor(anchor: SourceOffset, active: SourceOffset);
+    static collapsed(offset: SourceOffset, affinity?: SourceCursorPosition['affinity']): Selection_2;
+    readonly activeAffinity?: SourceCursorPosition['affinity'];
+    constructor(anchor: SourceOffset, active: SourceOffset, activeAffinity?: SourceCursorPosition['affinity']);
     get isCollapsed(): boolean;
     get isForward(): boolean;
     get range(): OffsetRange;
     collapseToActive(): Selection_2;
-    withActive(active: SourceOffset): Selection_2;
+    withActive(active: SourceOffset, affinity?: SourceCursorPosition['affinity']): Selection_2;
 }
 export { Selection_2 as Selection }
 
@@ -1943,8 +3047,13 @@ export { Selection_2 as Selection }
 export declare interface SelectionBlock {
     readonly block: BlockAstNode;
     readonly absoluteStart: number;
-    readonly viewNode: ViewNode;
-    readonly element: HTMLElement;
+    /** Block border box in editor-local coordinates. */
+    readonly rect: Rect2D;
+    /** Visible horizontal padding-box bounds for a scrolling block. */
+    readonly viewportClip: {
+        readonly left: number;
+        readonly right: number;
+    } | undefined;
 }
 
 export declare type SelectionCommand = (ctx: CursorCommandContext, offset: SourceOffset) => Selection_2;
@@ -1956,6 +3065,9 @@ export declare interface SelectionRect {
     readonly height: number;
 }
 
+/** The interaction that produced the current editor selection. */
+export declare type SelectionSource = 'user' | 'find';
+
 /**
  * Owns the SVG overlay that paints the selection.
  *
@@ -1976,11 +3088,10 @@ export declare interface SelectionRect {
  * envelope shape used by IDE selection rendering.
  */
 export declare class SelectionView extends Disposable {
-    private readonly _parent;
     readonly element: SVGSVGElement;
     readonly rendering: IObservable<SelectionViewRendering>;
     private readonly _path;
-    constructor(_parent: HTMLElement, options: SelectionViewOptions);
+    constructor(options: SelectionViewOptions);
 }
 
 export declare interface SelectionViewOptions {
@@ -2008,12 +3119,9 @@ export declare type SmartEnterResult = {
     readonly kind: 'edit';
     readonly edit: StringEdit;
     readonly selection: Selection_2;
-} | {
-    readonly kind: 'pending';
-    readonly anchorBlock: BlockAstNode;
-    readonly replaceRange: OffsetRange;
-    readonly atEof: boolean;
-};
+    /** Post-edit range of indentation copied onto a new fenced-code line. */
+    readonly generatedIndentation?: OffsetRange;
+} | PendingParagraphResult;
 
 /**
  * A run of {@link Token}s together with the exact {@link OffsetRange} they
@@ -2028,34 +3136,29 @@ export declare interface SnapshotTokens {
     readonly tokens: readonly Token[];
 }
 
-export declare type SourceOffset = number;
-
-export declare abstract class StackedCommentsPresenter extends Disposable implements ICommentsPresenter {
-    protected readonly model: CommentsModel;
-    protected readonly view: EditorView;
-    protected readonly context?: CommentsPresenterContext | undefined;
-    private readonly _layer;
-    private readonly _entries;
-    private _order;
-    constructor(model: CommentsModel, view: EditorView, context?: CommentsPresenterContext | undefined);
-    /** Build the card DOM for a comment. Called once per new comment. */
-    protected abstract createWidget(comment: Comment_2): StackWidget;
-    private _reconcile;
-    private _relayout;
+declare interface SourceCursorPosition {
+    readonly kind: 'source';
+    readonly offset: SourceOffset;
+    /** Prefer the preceding visual line at a shared soft-wrap boundary. */
+    readonly affinity?: 'upstream';
 }
 
-/** The minimal widget contract a subclass must produce. */
-export declare interface StackWidget {
-    readonly element: HTMLElement;
-    dispose(): void;
+/** Metadata delivered synchronously immediately before a model-owned source edit is applied. */
+export declare interface SourceEditEvent {
+    readonly baseSourceTextId: number;
+    readonly resultSourceTextId: number;
+    readonly edit: StringEdit;
+    readonly transaction: ITransaction;
 }
 
+export declare type SourceOffset = number;
+
 export declare class StrikethroughAstNode extends AstNode {
     readonly openMarker: MarkerAstNode;
-    readonly content: readonly (InlineAstNode | GlueAstNode)[];
+    readonly content: readonly InlineContentAstNode[];
     readonly closeMarker: MarkerAstNode;
     readonly kind = "strikethrough";
-    constructor(openMarker: MarkerAstNode, content: readonly (InlineAstNode | GlueAstNode)[], closeMarker: MarkerAstNode);
+    constructor(openMarker: MarkerAstNode, content: readonly InlineContentAstNode[], closeMarker: MarkerAstNode);
     get children(): readonly AstNode[];
     mapChildren(m: ReadonlyMap<AstNode, AstNode>): AstNode;
 }
@@ -2092,6 +3195,11 @@ export declare class StringReplacement {
     constructor(replaceRange: OffsetRange, newText: string);
     get isEmpty(): boolean;
     equals(other: StringReplacement): boolean;
+    /**
+     * Narrows this replacement to the span that actually changes, by trimming
+     * the prefix and suffix it shares with the text it replaces in `source`.
+     */
+    removeCommonSuffixPrefix(source: string): StringReplacement;
     toString(): string;
 }
 
@@ -2105,10 +3213,10 @@ export declare class StringValue {
 
 export declare class StrongAstNode extends AstNode {
     readonly openMarker: MarkerAstNode;
-    readonly content: readonly (InlineAstNode | GlueAstNode)[];
+    readonly content: readonly InlineContentAstNode[];
     readonly closeMarker: MarkerAstNode;
     readonly kind = "strong";
-    constructor(openMarker: MarkerAstNode, content: readonly (InlineAstNode | GlueAstNode)[], closeMarker: MarkerAstNode);
+    constructor(openMarker: MarkerAstNode, content: readonly InlineContentAstNode[], closeMarker: MarkerAstNode);
     get children(): readonly AstNode[];
     mapChildren(m: ReadonlyMap<AstNode, AstNode>): AstNode;
 }
@@ -2120,6 +3228,85 @@ declare class StrongViewData {
     constructor(ast: StrongAstNode, content: readonly AnyViewData[]);
 }
 
+export declare type SuggestAcceptance = 'enter' | 'tab' | 'pointer';
+
+export declare interface SuggestCallbacks<T extends SuggestItem> {
+    readonly onAccept: (item: T, source: SuggestAcceptance) => void;
+    readonly onCancel?: () => void;
+    readonly onSelect?: (item: T | undefined) => void;
+}
+
+export declare interface SuggestItem {
+    readonly id: string;
+    readonly label: string;
+    readonly detail?: string;
+    readonly type?: string;
+    readonly highlightLength?: number;
+}
+
+export declare class SuggestModel<T extends SuggestItem = SuggestItem> {
+    private readonly _callbacks;
+    private readonly _state;
+    readonly state: IObservable<SuggestState<T>>;
+    readonly selectedItem: IObservableWithChange<T | undefined, void>;
+    constructor(_callbacks: SuggestCallbacks<T>);
+    show(items: readonly T[], selectedId?: string | undefined): void;
+    showLoading(): void;
+    showError(message: string): void;
+    close(): void;
+    select(id: string): boolean;
+    navigate(direction: SuggestNavigation, pageSize?: number): boolean;
+    accept(source?: SuggestAcceptance): boolean;
+    cancel(): boolean;
+    private _update;
+}
+
+export declare type SuggestNavigation = 'next' | 'previous' | 'first' | 'last' | 'nextPage' | 'previousPage';
+
+export declare type SuggestState<T extends SuggestItem = SuggestItem> = {
+    readonly kind: 'closed';
+} | {
+    readonly kind: 'loading';
+} | {
+    readonly kind: 'empty';
+} | {
+    readonly kind: 'error';
+    readonly message: string;
+} | {
+    readonly kind: 'ready';
+    readonly items: readonly T[];
+    readonly selectedIndex: number;
+};
+
+export declare class SuggestWidget<T extends SuggestItem = SuggestItem> extends Disposable {
+    private readonly _options;
+    readonly element: HTMLDivElement;
+    readonly listElement: HTMLDivElement;
+    private readonly _message;
+    private readonly _savedAttributes;
+    private _items;
+    private _disposed;
+    private _pendingReveal;
+    constructor(_options: SuggestWidgetOptions<T>);
+    handleKeyDown(event: KeyboardEvent): boolean;
+    dispose(): void;
+    private _rowFromEvent;
+    private _render;
+    private _revealSelection;
+    private _createRow;
+    private _restoreAttributes;
+}
+
+export declare interface SuggestWidgetOptions<T extends SuggestItem> {
+    readonly model: SuggestModel<T>;
+    readonly focusTarget: HTMLElement;
+    readonly id: string;
+    readonly label?: string;
+    readonly listenForKeyboard?: boolean;
+}
+
+export declare type TabKeyboardAction = 'insert' | 'outdent';
+
 export declare class TableAstNode extends BlockAstNodeBase {
     readonly content: readonly (TableRowAstNode | GlueAstNode)[];
     readonly leadingTrivia?: GlueAstNode | undefined;
@@ -2182,10 +3369,10 @@ declare class TableViewData {
 }
 
 /**
- * Source range (relative to `item`) of a task list item's `[x]`/`[ ]`
+ * Source range (relative to `item`) of a task list item's `[x]`/`[ ]`/`[]`
  * checkbox, or `undefined` when the item is not a task item. The checkbox is
  * plain glue in the AST, so a host that wants to toggle it locates the literal
- * `[x]`/`[ ]` token here.
+ * checkbox token here.
  */
 export declare function taskCheckboxRange(item: ListItemAstNode): OffsetRange | undefined;
 
@@ -2202,6 +3389,14 @@ declare class TextViewData {
     readonly showWhitespace: boolean;
     readonly leftWordBoundary: boolean;
     readonly rightWordBoundary: boolean;
+    /**
+     * Number of leading source characters to keep out of the rendered
+     * text (but not out of the source): the `:running:` marker plus its
+     * mandatory leading separator, once
+     * {@link isRunnerMarkerText} has matched this node. Zero otherwise.
+     */
+    readonly hiddenPrefixLength: number;
+    readonly taskLabel: boolean;
     readonly kind = "text";
     /**
      * Whether non-obvious whitespace in this text is revealed (block is active).
@@ -2210,7 +3405,14 @@ declare class TextViewData {
      * emphasis); a single space touching such a sibling is obvious and stays
      * undecorated, just like a space between two words within this leaf.
      */
-    constructor(ast: TextAstNode, showWhitespace: boolean, leftWordBoundary?: boolean, rightWordBoundary?: boolean);
+    constructor(ast: TextAstNode, showWhitespace: boolean, leftWordBoundary?: boolean, rightWordBoundary?: boolean, 
+    /**
+     * Number of leading source characters to keep out of the rendered
+     * text (but not out of the source): the `:running:` marker plus its
+     * mandatory leading separator, once
+     * {@link isRunnerMarkerText} has matched this node. Zero otherwise.
+     */
+    hiddenPrefixLength?: number, taskLabel?: boolean);
 }
 
 export declare class ThematicBreakAstNode extends BlockAstNodeBase {
@@ -2261,6 +3463,91 @@ declare interface UnchangedItem {
     readonly modifiedStart: number;
 }
 
+/**
+ * A block whose token type the parser does not understand (a setext heading or
+ * any future/extension construct). Rather than dropping the
+ * span — which would demote its text to invisible glue — the parser captures the
+ * whole source range verbatim as a single {@link MarkerAstNode} of kind
+ * `content` and records the originating micromark {@link tokenType}, so the view
+ * can render it as raw, editable text with an "unhandled" affordance. Offsets
+ * stay sound: `content` tiles the block's full source span exactly.
+ */
+declare class UnhandledBlockAstNode extends BlockAstNodeBase {
+    readonly tokenType: string;
+    readonly content: readonly (MarkerAstNode | GlueAstNode)[];
+    readonly leadingTrivia?: GlueAstNode | undefined;
+    readonly kind = "unhandledBlock";
+    constructor(tokenType: string, content: readonly (MarkerAstNode | GlueAstNode)[], leadingTrivia?: GlueAstNode | undefined);
+    get children(): readonly AstNode[];
+    get code(): MarkerAstNode | undefined;
+    /**
+     * Lossless slices when this raw HTML block starts one comment after optional
+     * whitespace. An open comment consumes the remaining source as its body. A
+     * complete comment permits only trailing whitespace after its closer.
+     */
+    get htmlComment(): HtmlCommentSource | undefined;
+    mapChildren(m: ReadonlyMap<AstNode, AstNode>): AstNode;
+    withLeadingTrivia(trivia: GlueAstNode | undefined): UnhandledBlockAstNode;
+    protected _localEquals(o: this): boolean;
+}
+
+/**
+ * View-data for an {@link UnhandledBlockAstNode}. The source remains verbatim
+ * in both states. Complete HTML comments use {@link showMarkup} to switch
+ * between their quiet reading treatment and editable source presentation;
+ * other unhandled blocks ignore the flag and keep their warning treatment.
+ */
+declare class UnhandledBlockViewData {
+    readonly ast: UnhandledBlockAstNode;
+    readonly showMarkup: boolean;
+    readonly content: readonly AnyViewData[];
+    readonly kind = "unhandledBlock";
+    constructor(ast: UnhandledBlockAstNode, showMarkup: boolean, content: readonly AnyViewData[]);
+}
+
+/**
+ * A standalone HTML `<video>` whose source can be rendered without executing
+ * arbitrary raw HTML. Its exact HTML remains in `content`, so activating the
+ * block restores the original source for editing.
+ */
+export declare class VideoAstNode extends BlockAstNodeBase {
+    readonly attributes: VideoAttributes;
+    readonly content: readonly (MarkerAstNode | GlueAstNode)[];
+    readonly leadingTrivia?: GlueAstNode | undefined;
+    readonly kind = "video";
+    constructor(attributes: VideoAttributes, content: readonly (MarkerAstNode | GlueAstNode)[], leadingTrivia?: GlueAstNode | undefined);
+    get children(): readonly AstNode[];
+    get source(): MarkerAstNode | undefined;
+    mapChildren(m: ReadonlyMap<AstNode, AstNode>): AstNode;
+    withLeadingTrivia(trivia: GlueAstNode | undefined): VideoAstNode;
+    protected _localEquals(o: this): boolean;
+}
+
+/** The supported semantic attributes of a standalone HTML `<video>` block. */
+export declare interface VideoAttributes {
+    readonly src: string;
+    readonly title?: string;
+    readonly autoplay: boolean;
+    readonly controls: boolean;
+    readonly loop: boolean;
+    readonly muted: boolean;
+}
+
+declare class VideoViewData {
+    readonly ast: VideoAstNode;
+    /** Active: reveal the exact HTML source; inactive: render the native video. */
+    readonly showMarkup: boolean;
+    readonly content: readonly AnyViewData[];
+    /** Nested diff state; top-level video diff state lives on the document child. */
+    readonly diffKind?: "added" | "modified" | undefined;
+    readonly kind = "video";
+    constructor(ast: VideoAstNode, 
+    /** Active: reveal the exact HTML source; inactive: render the native video. */
+    showMarkup: boolean, content: readonly AnyViewData[], 
+    /** Nested diff state; top-level video diff state lives on the document child. */
+    diffKind?: "added" | "modified" | undefined);
+}
+
 /**
  * Immutable view of an AST node. Pairs `ast` with its rendered `dom` and a
  * mirror of `ast.children` as ViewNode children. Source offsets are NEVER
@@ -2352,6 +3639,24 @@ export declare class ViewNode extends Disposable {
     forEachTextLeaf(nodeOffset: number, visitor: (leaf: ViewNode, leafOffset: number) => void): void;
 }
 
+/**
+ * A visual cursor line that has no representation in the source text.
+ *
+ * The two source offsets are the positions immediately before and after the
+ * virtual line. The object itself is the stable identity of the line.
+ */
+export declare class VirtualCursorLine {
+    readonly sourceOffsetBefore: SourceOffset;
+    readonly sourceOffsetAfter: SourceOffset;
+    constructor(sourceOffsetBefore: SourceOffset, sourceOffsetAfter: SourceOffset);
+}
+
+/** A measured source-less line inserted directly after a source block. */
+declare interface VirtualLineMeasurement {
+    readonly afterBlock: BlockAstNode;
+    readonly line: VisualLine;
+}
+
 export declare type VisualCursorCommand = (ctx: VisualCursorCommandContext) => CursorMoveResult;
 
 export declare interface VisualCursorCommandContext extends CursorCommandContext {
@@ -2369,12 +3674,15 @@ export declare function visualizeAst(root: AstNode, source: string): AstVisualiz
 export declare class VisualLine {
     readonly rect: Rect2D;
     readonly runs: readonly VisualRun[];
-    constructor(rect: Rect2D, runs: readonly VisualRun[]);
+    readonly virtualCursorLine?: VirtualCursorLine | undefined;
+    static virtual(cursorLine: VirtualCursorLine, rect: Rect2D): VisualLine;
+    constructor(rect: Rect2D, runs: readonly VisualRun[], virtualCursorLine?: VirtualCursorLine | undefined);
     containsOffset(offset: SourceOffset): boolean;
     /**
      * How `offset` relates to this line's runs:
      *   - `'covers'`: a run starts at or strictly contains the offset
-     *     (`start <= offset < endExclusive`) — the caret belongs on this line.
+     *     (`start <= offset < endExclusive`), or a zero-length visual-line
+     *     anchor sits at the offset — the caret belongs on this line.
      *   - `'end'`: the offset is only some run's trailing boundary
      *     (`offset === endExclusive`) with no run covering it — a line-break
      *     boundary the caret should leave for the next line.
@@ -2387,10 +3695,27 @@ export declare class VisualLine {
      */
     sourceDistanceTo(offset: SourceOffset): number;
     /**
-     * x of the caret position before `offset` on this line. When `offset`
-     * is past all runs (trailing whitespace / blank line), returns the
-     * right edge of the last run; when before all runs, returns the left
-     * edge of the first run.
+     * x of the caret position before `offset` on this line.
+     *
+     * The runs tile the source but are stored in paint order, not sorted by
+     * source offset (hidden-marker runs are appended last). So this scans all
+     * runs rather than assuming any ordering:
+     *
+     *  - A zero-source visual anchor owns its exact offset, so a marker-only line
+     *    wins over the preceding line's inclusive end boundary.
+     *  - Otherwise a run starting at `offset` owns that seam. This keeps an
+     *    out-of-flow prefix from placing the caret at its trailing edge when the
+     *    following body starts at a visually separate x.
+     *  - Otherwise, if some run *covers* `offset`, its own geometry places the
+     *    caret (exact glyph boundary for text runs). In the active,
+     *    markers-visible form every interior offset is covered, so this branch
+     *    keeps distinct offsets distinct.
+     *  - Otherwise `offset` sits in a gap — a hidden inline marker such as the
+     *    `**` of `**bold**`, or before/after the painted text. It snaps to the
+     *    seam between the source-nearest runs on either side: the right edge of
+     *    the closest run ending at/before `offset`, else the left edge of the
+     *    closest run starting at/after it. A hidden marker collapses to zero
+     *    width, so both edges coincide at the seam.
      */
     xAtOffset(offset: SourceOffset): number;
     /**
@@ -2404,7 +3729,8 @@ export declare class VisualLine {
 
 /**
  * Geometry of the rendered document, as a map from source offsets to 2D
- * positions and back.
+ * positions and back. All geometry is expressed in the editor overlay's local
+ * CSS-pixel coordinate space.
  *
  * Structure (top to bottom):
  *
@@ -2439,7 +3765,9 @@ export declare class VisualLineMap {
     static measure(blockViews: readonly {
         readonly absoluteStart: number;
         readonly viewNode: ViewNode;
-    }[]): VisualLineMap;
+    }[], coordinateSpace: EditorCoordinateSpace, transform?: EditorCoordinateTransform): VisualLineMap;
+    /** Lines backed by source ranges, excluding source-less cursor lines. */
+    readonly sourceLines: readonly VisualLine[];
     constructor(lines: readonly VisualLine[]);
     get lineCount(): number;
     get isEmpty(): boolean;
@@ -2458,12 +3786,18 @@ export declare class VisualLineMap {
      * The first such trailing-boundary line is remembered as a fallback for the
      * document's very last offset, where no later line starts it.
      */
-    lineIndexOfOffset(offset: SourceOffset): number;
+    lineIndexOfOffset(offset: SourceOffset, affinity?: SourceCursorPosition['affinity']): number;
     /**
      * x of the caret position before `offset`, on the line returned by
      * {@link lineIndexOfOffset}. Returns `0` when the map is empty.
      */
     xAtOffset(offset: SourceOffset): number;
+    /**
+     * Line occupied by a source or virtual cursor position. A virtual position
+     * returns `undefined` until its corresponding DOM line has been measured.
+     */
+    lineIndexOfPosition(position: CursorPosition): number | undefined;
+    xAtPosition(position: CursorPosition): number;
     /**
      * Line whose vertical band contains `y`, clamped to the first/last
      * line when `y` is outside the document.
@@ -2475,8 +3809,13 @@ export declare class VisualLineMap {
      * uses {@link offsetInLineAtX} directly to preserve desired column.
      */
     offsetAtPoint(point: Point2D): SourceOffset;
+    positionAtPoint(point: Point2D): SourceCursorPosition;
+    positionAtOffsetInLine(lineIndex: number, offset: SourceOffset): SourceCursorPosition;
     /** Snap `x` to the nearest offset on a specific line. */
     offsetInLineAtX(lineIndex: number, x: number): SourceOffset;
+    positionInLineAtX(lineIndex: number, x: number): CursorPosition;
+    lineStartOffset(lineIndex: number): SourceOffset | undefined;
+    lineEndOffset(lineIndex: number): SourceOffset | undefined;
 }
 
 /**
@@ -2498,7 +3837,9 @@ export declare class VisualRun {
     readonly sourceRange: OffsetRange;
     readonly rect: Rect2D;
     readonly source?: VisualRunSource | undefined;
-    constructor(sourceRange: OffsetRange, rect: Rect2D, source?: VisualRunSource | undefined);
+    readonly isVisualLineAnchor: boolean;
+    static visualLineAnchor(sourceOffset: SourceOffset, rect: Rect2D): VisualRun;
+    constructor(sourceRange: OffsetRange, rect: Rect2D, source?: VisualRunSource | undefined, isVisualLineAnchor?: boolean);
     get sourceStart(): SourceOffset;
     get sourceEndExclusive(): SourceOffset;
     get sourceLength(): number;
@@ -2524,14 +3865,18 @@ declare interface VisualRunSource {
     readonly textNode: Text;
     /** Offset within `textNode.data` corresponding to `sourceRange.start`. */
     readonly textNodeStart: number;
+    readonly coordinateSpace: EditorCoordinateSpace;
 }
 
-export declare class VscodeStackedCommentsView extends StackedCommentsPresenter {
-    protected createWidget(comment: Comment_2): StackWidget;
-}
+export declare const vscodeHostKeyboardProfile: KeyboardProfile;
+
+export declare const vscodeKeyboardProfile: KeyboardProfile;
+
+export declare const vscodeLocalKeyboardProfile: KeyboardProfile;
 
-export declare class VsCodeV2CommentsView extends StackedCommentsPresenter {
-    protected createWidget(comment: Comment_2): StackWidget;
+export declare interface WordNavigationConfig {
+    readonly wordSeparators: string;
+    readonly wordSegmenterLocales: readonly string[];
 }
 
 export { }