{"schemaVersion":1,"id":"2026-07-23-rich-media-caption-children","status":"draft","source":{"kind":"entry-mdx","path":"apps/www/src/registry/changelog/entries/2026-07-23-rich-media-caption-children.mdx"},"change":{"type":"source","date":"2026-07-23","commits":[]},"release":{"status":"unresolved"},"kind":"behavior","summary":"Render media captions from direct inline children","targets":[{"name":"caption","files":["apps/www/src/registry/components/editor/caption.tsx"],"definitionFiles":["apps/www/src/registry/registry-editor.ts"],"diagnostics":[]},{"name":"media-base-kit","files":[],"definitionFiles":[],"diagnostics":[{"severity":"warning","code":"registry-file-missing","message":"No exact registry source file found for media-base-kit."}]},{"name":"media-kit","files":[],"definitionFiles":[],"diagnostics":[{"severity":"warning","code":"registry-file-missing","message":"No exact registry source file found for media-kit."}]},{"name":"media-image-node","files":[],"definitionFiles":[],"diagnostics":[{"severity":"warning","code":"registry-file-missing","message":"No exact registry source file found for media-image-node."}]},{"name":"media-video-node","files":[],"definitionFiles":[],"diagnostics":[{"severity":"warning","code":"registry-file-missing","message":"No exact registry source file found for media-video-node."}]},{"name":"media-audio-node","files":[],"definitionFiles":[],"diagnostics":[{"severity":"warning","code":"registry-file-missing","message":"No exact registry source file found for media-audio-node."}]},{"name":"media-file-node","files":[],"definitionFiles":[],"diagnostics":[{"severity":"warning","code":"registry-file-missing","message":"No exact registry source file found for media-file-node."}]},{"name":"media-embed-node","files":[],"definitionFiles":[],"diagnostics":[{"severity":"warning","code":"registry-file-missing","message":"No exact registry source file found for media-embed-node."}]},{"name":"media-placeholder-node","files":[],"definitionFiles":[],"diagnostics":[{"severity":"warning","code":"registry-file-missing","message":"No exact registry source file found for media-placeholder-node."}]},{"name":"media-toolbar-button","files":["apps/www/src/registry/components/editor/media-toolbar-button.tsx"],"definitionFiles":["apps/www/src/registry/registry-editor.ts"],"diagnostics":[]},{"name":"plate-to-html","files":["apps/www/src/registry/blocks/plate-to-html/page.tsx","apps/www/src/registry/components/editor/plate-to-html-client-kit.ts","apps/www/src/registry/components/editor/plate-to-html-kit.ts","apps/www/src/registry/components/editor/plate-to-html.tsx","apps/www/src/registry/examples/values/align-value.tsx","apps/www/src/registry/examples/values/basic-blocks-value.tsx","apps/www/src/registry/examples/values/basic-marks-value.tsx","apps/www/src/registry/examples/values/column-value.tsx","apps/www/src/registry/examples/values/date-value.tsx","apps/www/src/registry/examples/values/discussion-value.tsx","apps/www/src/registry/examples/values/equation-value.tsx","apps/www/src/registry/examples/values/font-value.tsx","apps/www/src/registry/examples/values/indent-value.tsx","apps/www/src/registry/examples/values/line-height-value.tsx","apps/www/src/registry/examples/values/link-value.tsx","apps/www/src/registry/examples/values/list-value.tsx","apps/www/src/registry/examples/values/media-value.tsx","apps/www/src/registry/examples/values/mention-value.tsx","apps/www/src/registry/examples/values/table-value.tsx","apps/www/src/registry/examples/values/toc-value.tsx"],"definitionFiles":["apps/www/src/registry/registry-blocks.ts"],"diagnostics":[]}],"entries":[{"id":"2026-07-23-caption-render-rich-media-caption-children-1ee56347","kind":"behavior","summary":"Render direct media caption children, keep an empty caption hidden until asset focus, and separate asset selection from caption editing.","details":[],"migrationNotes":["Remove CaptionPlugin from media kits and render each media element's direct children as its caption; use [{ text: '' }] when the caption is absent.","For persisted v53 media captions, add migratePlateV54 to the app's defineDocumentMigrations chain."],"targets":["caption","media-base-kit","media-kit","media-image-node","media-video-node","media-audio-node","media-file-node","media-embed-node","media-placeholder-node","media-toolbar-button","plate-to-html"],"source":{"line":14,"row":1,"legacyRelease":{"date":"2026-07-23","entry":"2026-07-23-rich-media-caption-children","section":null}}}],"diagnostics":[]}