Susegad UI Accessibility GitHub

How this site looks

The view settings need JavaScript. Every page reads well without them.

Mood

The same pages, in three moods.

Theme

Foundations

The Kantar interlude

A curtain between two steps of a long flow: it drops (with folds and a hem that ripples with a damped wave when it lands), a line plays in a warm spotlight pool while the real work happens (however long that actually takes, with a standing silhouette in playful), and it rises on the next step.

quiet warm playful

Open the live demo npx @susegad/cli add kantar-interlude

Stands on: Engine, The tiatr curtain, Tokens, Page transitions

The prompt

the prompt

The curtain drops, a line plays in the spotlight while the real work happens, and it rises on the next step.

import { runKantar } from 'susegad/transitions/kantar/kantar.js';

await runKantar(stageEl, {
  work: submitStep(),
  lines: ['Checking your dates…'],
  swap: () => showStepTwo(),
  register: 'warm',
});

The prompt

Build a curtain interlude for the wait between two steps of a form or flow, after the tiatr stage: its principle, not its painted set, but still a curtain a person can recognise, not a coloured box. Run it as a three-phase timeline, the curtain falling, a line playing in the spotlight while the curtain stays fully down, the curtain rising, where the middle phase is not a fixed song length but genuinely lasts exactly as long as the real asynchronous work behind it takes, with one small floor (300ms, KB1: large enough only to rescue truly instant work, never large enough to hold up real work that already took any noticeable time) so even an instant response still gets one readable beat, never longer than that unless the caller explicitly asks for more. Draw the curtain itself on a canvas, every frame, phase-driven and never touching a timer of its own: vertical folds that drift slowly, a hem that ripples with a damped travelling wave the moment it lands (heavy velvet settling, not stopping dead), a gold pelmet trim standing in for the proscenium's valance, and a warm spotlight pool that fades in once the wait begins. In the playful register only, put a simple standing silhouette in that spotlight, swaying gently, as if someone were singing there; keep the quieter warm register to the curtain and the pool alone. Always show a skip control; pressing it before the real work has finished should move the curtain on without pretending the work is done, so the caller can decide what happens next rather than being lied to. Swap the content behind the curtain exactly once, the moment the wait ends and while the curtain is still fully closed, inside a same-document View Transition, so it costs nothing extra and stays consistent with the rest of the site's transitions. Give the interlude three registers, but not equally: an auditor-facing quiet page gets no curtain at all, only a plain, honestly-timed status line; warm and playful get the theatre, in their own ink. Reduced motion takes the same plain path as quiet, in every register. Make no sound of its own.

Words to code

When you sayTechniqueWhat happens
a three-phase timeline … genuinely lasts exactly as long as the real work takespure state machinekantar.core.js's waitIsOver({ workDone, msInPhase, minWaitMs }) is the one predicate deciding whether the middle phase may end; it is a function of a boolean and two numbers, not of a Promise, so it is trivial to test every combination in Node.
one small floor … never longer than that unless the caller explicitly askshonest motionminWaitMs defaults to 300ms and is the only thing that can hold the wait open past the real work's own completion. There is no ceiling on the other side: a slow work genuinely gets a longer wait, because that is not the interlude adding delay, it is the interlude telling the truth about how long the delay already was.
pressing it before the real work has finished … without pretending the work is donehonest motionkantar.js only calls swap() when workDone is true. A skip pressed earlier still moves the curtain to "up", but swapped comes back false in the result, so the caller's own code decides what a premature exit means, rather than the interlude silently faking a result nobody computed.
exactly once … while the curtain is still fully closed … inside a same-document View TransitionreuseThe same sameDocumentTransition() from packages/transitions/page.js that Tabs uses for its own panel swap. The curtain hides the swap visually either way; the transition is there for free consistency (a persistent element elsewhere on the page still gets its continuity), not because this swap needs to be seen happening.
not equally … no curtain at all [in quiet]register disciplinerunKantar branches on register === 'quiet' (and on reduced motion) before ever building the curtain DOM: runPlain() is a separate, much smaller code path, not the curtain's animation merely sped up or hidden.
costs it never touches host's other childrenseparationThe overlay is append()-ed to host and remove()-d on its own when done; the caller's own step content lives in a sibling element inside the same host. An earlier draft used replaceChildren() on host, which meant a caller's swap (itself replacing the same host's children) tore out the still-running overlay mid-animation, the fix, and the reason host is documented as "append yours, and mine lives beside it," not "hand me the whole element."
a hem that ripples with a damped travelling wave the moment it landspure geometrykantar.core.js's hemWave(xFrac, curtain, landedSec), ported as arithmetic from the plate's own curtain(): while still moving, a gentle wave scaled by how much motion is happening (zero at both fully open and fully closed); once landed, an amplitude that decays exponentially with landedSec. kantar.js tracks the one timestamp (landedAt) this needs and hands the rest to the pure function every frame.
a simple standing silhouette … swaying gentlypure geometry, register disciplinesingerSilhouette(sway) returns a closed polygon in figure-relative units, the plate's own 21-point figure (shoulders, a raised arm, a hand) verbatim, not a redrawn simplification; kantar.js scales and positions it, and only calls it at all when register === 'playful', so warm keeps the pool without the figure. A second draft here had quietly simplified the figure to 16 points, dropping exactly the shoulder-and-arm detail Volume III's own second round added to stop the singer reading as a peg doll, a review caught it reading as a plain cone again, and it also caught the line crossing the figure's head, since both were centred on the same box by construction; the line now anchors to a caption band below the stage floor instead, so the two boxes never touch regardless of how the figure sways.
a head, a hair bun, a mic and standpure geometry, evidenceThe body's 21 points are only the plate's singerShape(); the plate's singer() separately draws a head and bun onto the same path and a mic beside it, which S3 round 1 never ported, leaving the figure headless at the shoulders. singerHead(sway) and singerBun(sway) return the same ellipse singer() draws (hx, hy is exactly singerPoint(2, 212, sway), the body's own sway law evaluated at the neck), singerMic() the same three unswayed points. The S3 clearance check was rewritten to include the head and bun's own top edge (cy - ry), not only the body polygon's points, so "no overlap" is checked against the figure a person actually sees, not the part the first check happened to look at.
a canvas … never touching a timer of its ownseparation, native firstThe canvas is sized by a ResizeObserver and redrawn from the same lastPaint frame data on every resize (a canvas clears itself on resize, so a stale frame left undrawn would flash empty); the drawing function itself (drawCurtain) takes only numbers, curtain, tSec, landedSec, spotAmt, playful, and never reads the clock or a phase name directly, so it is exactly as testable in isolation as the geometry it calls.

Accessibility

  • The song line and the plain fallback are both a polite role="status" region.
  • The curtain drawing is aria-hidden; the phase itself carries no meaning that isn't also in the DOM (the panel behind it really is hidden, or really has changed, once swap has run).
  • Skip is a real, focusable <button>.
  • No sound plays on its own; any sound is the Wave 4 vocabulary, behind the global switch (decision 0015).

Credit

After: the sketchbook's Kantar plate, a tiatr stage, a singer performs a short song in front of the curtain while the set changes behind it, so the audience is never left staring at a stagehand. What we took: the interlude as a structure (a curtain, a spotlight moment, a skip), and, from the plate's own drawing, the curtain's folds, its hem's damped ripple on landing, a pelmet standing in for the proscenium, the spotlight pool, and (playful only) the plate's own singer's silhouette, point for point. What we left: the plate's full painted sets and the pit band, a principle taken from the likeness, not the likeness itself (HOMAGE rule 1). Three drafts, three review rounds: the first took the structure only and drew a flat coloured box; the second brought the drawing back but simplified the singer down to a cone and let the spotlight line cross straight through its head; the third restored the body's full 21 points and moved the line clear, but still left the figure headless, since the plate's head, bun and mic are a separate part of singer(), not the body outline. All fixed on review: the craft is back, canvas-drawn from pure, tested geometry, a whole figure, and the line clear of all of it.

The demo's song lines are English placeholders, marked for a Konkani ear (HOMAGE rule 7) before they, or anything built from them, leave the repo.

A curtain between two steps of a long flow, so waiting becomes part of the show instead of a stall.

Usage

<div class="stage" id="stage"><!-- position: relative; the interlude overlays it -->
  <div id="step-slot"><!-- your step content lives here, not directly in #stage --></div>
</div>
import { runKantar } from 'susegad/transitions/kantar/kantar.js';

const result = await runKantar(document.getElementById('stage'), {
  work: submitStep(),                    // a Promise: the real wait
  lines: ['Checking your dates…'],        // placeholders; review with a Konkani ear before shipping (HOMAGE rule 7)
  swap: () => showStepTwo(),              // called once, when the real work is done
  register: 'warm',
  label: 'Holding your dates',
});
  • host (here, #stage) must be position: relative with room for the overlay (.sg-kantar { position: absolute; inset: 0 }). runKantar appends its overlay to host and removes only that overlay when it finishes, it never touches host's other children. Keep your step content in a sibling element inside host (#step-slot above), not scattered directly in host itself, so your own DOM updates (in swap) can't collide with the overlay.
  • work is the real thing being waited for. The interlude's "wait" phase lasts exactly as long as work takes, plus one small floor (minWaitMs, default 300ms; small on purpose -- see "Timing options" below) so even an instant response gets one readable beat, and nothing about real work is held past its own completion.
  • swap runs exactly once, right as the wait ends (curtain still fully closed), wrapped in a same-document View Transition (packages/transitions/page.js), invisible in practice, since the curtain covers it, but free continuity if anything outside the curtain also uses named persistent elements.
  • The skip button is always present. Skipping before work finishes moves the curtain on without calling swap (there is nothing finished to show yet), check result.swapped and decide: most flows just await work themselves afterward and call swap() when it resolves, or show an error if the user left before it did.

The result

runKantar resolves to { skipped, workDone, swapped }:

skippedthe visitor pressed Skip
workDonework had resolved (successfully or not, either counts as "done") by the time the interlude ended
swappedwhether swap() ran

The registers

  • Quiet: no curtain theatre at all, a plain role="status" line, honestly held open for exactly as long as work takes. The charter's register table gives quiet no ornament; a tiatr curtain is not for an auditor.
  • Warm: the curtain, in its own ink.
  • Playful: the same curtain, in the playful palette (laterite through kokum).

Reduced motion takes the same plain path as quiet, in every register.

Timing options

OptionDefault
minWaitMs300the floor: work finishing sooner never ends the wait before this
curtainDown700how long the curtain takes to fall
curtainUp300how long it takes to rise
msPerLine2200how long each line of lines shows before the next, cycling if the wait runs long

minWaitMs is small by design: its only job is to keep genuinely instant work from flashing past before anyone can read it. It is measured from when the "wait" phase itself began, so once real work has taken any noticeable time, work resolving and the swap happening are effectively the same moment, nothing about a real wait is stretched. An earlier draft used 900ms for both minWaitMs and curtainUp, which could add several hundred milliseconds after 1-to-2-second work had already finished; a check now asserts the time from work resolving to the next step's heading being focused stays at or under 300ms.

Accessibility

  • The song line and the plain fallback are both role="status", so the spoken update is heard once, not lost.
  • The curtain itself is aria-hidden; nothing about the phase (down, waiting, rising) is shown only in the drawing.
  • Skip is a real <button>, reachable and operable by keyboard, always present.
  • No sound plays on its own (decision 0015). Any sound is the Wave 4 vocabulary, under the global switch.

After, what we took, what we left

After the sketchbook's Kantar plate: a tiatr stage where a singer stands in front of the curtain and sings while the set changes behind it, so the audience is never left staring at a stagehand.

What we took: the interlude as a structure, a three-phase timeline (down, wait, rise) where the middle phase is not a fixed song length, it genuinely tracks the real wait, and a skip always moves the show on. From the plate's own drawing, we took the curtain's folds and its hem's damped travelling ripple when it lands (hemWave, ported as arithmetic from the plate's curtain()), a gold pelmet trim standing in for the painted proscenium, the spotlight pool, and, in playful only, a singer's silhouette standing in it (singerSilhouette, the plate's own point-for-point figure, not a redrawn likeness). A first draft of this component left all of that out and drew a flat coloured box instead; it is back now, canvas-drawn every frame from these pure functions, phase-driven like everything else here. A second draft's own simplification of the figure (16 points instead of the plate's 21) quietly lost the shoulder, arm and hand detail that was Volume III's own second-round fix for "the singer read as a peg doll", restored verbatim after review, along with moving the spotlight line to a caption band below the stage floor, since the line and the figure's head shared the same centred anchor by construction and the line crossed the head every time. That fix still left the figure headless: the plate's singer() draws a head and a hair bun onto the same path as the body, a mic and stand, a blurred shadow thrown on the curtain, and a warm rim where the spot catches the edge: none of which the body's own 21 points include on their own. Restored verbatim in round 2 (singerHead, singerBun, singerMic), and the S3 clearance check now measures the head and bun's own extent too, not only the body polygon, so "no overlap" means the whole figure, not part of it.

What we left: the plate's full painted sets (the fields, hills and river behind the proscenium arch), and the tabla and the trumpet in the pit. This is a curtain, a pelmet, a spotlight and (in playful) the plate's own singer's silhouette, a stage implied, not fully built. A fuller staging remains a later, explicit decision.

The lines this demo ships are English placeholders, marked for review by a Konkani ear before anything using them leaves the repo (HOMAGE rule 7). The tiatr itself, and the singers and stage painters who kept it going for more than a century, are named here as a tradition, not a person; whether any one of its patrons can be named directly is for the Goan reviewer to say (rule 4).