Stack adjacent decisions in a document as a shuffleable deck

[MaggieAppleton]

What changes

When decision cards sit next to each other in a document, with only empty lines between them, they now render as a deck instead of a column:

• Peeking stack: the top card is fully visible and the next two headers peek above it.
• Cycling: Previous and Next, or the arrow keys on the deck controls, cycle the cards with a short shuffle. The motion is interruptible and reverses from its current frame.
• Answered cards settle to the back. A collaborator's answer reorders the deck quietly, without stealing focus.
• Count: it shows the card's place in the stack ("1 of 3 · 1 decided" at rest).
• Decisions tab: "Show in document" brings a back card to the top and focuses it.
• Reduced motion: cards reorder instantly.

The deck is presentation only. Questionnaire nodes and records are unchanged, and the deck is hosted by the run's first node, so it stays mounted while members change.

Phones: where decision cards already become chips that open the Decisions pane, the chips render as before and no deck is built.

Slice 3 of the nested-documents work. Slice 4, the Decisions tab as a deck, builds on this.

Screenshots

Deck at rest

Mid-shuffle

Decisions tab "Show in document" brings a back card forward

Phone: chips, no deck

Accessibility

• The deck is a group with aria-roledescription="carousel", named "N decisions", so there is no duplicate "Decisions" landmark.
• Back cards are inert and aria-hidden.
• A polite, debounced live region announces only the latest card. Settles caused by other people are silent.
• Arrow keys act only on the deck's own controls. Modified arrows and keys inside a card pass through to the card and the editor.
• The deck uses the shared focus ring.

Testing

• Unit tests cover order (arrange, settle, cycle, bringForward, stack position), run detection (empty lines between cards, a multi-question card as one member), deck markup and keyboard, and the time-token parser.
• e2e/inline-decision-deck.e2e.ts covers:
  • settle-to-back slot order
  • a collaborator answering your top card
  • surviving a hidden first card, with focus and draft kept
  • the reveal from the Decisions tab
  • sampled shuffle frames
  • early reversal
  • a tall card coming forward without overpainting
  • reduced motion
  • 390px width
  • phone chips
• Real bug fixed along the way: the built CSS serves --duration-linger as .6s, which was parsed as 0.6 ms, so the deck never animated.
• Tests updated:
  • sidecar.e2e.ts: editorIsModalBackground now accepts a modal that hides the editor's children rather than the editor root, because the deck's live region stays exposed. Nothing is hidden less.
  • sidecar-document-spacing.e2e.ts: now seeds answered cards, because adjacent open cards form a deck by design.
• bun run types, unit tests, oxlint and the design-contract check pass. The e2e specs for the deck, sidecar and phone decisions pass on the rebased head (72 tests).

Design-contract review

Renewed after a data-flow review, with the maintainer's approval:

• questionnaire.tsx: the dynamic owner moved into InlineCard, but the expressions are unchanged.
• deck.tsx: uses a literal class.

🤖 Generated with Claude Code