@vscode/markdown-editor 0.0.2-128 → 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

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