fix for SR

openspec/specs/analytics-umami/spec.md

@@ -17,6 +17,8 @@ When Umami is disabled or not configured, the site MUST still function and MUST
 When Umami is enabled, the site MUST support custom event emission for:
 - `cta_click`
 - `outbound_click`
+- `media_preview`
+- `media_preview_close`
 - a general click interaction event for all instrumented clickable items (per the site tracking taxonomy)
 
 Each emitted event MUST include enough properties to segment reports by platform and placement when applicable.
@@ -27,6 +29,8 @@ The site MUST instrument tracked clickables using Umami's supported Track Events
 - `data-umami-event="<event-name>"`
 - optional event data using `data-umami-event-*`
 
+For interactions that are triggered programmatically (e.g., modal close events where the close method must be recorded), the site MAY use Umami's JavaScript API (`umami.track()`) instead of data attributes when data attributes cannot express the required properties.
+
 For content-related links (clickables representing a specific piece of content), the site MUST also provide the following Umami event data attributes:
 - `data-umami-event-title`
 - `data-umami-event-type`
@@ -47,6 +51,18 @@ For content-related links (clickables representing a specific piece of content),
 - **WHEN** a user clicks an element with no tracking metadata
 - **THEN** the system does not throw and navigation/interaction proceeds normally
 
+#### Scenario: Media preview event emitted on card click
+- **WHEN** a user clicks a video or podcast content card that opens a media modal
+- **THEN** the system emits a `media_preview` event with `target_id`, `placement`, `title`, `type`, and `source`
+
+#### Scenario: Media preview close event emitted
+- **WHEN** a user closes the media modal
+- **THEN** the system emits a `media_preview_close` event with the `target_id` of the content that was previewed and the `close_method` used
+
+#### Scenario: Modal CTA click emitted
+- **WHEN** a user clicks a CTA inside the media modal (e.g., "View on YouTube")
+- **THEN** the system emits a `cta_click` event with `target_id`, `placement=media_modal`, `platform`, and `target_url`
+
 ### Requirement: Environment configuration
 The site MUST support configuration of Umami parameters (at minimum: website ID and script URL) without requiring code changes.