← All stories

BRANCH · ef-030-canvas-dynamic-elements

Canvas dynamic elements

EF-030Persona: OrganizerRoots in: event-setupMatrix: ShippableEF reference: EventFarm doc

The organizer inserts event and guest merge tokens from the server catalog, validates them against tenant data, and verifies preview-time and render-time resolution. The token vocabulary is deployed; this story nails the editor and fallback contract.

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 dynamic elements (event + guest merge tokens), 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.

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.

Token catalog is server-backed and paginated

Trigger: organizer opens the token picker and searches for guest or event fields.

Resolution: the catalog is fetched from the server, paginated, and filtered without client-only stale token names.

Required token warning before publish

Trigger: a required token has no tenant data for the selected event.

Resolution: the editor shows a publish warning next to the token and preview uses fallback copy instead of empty output.

Stable test attributes

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

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

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
- token-catalog-server-backed
- required-token-warning
- evaluate-canvas-editor