{"schemaVersion":1,"id":"2026-10-13-media-caption-preview","status":"draft","source":{"kind":"entry-mdx","path":"apps/www/src/registry/changelog/entries/2026-10-13-media-caption-preview.mdx"},"change":{"type":"source","date":"2026-10-13","commits":[]},"release":{"status":"unresolved"},"kind":"fix","summary":"Keep empty media captions hidden on select, restore image preview and add the media toolbar to file, audio and video","targets":[{"name":"caption","files":["apps/www/src/registry/components/editor/caption.tsx"],"definitionFiles":["apps/www/src/registry/registry-editor.ts"],"diagnostics":[]},{"name":"media-image","files":["apps/www/src/registry/components/editor/media-image.tsx"],"definitionFiles":["apps/www/src/registry/registry-editor.ts"],"diagnostics":[]},{"name":"media-audio","files":["apps/www/src/registry/components/editor/media-audio.tsx"],"definitionFiles":["apps/www/src/registry/registry-editor.ts"],"diagnostics":[]},{"name":"media-embed","files":["apps/www/src/registry/components/editor/media-embed.tsx"],"definitionFiles":["apps/www/src/registry/registry-editor.ts"],"diagnostics":[]},{"name":"media-file","files":["apps/www/src/registry/components/editor/media-file.tsx"],"definitionFiles":["apps/www/src/registry/registry-editor.ts"],"diagnostics":[]},{"name":"media-video","files":["apps/www/src/registry/components/editor/media-video.tsx"],"definitionFiles":["apps/www/src/registry/registry-editor.ts"],"diagnostics":[]},{"name":"media-preview-dialog","files":["apps/www/src/registry/components/editor/media-preview-dialog.tsx"],"definitionFiles":["apps/www/src/registry/registry-editor.ts"],"diagnostics":[]},{"name":"media-toolbar","files":["apps/www/src/registry/components/editor/media-toolbar.tsx"],"definitionFiles":["apps/www/src/registry/registry-editor.ts"],"diagnostics":[]}],"entries":[{"id":"2026-10-13-caption-hidden-until-caret-8ab1a415","kind":"behavior","summary":"Keep an empty caption hidden while its media is selected, so selecting media no longer shifts the page. The caption shows once the caret enters it, such as through the media toolbar's Caption button, and `Caption` no longer takes an `active` prop.","details":[],"migrationNotes":["Remove the active prop from Caption; it shows an empty caption only while the caret is inside it."],"targets":["caption","media-image","media-audio","media-embed","media-file","media-video"],"source":{"line":14,"row":1,"legacyRelease":{"date":"2026-10-13","entry":"2026-10-13-media-caption-preview","section":null}}},{"id":"2026-10-13-image-preview-by-key-4f1c2d7e","kind":"fix","summary":"Open the image preview on double-click again; `api.preview.open` takes the image's path and URL. The preview renders above the page, centers the image, and closes on a backdrop click or Escape.","details":[],"migrationNotes":["Call imagePlugin api.preview.open with the image's path and URL instead of the element."],"targets":["media-image","media-preview-dialog"],"source":{"line":18,"row":2,"legacyRelease":{"date":"2026-10-13","entry":"2026-10-13-media-caption-preview","section":null}}},{"id":"2026-10-14-file-click-media-toolbar-5c9e21b3","kind":"behavior","summary":"Select a file on click in an editable editor and open it on double-click. Show the media toolbar with Preview, Caption and delete while a file, audio or video node is selected. The image toolbar also gets Preview, which opens the image preview. The file and audio toolbars sit above their block, so neither covers the next block, and the audio selection ring fits the player. File and audio blocks get vertical padding so a selection ring does not overlap the block next to it, and a click in that padding selects the block instead of opening its caption. A click on an audio or video player selects that node and returns the keyboard to the editor, and Preview no longer keeps focus, so arrow keys keep moving the selection.","details":[],"migrationNotes":[],"targets":["media-file","media-audio","media-video","media-image","media-toolbar"],"source":{"line":22,"row":3,"legacyRelease":{"date":"2026-10-13","entry":"2026-10-13-media-caption-preview","section":null}}}],"diagnostics":[]}