From 02eb21cd8f3588ab4eef385b7a0681dcb52697e6 Mon Sep 17 00:00:00 2001 From: Jonathan Locala Date: Thu, 23 Jul 2026 11:43:37 -0400 Subject: [PATCH 1/3] docs(media): enable autodocs pages for the media stack stories MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit MediaEditor, the MediaEditor Live Demo, and TranscriptView all carry docs.description text but lacked the autodocs tag (157 story files in the repo have it; MediaPlayer already does), so no Docs page was ever generated for them. Also mention the ScriptPanel in the Live Demo description — it was absent. Co-Authored-By: Claude Opus 4.8 (1M context) --- src/components/MediaEditor/MediaEditor.stories.tsx | 1 + src/components/MediaEditor/MediaEditorLive.stories.tsx | 6 +++++- src/components/TranscriptView/TranscriptView.stories.tsx | 1 + 3 files changed, 7 insertions(+), 1 deletion(-) diff --git a/src/components/MediaEditor/MediaEditor.stories.tsx b/src/components/MediaEditor/MediaEditor.stories.tsx index 5852eb39..26418ef0 100644 --- a/src/components/MediaEditor/MediaEditor.stories.tsx +++ b/src/components/MediaEditor/MediaEditor.stories.tsx @@ -39,6 +39,7 @@ const sampleTranscript: Transcript = { const meta: Meta = { title: 'Components/Images & Media/MediaEditor', component: MediaEditor, + tags: ['autodocs'], parameters: { layout: 'fullscreen', docs: { diff --git a/src/components/MediaEditor/MediaEditorLive.stories.tsx b/src/components/MediaEditor/MediaEditorLive.stories.tsx index a7ce8440..e517b75d 100644 --- a/src/components/MediaEditor/MediaEditorLive.stories.tsx +++ b/src/components/MediaEditor/MediaEditorLive.stories.tsx @@ -22,6 +22,7 @@ import { const meta: Meta = { title: 'Components/Images & Media/MediaEditor Live Demo', + tags: ['autodocs'], parameters: { layout: 'fullscreen', docs: { @@ -33,7 +34,10 @@ const meta: Meta = { 'Whisper model before the first transcription; base.en is the recommended ' + 'default (it preserves inter-word silence gaps, which the silence-editing ' + 'features depend on). Word-level timestamps are requested first, with a ' + - 'fallback to segment-level if the model rejects word alignment.', + 'fallback to segment-level if the model rejects word alignment. The ' + + 'toolbar Script button docks the ScriptPanel: the live edit state as an ' + + 'editable YAML/JSON script (Apply pushes changes back through the ' + + 'undo-safe replaceEditedWords), alongside the read-only original.', }, }, }, diff --git a/src/components/TranscriptView/TranscriptView.stories.tsx b/src/components/TranscriptView/TranscriptView.stories.tsx index db1430b4..3bf54c27 100644 --- a/src/components/TranscriptView/TranscriptView.stories.tsx +++ b/src/components/TranscriptView/TranscriptView.stories.tsx @@ -76,6 +76,7 @@ const wordOnlyTranscript: Transcript = { const meta: Meta = { title: 'Components/Images & Media/TranscriptView', component: TranscriptView, + tags: ['autodocs'], parameters: { layout: 'padded', docs: { From 4f22f8b6323e568f065131a78a4dd9018af645bb Mon Sep 17 00:00:00 2001 From: Jonathan Locala Date: Thu, 23 Jul 2026 17:42:02 -0400 Subject: [PATCH 2/3] docs(media): declare component on the Live Demo meta With autodocs enabled, the Live Demo meta was the only autodocs-tagged story under src/components without a `component` (157/157 others have one), so its generated docs page had nothing to document. The demo already imports and renders MediaEditor - declare it. Found by Copilot review on #328. Co-Authored-By: Claude Opus 4.8 (1M context) --- src/components/MediaEditor/MediaEditorLive.stories.tsx | 1 + 1 file changed, 1 insertion(+) diff --git a/src/components/MediaEditor/MediaEditorLive.stories.tsx b/src/components/MediaEditor/MediaEditorLive.stories.tsx index e517b75d..5bb7a115 100644 --- a/src/components/MediaEditor/MediaEditorLive.stories.tsx +++ b/src/components/MediaEditor/MediaEditorLive.stories.tsx @@ -22,6 +22,7 @@ import { const meta: Meta = { title: 'Components/Images & Media/MediaEditor Live Demo', + component: MediaEditor, tags: ['autodocs'], parameters: { layout: 'fullscreen', From 793ed6a24f666d5f215c57e28c2e8f391b9c69df Mon Sep 17 00:00:00 2001 From: Jonathan Locala Date: Fri, 24 Jul 2026 13:50:05 -0400 Subject: [PATCH 3/3] docs(media): disable generated controls on the Live Demo autodocs page The story renders the LiveDemo harness, not , so the Controls panel autodocs derives from MediaEditor's props would not drive anything. MediaEditor's own autodocs page keeps the interactive props table. Also types the meta as Meta to match the other story files. Co-Authored-By: Claude Opus 4.8 (1M context) --- src/components/MediaEditor/MediaEditorLive.stories.tsx | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/src/components/MediaEditor/MediaEditorLive.stories.tsx b/src/components/MediaEditor/MediaEditorLive.stories.tsx index 5bb7a115..e1c03c68 100644 --- a/src/components/MediaEditor/MediaEditorLive.stories.tsx +++ b/src/components/MediaEditor/MediaEditorLive.stories.tsx @@ -20,12 +20,16 @@ import { // Meta // ============================================================================ -const meta: Meta = { +const meta: Meta = { title: 'Components/Images & Media/MediaEditor Live Demo', component: MediaEditor, tags: ['autodocs'], parameters: { layout: 'fullscreen', + // The story renders the LiveDemo harness, not , + // so generated controls would not drive it; MediaEditor's own autodocs + // page carries the interactive props table. + controls: { disable: true }, docs: { description: { component: