primocode 10.16.0 → 10.17.1

package/editor/helpers/motion/templates/passos.py

@@ -0,0 +1,321 @@
+"""passos: a 2 to 4 step flow. Numbered circles light up one by one, joined by arrows that draw themselves.
+
+Frame 0 already shows the card and the steps as faint placeholders (the shape of the flow). Each step then
+pops in the accent color with a pulse ring and its name rises underneath (or beside it, vertically). The
+arrow into a step draws during the moment before that step lights up, so the eye travels along the flow.
+Timing: `delay` + `stagger`, or `times` (one second per step, counted from the item start).
+"""
+
+from __future__ import annotations
+
+import json
+from functools import lru_cache
+
+from motion import engine as E
+from motion.engine import MotionError
+
+TEMPLATE = {
+    "id": "passos",
+    "label_pt": "Passo a passo",
+    "description_pt": "De 2 a 4 passos em círculos numerados, ligados por setas que se desenham de um para o outro. "
+                      "Cada passo acende na cor de destaque, com o nome embaixo (ou ao lado, na vertical).",
+    "use_when_pt": "Quando a fala descreve um processo curto: comprou, acessou, usou. Compra, conecta, usa. "
+                   "Para cada passo acender junto com a fala, use times (segundos desde o começo do item).",
+    "notes_pt": "Nomes curtos (uma ou duas palavras) leem melhor. A região padrão é uma faixa no alto da tela, "
+                "acima do rosto; na vertical os passos ficam mais altos: use a região centro ou baixo.",
+    "category": "fluxos",
+    "version": 1,
+    "params": {
+        "items": {"type": "list", "item": {"type": "text", "max_len": 20, "required_text": True},
+                  "min_items": 2, "max_items": 4, "default": ["Comprou", "Acessou", "Usou"],
+                  "label_pt": "Nome de cada passo, na ordem (2 a 4, cada um com até 20 letras)"},
+        "title": {"type": "text", "default": "", "max_len": 36,
+                  "label_pt": "Título em cima dos passos (opcional). *Palavra* entre asteriscos fica na cor de "
+                              "destaque"},
+        "direction": {"type": "choice", "choices": ["horizontal", "vertical"], "default": "horizontal",
+                      "label_pt": "Passos lado a lado (horizontal) ou um embaixo do outro (vertical)"},
+        "icon": {"type": "choice", "choices": ["numero", "check"], "default": "numero",
+                 "label_pt": "Dentro do círculo: o número do passo ou um check"},
+        "delay": {"type": "number", "default": 0.1, "min": 0, "max": 30,
+                  "label_pt": "Segundos até o primeiro passo acender"},
+        "stagger": {"type": "number", "default": 0.6, "min": 0.15, "max": 5,
+                    "label_pt": "Segundos entre um passo e o próximo"},
+        "times": {"type": "list", "item": {"type": "number", "min": 0, "max": 60}, "nullable": True,
+                  "default": None, "min_items": 2, "max_items": 4,
+                  "label_pt": "Segundo em que cada passo acende, contado do começo do item (um por passo, em "
+                              "ordem crescente). Vazio: usa delay e stagger"},
+        "size": {"type": "choice", "choices": ["normal", "grande"], "default": "normal",
+                 "label_pt": "Tamanho dos círculos e dos nomes"},
+        "card": {"type": "bool", "default": True,
+                 "label_pt": "Cartão atrás dos passos (sem cartão: contorno e sombra)"},
+    },
+    "default_duration": 3.0,
+    "default_region": [90, 240, 900, 330],
+    "sfx": [{"at": 0.1, "name": "pop"}, {"at": 0.7, "name": "pop"}, {"at": 1.3, "name": "pop"}],
+    "example": {"items": ["Compra", "Conecta", "Usa"], "title": "Simples *assim*:"},
+}
+
+LABEL_FONT = "text_bold"
+TITLE_FONT = "sans_black"
+NUM_FONT = "sans_black"
+BASE_R = {"normal": 56.0, "grande": 66.0}
+BASE_LABEL = {"normal": 46.0, "grande": 54.0}
+MIN_LABEL = 30.0
+MAX_COL = 270.0
+
+SKELETON = -0.08       # the empty markers start before frame 0, so frame 0 always shows them
+ENTER = 0.5
+POP = 0.42             # circle pop (out_back)
+ARROW = 0.34           # longest arrow draw, ending when the next step lights up
+RING = 0.6             # pulse ring after a pop
+LABEL_AT = 0.06
+LABEL_IN = 0.34
+
+
+def _times(p: dict) -> list[float]:
+    n = len(p["items"])
+    times = p.get("times")
+    if times is None:
+        return [p["delay"] + i * p["stagger"] for i in range(n)]
+    if len(times) != n:
+        raise MotionError(f"passos.params.times precisa de um tempo para cada passo ({n} passos, veio {len(times)})")
+    for i in range(1, n):
+        if times[i] < times[i - 1]:
+            raise MotionError(f"passos.params.times precisa estar em ordem crescente (o passo {i + 1} acende em "
+                              f"{times[i]:g} s, antes do passo {i} em {times[i - 1]:g} s)")
+    return [float(v) for v in times]
+
+
+def validate(params: dict) -> None:
+    """One time per item, in order: refused when the item is planned, not only when it renders."""
+    _times(params)
+
+
+def warnings(params: dict, box: E.Box) -> list[str]:
+    L = _layout(json.dumps(params, sort_keys=True), box)
+    if L["vertical"] and L["R"] < BASE_R[params["size"]] * 0.8:
+        return [f"os passos na vertical ficaram menores porque a região tem só {box.h:.0f} px de altura; "
+                f"use a região tela, uma região mais alta ou menos passos"]
+    return []
+
+
+def _arrow_window(times: list[float], i: int) -> tuple[float, float]:
+    """(start, duration) of the arrow that leads into step i (i >= 1)."""
+    end = times[i]
+    start = max(times[i - 1] + 0.12, end - ARROW)
+    return min(start, end), max(0.0, end - start)
+
+
+def _title_block(title: str, width: float, size: float) -> tuple[float, float, float]:
+    """(size, cap, width) of the title line."""
+    if not title:
+        return 0.0, 0.0, 0.0
+    plain = " ".join(w for w, _ in E.parse_accent(title))
+    ts = E.fit_text(plain, TITLE_FONT, width, size, 26.0)
+    return ts, E.measure("H", TITLE_FONT, ts).cap, E.measure(plain, TITLE_FONT, ts).width
+
+
+def _fit_labels(items: list[str], size: float, width: float, max_lines: int) -> tuple[float, list[list[str]]]:
+    """Largest common label size (<= size) where every label fits `width` in at most max_lines."""
+    s = size
+    while True:
+        wraps = [E.wrap_text(it, LABEL_FONT, s, width, max_lines) for it in items]
+        widest = max(E.measure(ln, LABEL_FONT, s).width for lines in wraps for ln in lines)
+        if widest <= width + 0.5 or s <= MIN_LABEL:
+            break
+        s = max(MIN_LABEL, s * 0.95)
+    if widest > width + 0.5:          # one long word: shrink below the floor rather than overflow
+        s = min(E.fit_text(ln, LABEL_FONT, width, s, 20.0) for lines in wraps for ln in lines)
+        wraps = [E.wrap_text(it, LABEL_FONT, s, width, max_lines) for it in items]
+    return s, wraps
+
+
+@lru_cache(maxsize=64)
+def _layout(params_json: str, box: E.Box) -> dict:
+    p = json.loads(params_json)
+    items = p["items"]
+    n = len(items)
+    card = p["card"]
+    title = p["title"].strip()
+    pad_x = 36.0 if card else 4.0
+    pad_y = 38.0 if card else 4.0
+    R = BASE_R[p["size"]]
+    lab = BASE_LABEL[p["size"]]
+    steps = []
+    if p["direction"] == "horizontal":
+        col = min(MAX_COL, (box.w - 2 * pad_x) / n)
+        R = min(R, col * 0.30)
+        ts, tcap, tw = _title_block(title, box.w - 2 * pad_x, lab * 1.12)
+        title_h = tcap + lab * 0.62 if title else 0.0
+        lab_size, wraps = _fit_labels(items, lab, col - 14.0, 2)
+        cap = E.measure("H", LABEL_FONT, lab_size).cap
+        line_h = lab_size * 1.14
+        lines = max(len(w) for w in wraps)
+        gap = R * 0.40
+        # a label block leaves room for descenders (p, g, ç)
+        lab_h = cap + (lines - 1) * line_h + lab_size * 0.22
+        content_h = title_h + 2 * R + gap + lab_h
+        needed = content_h + 2 * pad_y
+        if needed > box.h:                       # a short region: shrink circles and labels together
+            k = max(0.55, (box.h - 2 * pad_y) / content_h)
+            R *= k
+            gap *= k
+            lab_size, wraps = _fit_labels(items, max(MIN_LABEL * 0.9, lab_size * k), col - 14.0, 2)
+            cap = E.measure("H", LABEL_FONT, lab_size).cap
+            line_h = lab_size * 1.14
+            lab_h = cap + (lines - 1) * line_h + lab_size * 0.22
+            ts, tcap, tw = _title_block(title, box.w - 2 * pad_x, min(ts, lab_size * 1.12))
+            title_h = tcap + lab_size * 0.62 if title else 0.0
+            content_h = title_h + 2 * R + gap + lab_h
+        content_w = col * n
+        card_w = min(box.w, max(content_w, tw) + 2 * pad_x)
+        card_h = content_h + 2 * pad_y
+        cx0 = (box.w - card_w) / 2.0
+        cy0 = (box.h - card_h) / 2.0
+        top = cy0 + pad_y
+        left = (box.w - content_w) / 2.0
+        cy = top + title_h + R
+        for i in range(n):
+            x = left + col * (i + 0.5)
+            steps.append({"cx": x, "cy": cy, "lines": wraps[i], "anchor": "ms",
+                          "lx": x, "ly": cy + R + gap + cap})
+        g = R * 0.30
+        arrows = [((steps[i - 1]["cx"] + R + g, cy), (steps[i]["cx"] - R - g, cy)) for i in range(1, n)]
+        title_pos = (box.w / 2.0, top + tcap, "ms")
+    else:
+        ts, tcap, tw = _title_block(title, box.w - 2 * pad_x, lab * 1.12)
+        title_h = tcap + lab * 0.70 if title else 0.0
+        ratio = 1.2                              # arrow length in circle radii
+        content_h = title_h + n * 2 * R + (n - 1) * ratio * R
+        if content_h > box.h - 2 * pad_y:
+            # a short region: tighter card padding, then shorter arrows, then smaller circles (never below 45%)
+            pad_y = min(pad_y, 18.0)
+            avail = box.h - 2 * pad_y - title_h
+            k = avail / ((n * 2 + (n - 1) * ratio) * R)
+            if k < 0.6:
+                ratio = 0.6
+                k = avail / ((n * 2 + (n - 1) * ratio) * R)
+            R *= max(0.45, min(1.0, k))
+        arrow_len = ratio * R
+        content_h = title_h + n * 2 * R + (n - 1) * arrow_len
+        gap = max(R * 0.45, 20.0)
+        lab_size = min(lab * 1.12, max(MIN_LABEL, R * 1.05))
+        lab_w = box.w - 2 * pad_x - 2 * R - gap
+        lab_size, wraps = _fit_labels(items, lab_size, lab_w, 1)
+        cap = E.measure("H", LABEL_FONT, lab_size).cap
+        widest = max(E.measure(w[0], LABEL_FONT, lab_size).width for w in wraps)
+        content_w = 2 * R + gap + widest
+        card_w = min(box.w, max(content_w, tw) + 2 * pad_x, box.w)
+        card_w = max(card_w, min(box.w, 420.0 if card else 0.0))
+        card_h = content_h + 2 * pad_y
+        cx0 = (box.w - card_w) / 2.0
+        cy0 = (box.h - card_h) / 2.0
+        top = cy0 + pad_y
+        left = cx0 + pad_x
+        if not title or tw <= content_w:
+            left = (box.w - content_w) / 2.0
+        x = left + R
+        for i in range(n):
+            cy = top + title_h + R + i * (2 * R + arrow_len)
+            steps.append({"cx": x, "cy": cy, "lines": wraps[i], "anchor": "ls",
+                          "lx": x + R + gap, "ly": cy + cap / 2.0})
+        g = R * 0.16
+        arrows = [((x, steps[i - 1]["cy"] + R + g), (x, steps[i]["cy"] - R - g)) for i in range(1, n)]
+        title_pos = (cx0 + card_w / 2.0, top + tcap, "ms")
+    return {
+        "steps": steps, "arrows": arrows, "R": R, "lab_size": lab_size, "line_h": lab_size * 1.14,
+        "card_box": (cx0, cy0, card_w, card_h), "radius": min(40.0, card_h * 0.24), "card": card,
+        "title": title, "title_size": ts, "title_pos": title_pos, "times": _times(p), "icon": p["icon"],
+        "vertical": p["direction"] == "vertical",
+    }
+
+
+def render(frame_index: int, fps: int, params: dict, box: E.Box) -> E.Canvas:
+    cv = E.Canvas(box)
+    t = frame_index / fps
+    t_in = t + 1.0 / fps
+    L = _layout(json.dumps(params, sort_keys=True), box)
+    card = L["card"]
+    R = L["R"]
+    times = L["times"]
+    ink = "text" if card else "white"
+    outline = {} if card else {"stroke": L["lab_size"] * 0.07, "stroke_color": "black", "shadow": E.TEXT_SHADOW}
+    circle_shadow = E.Shadow(blur=12.0, dy=5.0, opacity=0.35 if card else 0.55)
+    arrow_shadow = None if card else E.Shadow(blur=6.0, dy=2.0, opacity=0.5)
+    arrow_color = "muted" if card else (255, 255, 255, 235)
+
+    alpha = E.eased(t_in, 0.0, 0.18, "out_quad")
+    scale = 0.92 + 0.08 * E.out_back(E.progress(t_in, 0.0, ENTER), 1.4)
+    rise = 26.0 * (1.0 - E.eased(t_in, 0.0, 0.45))
+    with cv.group(opacity=alpha, scale=scale, dy=rise):
+        if card:
+            x, y, w, h = L["card_box"]
+            cv.card(x, y, w, h, radius=L["radius"])
+        if L["title"]:
+            tx, ty, anchor = L["title_pos"]
+            cv.rich_text(tx, ty, L["title"], TITLE_FONT, L["title_size"], color=ink, anchor=anchor, **outline)
+        # arrows first: circles sit on top of their ends
+        for i, (a, b) in enumerate(L["arrows"], start=1):
+            start, dur = _arrow_window(times, i)
+            prog = E.eased(t, start, dur, "in_out_cubic") if dur > 0 else (1.0 if t >= start else 0.0)
+            if prog > 0:
+                cv.arrow(a[0], a[1], b[0], b[1], width=max(4.0, R * 0.13), color=arrow_color, progress=prog,
+                         head=max(14.0, R * 0.34), shadow=arrow_shadow)
+        for i, st in enumerate(L["steps"]):
+            ti = times[i]
+            cx, cy = st["cx"], st["cy"]
+            pop_p = E.progress(t_in, ti, POP)
+            # placeholder: the faint step that is waiting
+            sk = E.out_back(E.progress(t_in, SKELETON + 0.06 * i, 0.36), 1.6)
+            if sk > 0.01 and pop_p < 1.0:
+                with cv.group(scale=max(0.01, sk), pivot=(cx, cy)):
+                    if card:
+                        cv.circle(cx, cy, R, fill="track")
+                    else:
+                        cv.circle(cx, cy, R, fill=(0, 0, 0, 120), stroke=(255, 255, 255, 200),
+                                  stroke_width=max(2.0, R * 0.06))
+                    if L["icon"] == "numero":
+                        cv.text(cx, cy, str(i + 1), NUM_FONT, R * 0.95, color=ink, opacity=0.45, anchor="mc")
+            if pop_p <= 0:
+                continue
+            # pulse ring
+            e = E.eased(t, ti, RING, "out_cubic")
+            if 0 < e < 1:
+                cv.ring(cx, cy, R * (1.0 + 0.5 * e), max(2.0, R * 0.08 * (1.0 - e) + 1.0), color="accent",
+                        opacity=0.7 * (1.0 - e))
+            with cv.group(scale=max(0.01, E.out_back(pop_p, 2.0)), pivot=(cx, cy)):
+                cv.circle(cx, cy, R, fill="accent", shadow=circle_shadow)
+                if L["icon"] == "numero":
+                    cv.text(cx, cy, str(i + 1), NUM_FONT, R * 0.95, color="on_accent", anchor="mc")
+            if L["icon"] == "check":
+                draw = E.eased(t, ti + 0.08, 0.26, "in_out_cubic")
+                if draw > 0:
+                    cv.check(cx, cy + R * 0.03, R * 0.98, width=R * 0.19, color="on_accent", progress=draw)
+            la = E.eased(t, ti + LABEL_AT, LABEL_IN, "out_cubic")
+            if cv.visible(la):
+                off = 14.0 * (1.0 - la)
+                for k, ln in enumerate(st["lines"]):
+                    if L["vertical"]:
+                        cv.text(st["lx"] - off, st["ly"], ln, LABEL_FONT, L["lab_size"], color=ink, opacity=la,
+                                anchor="ls", **outline)
+                    else:
+                        cv.text(st["lx"], st["ly"] + k * L["line_h"] + off, ln, LABEL_FONT, L["lab_size"],
+                                color=ink, opacity=la, anchor="ms", **outline)
+    return cv
+
+
+def sfx(params: dict, fps: int, frames: int) -> list[dict]:
+    return [{"frame": E.frame_of(ti, fps), "name": "pop", "why": f"passo {i + 1}"}
+            for i, ti in enumerate(_times(params))]
+
+
+def suggested_duration(params: dict) -> float:
+    """Last step, its label and about 1.5 s to read the flow."""
+    return round(max(TEMPLATE["default_duration"], _times(params)[-1] + max(POP, LABEL_AT + LABEL_IN) + 1.5), 2)
+
+
+def settle(params: dict, fps: int) -> float:
+    times = _times(params)
+    n = len(times)
+    return max(ENTER, SKELETON + 0.06 * (n - 1) + 0.36,
+               times[-1] + max(POP, RING, LABEL_AT + LABEL_IN, 0.08 + 0.26)) + 0.05

package/editor/helpers/motion/templates/riscado.py

@@ -0,0 +1,298 @@
+"""riscado: items appear on a card, then each one gets crossed out (a red strike line or a red X).
+
+For "você não precisa de...": the list builds first (`delay` + `stagger`, or `times`), then the items are
+crossed one by one (`cross_delay` + `cross_stagger`, or `cross_times`). A crossed item fades to half.
+Frame 0 already shows the card, the title and the empty markers.
+"""
+
+from __future__ import annotations
+
+import json
+import math
+from functools import lru_cache
+
+from motion import engine as E
+from motion.engine import MotionError
+
+TEMPLATE = {
+    "id": "riscado",
+    "label_pt": "Lista riscada",
+    "description_pt": "Uma lista num cartão em que os itens aparecem e depois são riscados um a um, com uma linha "
+                      "vermelha por cima do texto ou um X vermelho no lugar do marcador.",
+    "use_when_pt": "Quando a fala derruba objeções ou crenças: você não precisa de estoque, de aparecer, de "
+                   "investir alto. Para riscar junto com a fala, use cross_times (segundos desde o começo do item).",
+    "notes_pt": "Itens curtos leem melhor (até 32 letras). Sem título, o cartão mostra só a lista.",
+    "category": "listas",
+    "version": 1,
+    "params": {
+        "items": {"type": "list", "item": {"type": "text", "max_len": 32, "required_text": True},
+                  "min_items": 1, "max_items": 6,
+                  "default": ["Ter estoque", "Aparecer nos vídeos", "Investir alto"],
+                  "label_pt": "Itens que vão ser riscados, de cima para baixo (1 a 6, cada um com até 32 letras)"},
+        "title": {"type": "text", "default": "Você *não* precisa de:", "max_len": 36,
+                  "label_pt": "Título em cima da lista (vazio: sem título). *Palavra* entre asteriscos fica na "
+                              "cor de destaque"},
+        "mode": {"type": "choice", "choices": ["linha", "x"], "default": "linha",
+                 "label_pt": "Como riscar: linha (traço vermelho por cima do texto) ou x (X vermelho no marcador)"},
+        "delay": {"type": "number", "default": 0.2, "min": 0, "max": 30,
+                  "label_pt": "Segundos até o primeiro item aparecer (o cartão já aparece no começo)"},
+        "stagger": {"type": "number", "default": 0.3, "min": 0.1, "max": 5,
+                    "label_pt": "Segundos entre um item aparecer e o próximo"},
+        "times": {"type": "list", "item": {"type": "number", "min": 0, "max": 60}, "nullable": True,
+                  "default": None, "min_items": 1, "max_items": 6,
+                  "label_pt": "Segundo em que cada item aparece, contado do começo do item (um por item, em ordem "
+                              "crescente). Vazio: usa delay e stagger"},
+        "cross_delay": {"type": "number", "default": 0.55, "min": 0, "max": 30,
+                        "label_pt": "Segundos entre o último item aparecer e o primeiro risco"},
+        "cross_stagger": {"type": "number", "default": 0.4, "min": 0.1, "max": 5,
+                          "label_pt": "Segundos entre um risco e o próximo"},
+        "cross_times": {"type": "list", "item": {"type": "number", "min": 0, "max": 60}, "nullable": True,
+                        "default": None, "min_items": 1, "max_items": 6,
+                        "label_pt": "Segundo em que cada item é riscado, contado do começo do item (um por item, "
+                                    "depois de ele aparecer). Vazio: usa cross_delay e cross_stagger"},
+        "size": {"type": "choice", "choices": ["normal", "grande"], "default": "normal",
+                 "label_pt": "Tamanho do texto"},
+        "card": {"type": "bool", "default": True,
+                 "label_pt": "Cartão atrás da lista (sem cartão: texto com contorno e sombra)"},
+    },
+    "default_duration": 3.5,
+    "default_region": "baixo",
+    "sfx": [{"at": 0.0, "name": "pop"}, {"at": 1.47, "name": "tick", "volume": 1.2},
+            {"at": 1.87, "name": "tick", "volume": 1.2}, {"at": 2.27, "name": "tick", "volume": 1.2}],
+    "example": {"title": "Você *não* precisa de:",
+                "items": ["Ter estoque", "Aparecer nos vídeos", "Investir alto", "Experiência"]},
+}
+
+FONT = "text_bold"
+TITLE_FONT = "sans_black"
+BASE_SIZE = {"normal": 56.0, "grande": 68.0}
+MIN_SIZE = 34.0
+
+SKELETON = -0.08       # the empty markers start before frame 0, so frame 0 always shows them
+ENTER = 0.5            # card entrance
+ROW_IN = 0.32          # item slide and fade
+STRIKE = 0.30          # the strike line draws (per item, all its lines)
+X_POP = 0.38           # the red marker pops
+X_DRAW = 0.24          # the X strokes draw
+DIM_AT = 0.12          # the text starts fading this long after the cross starts
+DIM = 0.30
+DIM_TO = 0.5           # opacity of a crossed text
+SOUND_AT = {"linha": 0.12, "x": 0.04}    # the sound lands when the stroke is visibly under way
+
+
+def _times(p: dict) -> tuple[list[float], list[float]]:
+    """(appear times, cross times), validated."""
+    n = len(p["items"])
+    times = p.get("times")
+    if times is None:
+        shown = [p["delay"] + i * p["stagger"] for i in range(n)]
+    else:
+        if len(times) != n:
+            raise MotionError(f"riscado.params.times precisa de um tempo para cada item ({n} itens, veio {len(times)})")
+        for i in range(1, n):
+            if times[i] < times[i - 1]:
+                raise MotionError(f"riscado.params.times precisa estar em ordem crescente (o item {i + 1} aparece "
+                                  f"em {times[i]:g} s, antes do item {i} em {times[i - 1]:g} s)")
+        shown = [float(v) for v in times]
+    crosses = p.get("cross_times")
+    if crosses is None:
+        first = shown[-1] + p["cross_delay"]
+        crossed = [first + i * p["cross_stagger"] for i in range(n)]
+    else:
+        if len(crosses) != n:
+            raise MotionError(f"riscado.params.cross_times precisa de um tempo para cada item ({n} itens, "
+                              f"veio {len(crosses)})")
+        for i, (a, c) in enumerate(zip(shown, crosses)):
+            if c < a:
+                raise MotionError(f"riscado.params.cross_times: o item {i + 1} aparece em {a:g} s e seria riscado "
+                                  f"antes, em {c:g} s. Cada risco precisa vir depois de o item aparecer")
+        crossed = [float(v) for v in crosses]
+    return shown, crossed
+
+
+def validate(params: dict) -> None:
+    """One time per item, in order: refused when the item is planned, not only when it renders."""
+    _times(params)
+
+
+@lru_cache(maxsize=64)
+def _layout(params_json: str, box: E.Box) -> dict:
+    p = json.loads(params_json)
+    items = p["items"]
+    card = p["card"]
+    mode = p["mode"]
+    title = p["title"].strip()
+    title_plain = " ".join(w for w, _ in E.parse_accent(title))
+    pad_x = 54.0 if card else 6.0
+    pad_y = 48.0 if card else 6.0
+
+    def build(size: float) -> tuple[dict, bool]:
+        marker = size * (1.04 if mode == "x" else 0.30)
+        gap = size * (0.44 if mode == "x" else 0.50)
+        text_w = box.w - 2 * pad_x - marker - gap - size * 0.12     # the strike runs a little past the text
+        m = E.measure("H", FONT, size)
+        line_h = size * 1.17
+        row_gap = size * 0.46
+        slot = size * 1.04            # row height of a one-line item (same rhythm in both modes)
+        rows, fits, y = [], True, 0.0
+        title_size = title_w = 0.0
+        if title:
+            title_size = min(size * 0.94, E.fit_text(title_plain, TITLE_FONT, box.w - 2 * pad_x, size * 0.94, 26.0))
+            title_w = E.measure(title_plain, TITLE_FONT, title_size).width
+            y = E.measure("H", TITLE_FONT, title_size).cap + size * 0.74
+        widest = 0.0
+        for k, text in enumerate(items):
+            lines = E.wrap_text(text, FONT, size, text_w, 2)
+            sizes = []
+            for ln in lines:
+                if E.measure(ln, FONT, size).width > text_w + 0.5:
+                    fits = False
+                    sizes.append(E.fit_text(ln, FONT, text_w, size, 20.0))
+                else:
+                    sizes.append(size)
+            widths = [E.measure(ln, FONT, s).width for ln, s in zip(lines, sizes)]
+            widest = max(widest, max(widths))
+            base0 = y + slot / 2.0 + m.cap / 2.0
+            bottom = max(y + slot, base0 + (len(lines) - 1) * line_h)
+            rows.append({"lines": lines, "sizes": sizes, "widths": widths, "cy": y + slot / 2.0, "base0": base0})
+            y = bottom + (row_gap if k < len(items) - 1 else 0.0)
+        card_h = y + 2 * pad_y
+        content_w = max(marker + gap + widest + size * 0.12, title_w)
+        card_w = min(box.w, max(content_w + 2 * pad_x, 380.0 if card else 0.0))
+        L = {"size": size, "marker": marker, "gap": gap, "line_h": line_h, "rows": rows, "x_height": m.x_height,
+             "title_size": title_size, "title_base": E.measure("H", TITLE_FONT, title_size).cap if title else 0.0,
+             "card_w": card_w, "card_h": card_h}
+        return L, fits and card_h <= box.h
+
+    size = BASE_SIZE[p["size"]]
+    L, ok = build(size)
+    while not ok and size > MIN_SIZE:
+        size = max(MIN_SIZE, size * 0.95)
+        L, ok = build(size)
+    card_x = (box.w - L["card_w"]) / 2.0
+    card_y = (box.h - L["card_h"]) / 2.0
+    L.update({"card_box": (card_x, card_y, L["card_w"], L["card_h"]), "x0": card_x + pad_x, "y0": card_y + pad_y,
+              "radius": min(40.0, L["card_h"] * 0.2), "title": title, "card": card, "mode": mode})
+    L["shown"], L["crossed"] = _times(p)
+    # strike geometry per item: one stroke per line, a slight upward slant and bow like a marker
+    for k, row in enumerate(L["rows"]):
+        strokes = []
+        for j, (w, sz) in enumerate(zip(row["widths"], row["sizes"])):
+            xh = E.measure("x", FONT, sz).x_height
+            y = row["base0"] + j * L["line_h"] - xh * 0.52
+            x_a = -sz * 0.04
+            x_b = w + sz * 0.10
+            slant = min(sz * 0.07, (x_b - x_a) * 0.04) * (1 if (k + j) % 2 == 0 else 0.6)
+            pts = E.bezier_points((x_a, y + slant), ((x_a + x_b) / 2.0, y + sz * 0.025), (x_b, y - slant), n=16)
+            strokes.append({"points": pts, "width": sz * 0.16, "length": E.path_length(pts)})
+        row["strokes"] = strokes
+    return L
+
+
+def render(frame_index: int, fps: int, params: dict, box: E.Box) -> E.Canvas:
+    cv = E.Canvas(box)
+    t = frame_index / fps
+    t_in = t + 1.0 / fps
+    L = _layout(json.dumps(params, sort_keys=True), box)
+    card, mode = L["card"], L["mode"]
+    size, d = L["size"], L["marker"]
+
+    alpha = E.eased(t_in, 0.0, 0.18, "out_quad")
+    scale = 0.9 + 0.1 * E.out_back(E.progress(t_in, 0.0, ENTER), 1.4)
+    rise = 32.0 * (1.0 - E.eased(t_in, 0.0, 0.45))
+    outline = {} if card else {"stroke": size * 0.07, "stroke_color": "black", "shadow": E.TEXT_SHADOW}
+    ink = "text" if card else "white"          # no card: white letters with a black outline in both themes
+    empty = "track" if card else (255, 255, 255, 215)
+    strike_shadow = E.Shadow(blur=6.0, dy=2.0, opacity=0.35 if card else 0.55)
+
+    with cv.group(opacity=alpha, scale=scale, dy=rise):
+        cx0, cy0, cw, ch = L["card_box"]
+        if card:
+            cv.card(cx0, cy0, cw, ch, radius=L["radius"])
+        x0, y0 = L["x0"], L["y0"]
+        if L["title"]:
+            cv.rich_text(x0, y0 + L["title_base"], L["title"], TITLE_FONT, L["title_size"], color=ink, **outline)
+        mx = x0 + d / 2.0
+        tx = x0 + d + L["gap"]
+        for i, row in enumerate(L["rows"]):
+            ts, tc = L["shown"][i], L["crossed"][i]
+            cy = y0 + row["cy"]
+            sk = E.out_back(E.progress(t_in, SKELETON + 0.05 * i, 0.34), 1.8)
+            if mode == "x":
+                pop_p = E.progress(t, tc, X_POP)
+                if sk > 0.01 and pop_p < 1.0:
+                    with cv.group(scale=max(0.01, sk), pivot=(mx, cy)):
+                        w = d * 0.085
+                        if not card:
+                            cv.ring(mx, cy, d / 2 - w / 2, w * 2.8, color=(0, 0, 0, 120))
+                        cv.ring(mx, cy, d / 2 - w / 2, w, color=empty)
+                if pop_p > 0:
+                    with cv.group(scale=max(0.01, E.out_back(pop_p, 2.2)), pivot=(mx, cy)):
+                        cv.circle(mx, cy, d / 2, fill="danger",
+                                  shadow=None if card else E.Shadow(blur=10.0, dy=4.0, opacity=0.5))
+                    draw = E.eased(t, tc + 0.05, X_DRAW, "in_out_cubic")
+                    if draw > 0:
+                        cv.cross(mx, cy, d * 0.36, width=d * 0.12, color="white", progress=draw)
+            else:
+                if sk > 0.01:
+                    dot = d / 2.0 * max(0.01, sk)
+                    turn = E.eased(t, tc, STRIKE * 0.6)
+                    if not card:
+                        cv.circle(mx, cy, dot + 2.5, fill=(0, 0, 0, 120))
+                    if turn < 1:
+                        cv.circle(mx, cy, dot, fill=empty if card else (255, 255, 255, 230))
+                    if turn > 0:
+                        cv.circle(mx, cy, dot, fill="danger", opacity=turn)
+            # the text: slides in, then fades to half once crossed
+            a = E.eased(t, ts, ROW_IN, "out_cubic")
+            if cv.visible(a):
+                dim = 1.0 - (1.0 - DIM_TO) * E.eased(t, tc + DIM_AT, DIM, "out_quad")
+                dx = -min(L["gap"] * 0.8, 18.0) * (1.0 - a)
+                dy = 10.0 * (1.0 - a)
+                for k, (ln, sz) in enumerate(zip(row["lines"], row["sizes"])):
+                    cv.text(tx + dx, y0 + row["base0"] + k * L["line_h"] + dy, ln, FONT, sz, color=ink,
+                            opacity=a * dim, **outline)
+            if mode == "linha" and t >= tc:
+                p = E.eased(t, tc, STRIKE, "in_out_cubic")
+                total = sum(s["length"] for s in row["strokes"]) or 1.0
+                done = 0.0
+                for s in row["strokes"]:
+                    part = E.clamp01((p * total - done) / max(1e-6, s["length"]))
+                    done += s["length"]
+                    if part <= 0:
+                        break
+                    pts = [(tx + u, y0 + v) for u, v in s["points"]]
+                    n = len(pts)
+                    widths = [s["width"] * (0.78 + 0.22 * math.sin(math.pi * min(1.0, k / (n - 1) * 1.15)))
+                              for k in range(n)]
+                    cv.polyline(pts, s["width"], color="danger", progress=part, widths=widths, shadow=strike_shadow)
+    return cv
+
+
+def sfx(params: dict, fps: int, frames: int) -> list[dict]:
+    _, crossed = _times(params)
+    mode = params["mode"]
+    cues = [{"at": 0.0, "name": "pop", "why": "entrada do cartão"}]
+    for i, tc in enumerate(crossed):
+        if mode == "x":
+            cues.append({"at": tc + SOUND_AT["x"], "name": "error", "volume": 0.7, "why": f"X no item {i + 1}"})
+        else:
+            cues.append({"at": tc + SOUND_AT["linha"], "name": "tick", "volume": 1.2, "why": f"risco no item {i + 1}"})
+    return [{"frame": E.frame_of(c.pop("at"), fps), **c} for c in cues]
+
+
+def _end(params: dict) -> float:
+    shown, crossed = _times(params)
+    n = len(params["items"])
+    last_cross = max(crossed)
+    return max(ENTER, SKELETON + 0.05 * (n - 1) + 0.34, shown[-1] + ROW_IN,
+               last_cross + max(STRIKE, X_POP, 0.05 + X_DRAW, DIM_AT + DIM))
+
+
+def suggested_duration(params: dict) -> float:
+    """Every item crossed and about 1.2 s to take it in."""
+    return round(max(TEMPLATE["default_duration"], _end(params) + 1.2), 2)
+
+
+def settle(params: dict, fps: int) -> float:
+    return _end(params) + 0.05