@vscode/markdown-editor 0.0.2-127 → 0.0.2-129

package/README.md

@@ -20,6 +20,54 @@ failed with `EPERM` on the Azure release agent. Keep the exact pin until the new
 download route is approved and verified on that agent. This affects test tooling,
 not the published editor's runtime dependencies or Component Explorer's renderer.
 
+## Embedded editor presentation
+
+Iframe editor descriptors can opt into host-owned presentation controls:
+
+```ts
+presentation: {
+    resizable: true,
+    fullWidth: true,
+    fullView: true,
+    minHeight: 180,
+}
+```
+
+These controls work without an editor protocol implementation in the iframe.
+Full width uses the Markdown viewport width while retaining document flow.
+Full view fills the visible Markdown viewport, keeps the same iframe alive,
+and restores the previous width mode, inline height, and scroll position on exit.
+The host toolbar groups copy and presentation actions in a compact, themed Codicon
+overlay. It appears on hover or keyboard focus without reserving a header row,
+and always provides an exit button in full view. Escape also exits when handled
+by the injected iframe bootstrap (nested remote pages can use the message below).
+Resize handles support pointer capture and Arrow Up/Down. After a user resize,
+content-size reports no longer override the chosen height; **Automatic height**
+returns control to the content. Full view always uses the host viewport height.
+Presentation changes never edit the Markdown source.
+
+Cooperative pages can advertise the same preferences with
+`parent.postMessage({ type: 'vscode-markdown-editor::presentation', preferences }, '*')`.
+Explicit descriptor properties override guest preferences, including `false`.
+The host sends `{ type: 'vscode-markdown-editor::presentation', mode }` to the
+iframe on binding, loading, and mode changes. Modes are `inline`, `full-width`,
+and `full-view`; pages measure dimensions with their own resize observer.
+Pages should check `event.source === parent` before accepting this notification.
+Send the same message type with `action: 'request-state'` to request the current
+mode, or `action: 'exit-full-view'` to leave full view.
+
+The **Experimental / Embedded presentation** group contains page-sized fixtures,
+each with one embedded editor. Provider controls, guest preferences, and explicit
+provider overrides use a release-notes editor backed by the sample web editor's
+text mode. Its borderless red background
+distinguishes guest UI from the Markdown host's themed controls. Edits update the underlying Markdown
+block through the real web editor protocol. **Transparent editor** shows only
+centered text, with no guest background or border, and a host-owned height-resize
+grip. Embedded mode fills the browser; Explorer page mode supports desktop/mobile
+viewports. Their light/dark Playwright tests exercise scaled-preview alignment,
+drag capture, minimum height, size-report precedence, full-width
+and full-view geometry, mode notifications, state retention, and restoration.
+
 ## Browser tests
 
 `pnpm test:e2e` builds the fixture dependencies and runs the Playwright interaction
@@ -99,6 +147,18 @@ See [Editing property tests](docs/editing-properties.md) for the interactive
 assertion fixtures, CI contracts, deterministic editing corpus, and the
 red/green/visual evidence required for layout fixes.
 
+### Rich link display hints (experimental)
+
+Inline Markdown link titles can opt into two rendering experiments:
+
+- `[commit](commit:1234567 "md:max-width=32")` bounds the entire pill to `32ch`.
+- `[commit](commit:1234567 "md:icon-only")` shows only the resource icon, retaining
+  its tooltip, accessible name, keyboard activation and original destination.
+
+Only these complete title values are interpreted as hints; other titles do not
+change pill rendering. The source title and URL remain editable and unchanged.
+These are fixture-driven experiments, not an extension contribution API.
+
 ### Automatic links
 
 Bare HTTP(S) URLs, `www.` addresses, and email addresses are detected using GFM

package/dist/index.d.ts

@@ -2009,6 +2009,8 @@ declare interface IEmbeddedCodeEditor {
     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
@@ -2298,8 +2300,9 @@ export declare class LengthReplacement {
 export declare class LinkAstNode extends AstNode {
     readonly url: string;
     readonly content: readonly InlineContentAstNode[];
+    readonly title?: string | undefined;
     readonly kind = "link";
-    constructor(url: string, content: readonly InlineContentAstNode[]);
+    constructor(url: string, content: readonly InlineContentAstNode[], title?: string | undefined);
     get children(): readonly AstNode[];
     mapChildren(m: ReadonlyMap<AstNode, AstNode>): AstNode;
     protected _localEquals(o: this): boolean;
@@ -2982,8 +2985,9 @@ declare interface ReplacedItem {
 }
 
 export declare class RichLink {
+    private readonly _displayHints?;
     static create(options: RichLinkOptions): RichLink;
-    static mount(element: HTMLElement, authoredLabel: HTMLSpanElement): RichLink;
+    static mount(element: HTMLElement, authoredLabel: HTMLSpanElement, displayHints?: RichLinkDisplayHints): RichLink;
     static clear(element: HTMLElement): void;
     readonly element: HTMLElement;
     readonly authoredLabel: HTMLSpanElement;
@@ -3001,10 +3005,16 @@ export declare class RichLink {
     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;