← All stories

BRANCH · ef-033-canvas-video-embeds

Canvas video embeds

EF-033Persona: OrganizerRoots in: event-setupMatrix: PartialEF reference: EventFarm doc

The organizer adds MP4, YouTube, or Vimeo video blocks to a Canvas page. Asset upload and block catalog substrate exist, but provider parsing and public rendering parity need explicit probes.

Preconditions

The organizer is authenticated in the event-setup trunk, has edit access to a fixture event, and the event has a Canvas draft page with at least one root block.

Happy path

  1. Open the Canvas editor from Event Setup.

    The editor loads the draft page, root block sequence, autosave state, and preview pane.

  2. Compose, preview, and publish.

    The organizer edits the capability surface for Canvas video embeds (MP4, YouTube, Vimeo), previews desktop and mobile, then confirms publish or schedule.

  3. Verify public version semantics.

    Publish creates a versioned snapshot; scheduled publish leaves the prior public version intact until its activation time.

Failure modes

Every Canvas branch includes the cluster E rubric: undo/redo, paste-from-other-page, asset isolation, missing-token fallback, preview parity, scheduled publish, autosave recovery, and two-editor conflict. Capability-specific probes bring each story to 10-12 failure modes.

Capability-specific gap probe

Trigger: matrix=Partial.

The visible parity panel lists the incomplete Canvas video embeds (MP4, YouTube, Vimeo) contract so the probe fails loudly until parity closes.

Undo/redo correctness across block ops

Trigger: the organizer inserts a block, deletes another, reorders the root block sequence, and edits one block property before using undo twice.

Resolution: each block operation creates exactly one undo entry; multi-step undo restores the prior root block sequence and block props exactly, then redo reapplies the same sequence without duplicating blocks.

Paste from other page

Trigger: the organizer copies a block from page A and pastes into page B, then tries the same paste from a different event.

Resolution: page-local references are remapped to the destination slug and asset URLs; cross-event paste opens an explicit confirmation before any draft mutation happens.

Asset upload failure isolated

Trigger: three assets upload while one fails with a transient R2 or connector error.

Resolution: the two successful uploads continue and bind to their blocks; the failed asset renders inline with retry and the page draft JSON remains valid.

Dynamic token rendering missing data

Trigger: preview resolves {guest.firstName} for a contact with no first name and {event.location} before location is configured.

Resolution: missing values fall back to "Guest" or configured fallback copy; no rendered sentence contains an empty merge or doubled punctuation.

Mobile preview vs published

Trigger: organizer previews at 375x667 and publishes the same draft.

Resolution: the public page matches mobile preview within layout-shift and viewport tolerances; differences surface as preview warnings before publish.

Scheduled publish vs immediate

Trigger: organizer schedules a draft for a future time instead of publishing immediately.

Resolution: before the scheduled time, the public URL serves the previous active version or 404 for first publish; at the scheduled time the new draft becomes live atomically.

Autosave recovery

Trigger: browser refreshes or crashes after an edit but before manual save.

Resolution: latest autosave is offered in a recovery banner with restore/discard; restore is the default and rehydrates the exact block tree.

Two-editor conflict resolution

Trigger: two organizers edit the same page; one publishes while the other saves a stale draft.

Resolution: the second organizer sees a conflict modal listing changed blocks and can merge or accept last-write-with-warning; both sessions converge to a deterministic state.

Provider parsing strips arbitrary HTML

Trigger: organizer pastes YouTube/Vimeo iframe HTML or a raw URL.

Resolution: the editor extracts only the provider id and allow-listed params; arbitrary HTML, scripts, and event handlers are discarded.

Video embeds lazy-load and fit mobile

Trigger: a video block is below the fold and viewed at 375x667.

Resolution: embed is lazy-loaded, autoplay is disabled by default, controls are accessible, and aspect ratio fits without horizontal scroll.

Capability-specific gap probe: video parity incomplete

Trigger: matrix=Partial for EF-033 video embeds.

Resolution: visible gap copy lists MP4, YouTube, Vimeo, sanitization, lazy loading, and mobile rendering as required before parity closes.

Stable test attributes

Visibility teeth. Each attribute must be effectively visible when active and must match the agent probes.

data-testWherePurpose
canvas-canvas-video-embeds-editorCanvas editorMain organizer-side Canvas editor surface
canvas-canvas-video-embeds-stepperCanvas editorCreate/edit/preview/publish lifecycle indicator
canvas-canvas-video-embeds-block-treeCanvas editorRoot block sequence and selected block tree
canvas-canvas-video-embeds-previewCanvas editorPreview pane for desktop and mobile layouts
canvas-canvas-video-embeds-publish-ctaCanvas editorPublish or schedule publish action
canvas-canvas-video-embeds-publish-confirmationCanvas editorConfirmation dialog for publish or risky action
canvas-canvas-video-embeds-autosave-bannerCanvas editorAutosave recovery and restore/discard banner
canvas-canvas-video-embeds-conflict-modalCanvas editorTwo-editor conflict resolution modal
canvas-canvas-video-embeds-upload-rowCanvas editorPer-asset upload progress/failure row
canvas-canvas-video-embeds-token-warningCanvas editorDynamic token validation or fallback warning
canvas-canvas-video-embeds-gap-panelCanvas editorVisible parity gap panel when matrix is absent or partial
canvas-canvas-video-embeds-mobile-preview-warningCanvas editorPreview discrepancy warning for mobile vs published
canvas-canvas-video-embeds-video-blockCanvas editorVideo embed block

Agent test plan

Inherits event-setup trunk preconditions. Component contract chaining applies through usesComponents.

- open-canvas-surface
- edit-preview-publish-flow
- published-version-recorded
- undo-redo-block-ops
- paste-cross-page
- asset-upload-isolated
- dynamic-token-fallback
- mobile-preview-published-match
- scheduled-vs-immediate-publish
- autosave-recovery
- two-editor-conflict
- video-provider-parsing
- video-accessibility-mobile
- video-parity-gap
- evaluate-canvas-editor