docs: `result_heading` doc, attributes, and story

lib/medical_transcription_web/components/components.ex

@@ -64,6 +64,13 @@ defmodule MedicalTranscriptionWeb.Components do
     """
   end
 
+  attr :status, :atom, required: true
+  attr :filename, :string, default: nil
+  attr :summary_keywords, :list, default: []
+
+  @doc """
+  Shows the status and keywords for the current session.
+  """
   def result_heading(assigns) do
     if Enum.member?([:loading, :streaming_audio, :success], assigns.status) do
       ~H"""
@@ -117,7 +124,8 @@ defmodule MedicalTranscriptionWeb.Components do
     end
   end
 
-  def record_button_in_heading(assigns) when assigns.status == :streaming_audio do
+  # Renders the record button within the result_heading component
+  defp record_button_in_heading(assigns) when assigns.status == :streaming_audio do
     ~H"""
     <button phx-click="toggle_recording" class="mr-6 px-4 py-3 bg-red-200 rounded-lg">
       <.icon name="hero-microphone" class="animate-pulse" />
@@ -125,7 +133,7 @@ defmodule MedicalTranscriptionWeb.Components do
     """
   end
 
-  def record_button_in_heading(assigns) do
+  defp record_button_in_heading(assigns) do
     ~H"""
     <button phx-click="toggle_recording" class="mr-6 px-4 py-3 bg-emerald-200 rounded-lg">
       <.icon name="hero-microphone" />
@@ -133,7 +141,8 @@ defmodule MedicalTranscriptionWeb.Components do
     """
   end
 
-  def format_keywords(keyword_predictions) do
+  # Formats keywords for display in the result_heading component
+  defp format_keywords(keyword_predictions) do
     keyword_predictions
     |> List.flatten()
     |> Enum.sort_by(& &1.score, :desc)

storybook/components/result_heading.story.exs

@@ -0,0 +1,40 @@
+defmodule MedicalTranscriptionWeb.Storybook.ResultHeading do
+  use PhoenixStorybook.Story, :component
+
+  def function, do: &MedicalTranscriptionWeb.Components.result_heading/1
+
+  def variations do
+    [
+      %Variation{
+        id: :loading,
+        attributes: %{
+          status: :loading,
+          filename: "uploaded_audio.mp3"
+        }
+      },
+      %Variation{
+        id: :streaming_audio,
+        attributes: %{
+          status: :streaming_audio,
+          summary_keywords: [
+            %{score: 1.0, label: "heart"},
+            %{score: 0.9, label: "patient"},
+            %{score: 0.88, label: "diagnosis"}
+          ]
+        }
+      },
+      %Variation{
+        id: :success,
+        attributes: %{
+          status: :success,
+          filename: "uploaded_audio.mp3",
+          summary_keywords: [
+            %{score: 1.0, label: "heart"},
+            %{score: 0.9, label: "patient"},
+            %{score: 0.88, label: "diagnosis"}
+          ]
+        }
+      }
+    ]
+  end
+end