@nodaro/prompts 1.26.1 → 1.28.0

package/src/__tests__/transitions-scope.test.ts

@@ -20,9 +20,12 @@ const INSTANT_IDS = TRANSITIONS.filter((t) => t.instant).map((t) => t.id)
 const NON_INSTANT_IDS = TRANSITIONS.filter((t) => !t.instant && t.id !== "auto").map((t) => t.id)
 const FULL_CLAUSE = "the transition spans the entire clip"
 const FULL_SHOT_CLAUSE = "the transition spans this entire shot"
-const MATCH_CUT_BASE =
-  "match cut (the final composition of the first shot matches the opening composition of the second shot " +
-  "in shape, color, and motion, so the cut feels like a visual rhyme; " + INSTANT_CUT_CLAUSE + ")"
+const MATCH_CUT_BODY =
+  "the last picture of the first shot and the first picture of the second share one shape, at the same " +
+  "place and the same size in the frame. The camera holds that shape in place across the cut. On the ne" +
+  "xt frame everything around the shape has changed while the shape itself stays put. The shot ends on " +
+  "the second shot, fully resolved, with no flash frame or zoom between the two"
+const MATCH_CUT_BASE = `match cut (${MATCH_CUT_BODY}; ${INSTANT_CUT_CLAUSE})`
 
 describe("approved row bodies", () => {
   it("aging", () => {
@@ -57,11 +60,8 @@ describe("approved row bodies", () => {
     )
   })
 
-  it("zoom-into-mouth drops only 'the throat'", () => {
-    expect(getTransitionPromptHint("zoom-into-mouth")).toBe(
-      "the camera pushes into the subject's open mouth, the dark interior fills the frame, and the camera passes " +
-        "through into the new scene which materialises as if emerging from inside the body",
-    )
+  it("zoom-into-mouth never mentions 'the throat' (its body is pinned in the F5 block below)", () => {
+    expect(getTransitionPromptHint("zoom-into-mouth")).not.toContain("throat")
   })
 })
 
@@ -184,6 +184,591 @@ describe("F2 + vortex bodies (2026-09-25 A/B: F2 arm B, vortex rework D2)", () =
   })
 })
 
+describe("F3 bodies (2026-09-25 A/B: F3 arm B)", () => {
+  // sun-glare, lens-crack and lightning-flash: the F3 drafts, tidied (first letter lower-cased, final
+  // full stop dropped). Each rendered string below is byte-identical to the clause the winning take was
+  // generated from.
+  const F3_BODIES: Record<string, { term: string; body: string }> = {
+    "sun-glare": {
+      term: "sun glare",
+      body:
+        "intense warm glare floods the lens from one corner of the frame, blooming and scattering flares unti" +
+        "l the whole picture is washed out to a bright haze. The camera stays where it is and the framing doe" +
+        "s not change. As the glare fades, the second shot emerges through the haze. The shot ends on the sec" +
+        "ond shot, clear and fully resolved, with no glare left. The glare comes from the lens itself, and th" +
+        "e second shot appears only as the haze clears",
+    },
+    "lens-crack": {
+      term: "lens crack",
+      body:
+        "a hairline crack snaps diagonally across the lens and branches into a web of fracture lines that spr" +
+        "eads over the whole picture. The camera stays where it is and the framing does not change. Seen thro" +
+        "ugh the cracks, the first shot gives way to the second shot, and then the fracture lines fade away. " +
+        "The shot ends on the second shot, clear and fully resolved, with no cracks left. The cracks form on " +
+        "the lens itself, while everything behind them stays whole",
+    },
+    "lightning-flash": {
+      term: "lightning strike",
+      body:
+        "a brilliant jagged bolt of lightning cracks across the frame and its flash turns the whole picture w" +
+        "hite. The camera stays where it is and the framing does not change. As the flash dies away, the seco" +
+        "nd shot is revealed in its place. The shot ends on the second shot, fully resolved, with no bolt or " +
+        "flash left. The change happens inside the flash, and the second shot appears only as the white fades",
+    },
+  }
+
+  it.each(Object.keys(F3_BODIES))("%s renders `term (body)` at the tile-default levers", (id) => {
+    const { term, body } = F3_BODIES[id]!
+    expect(getTransitionPromptHint(id)).toBe(body)
+    expect(composeTransitionHintFromConnections(id, [], [], {}, "full", { scope: "shot" })).toBe(`${term} (${body})`)
+  })
+
+  it.each(Object.keys(F3_BODIES))("%s at middle / short / natural", (id) => {
+    const { term, body } = F3_BODIES[id]!
+    expect(composeTransitionHintFromConnections(id, [], [], { position: "middle", duration: "short", intensity: "natural" })).toBe(
+      `${term} (${body}), the transition occurs in the middle of the clip, lasting approximately 1 second, with natural timing`,
+    )
+  })
+})
+
+describe("F4 bodies (2026-09-25 A/B: F4 arm B)", () => {
+  // building-explosion and vehicle-explosion: the F4 drafts, tidied (first letter lower-cased, final
+  // full stop dropped). Each rendered string below is byte-identical to the clause the winning take was
+  // generated from.
+  const F4_BODIES: Record<string, { term: string; body: string }> = {
+    "building-explosion": {
+      term: "building explosion",
+      body:
+        "the largest structure in the frame detonates in a massive fireball, and debris and dust plume outwar" +
+        "d until they fill the whole picture. The camera stays where it is and the framing does not change. A" +
+        "s the dust cloud clears, the second shot is revealed in its place. The shot ends on the second shot," +
+        " clear and fully resolved, with no dust or debris left. The blast comes from that structure itself, " +
+        "and the second shot appears only as the dust clears",
+    },
+    "vehicle-explosion": {
+      term: "vehicle explosion",
+      body:
+        "a vehicle in the frame bursts into a violent explosion of fire and twisted metal, and the fireball b" +
+        "illows toward the lens until orange flame fills the whole picture. The camera stays where it is and " +
+        "the framing does not change. The flame gives way to thick smoke, and as the smoke parts the second s" +
+        "hot is revealed. The shot ends on the second shot, clear and fully resolved, with no fire or smoke l" +
+        "eft. The explosion comes from that vehicle itself, and the second shot appears only as the smoke par" +
+        "ts",
+    },
+  }
+
+  it.each(Object.keys(F4_BODIES))("%s renders `term (body)` at the tile-default levers", (id) => {
+    const { term, body } = F4_BODIES[id]!
+    expect(getTransitionPromptHint(id)).toBe(body)
+    expect(composeTransitionHintFromConnections(id, [], [], {}, "full", { scope: "shot" })).toBe(`${term} (${body})`)
+  })
+
+  it.each(Object.keys(F4_BODIES))("%s at middle / short / natural", (id) => {
+    const { term, body } = F4_BODIES[id]!
+    expect(composeTransitionHintFromConnections(id, [], [], { position: "middle", duration: "short", intensity: "natural" })).toBe(
+      `${term} (${body}), the transition occurs in the middle of the clip, lasting approximately 1 second, with natural timing`,
+    )
+  })
+})
+
+describe("F5 bodies (2026-09-25 A/B: F5 arm B)", () => {
+  // zoom-into-book, pull-out-reveal, zoom-into-mouth, walk-through-door and mask-transition: the F5
+  // drafts, tidied (first letter lower-cased, final full stop dropped). Each rendered string below is
+  // byte-identical to the clause the winning take was generated from.
+  const F5_BODIES: Record<string, { term: string; body: string }> = {
+    "zoom-into-book": {
+      term: "zoom into book",
+      body:
+        "the camera pushes down toward the illustrated page of an open book in the frame until the illustrati" +
+        "on fills the whole picture. The camera travels in one smooth line, without turning or rolling. The d" +
+        "rawn picture comes alive, gaining depth, light and movement, and becomes the second shot. The shot e" +
+        "nds inside the second shot, real and fully resolved, with no paper, ink lines or page edges left. Th" +
+        "e camera heads for the page from the start and goes into its illustration",
+    },
+    "pull-out-reveal": {
+      term: "pull-back reveal",
+      body:
+        "the camera pulls straight back fast, and the whole first shot shrinks until its edges show as the bo" +
+        "rder of a framed picture inside a larger space. The camera travels back in one smooth line, without " +
+        "turning, tilting or rolling. The larger space around the picture is the second shot, and the first s" +
+        "hot stays inside the picture. The shot ends on the second shot, with the first shot visible as a pic" +
+        "ture within it. The first shot's image stays exactly the same as it shrinks, so it reads as the same" +
+        " picture all along",
+    },
+    "zoom-into-mouth": {
+      term: "zoom into mouth",
+      body:
+        "the camera pushes straight into the first subject's open mouth until the dark interior fills the who" +
+        "le picture. The camera travels forward in one smooth line, without turning, tilting or rolling. It p" +
+        "asses through the darkness, and the second shot emerges out of it. The shot ends inside the second s" +
+        "hot, still and fully resolved, with no mouth left in view. The dark interior stays a plain darkness " +
+        "the camera passes through",
+    },
+    "walk-through-door": {
+      term: "walk through doorway",
+      body:
+        "the camera follows the first subject through a doorway in the frame, moving forward at the subject's" +
+        " pace. The camera travels straight forward, without turning, tilting or rolling. On the far side of " +
+        "the doorway the space is the second shot, a different place in different light. The shot ends in the" +
+        " second shot, fully resolved, with the doorway behind the camera. The change of place happens at the" +
+        " doorway itself, the moment the camera passes through it",
+    },
+    "mask-transition": {
+      term: "mask transition",
+      body:
+        "a dark foreground shape sweeps across the lens and fills the frame with black. The camera keeps trav" +
+        "elling forward through the black in one smooth line. It emerges from the darkness into the second sh" +
+        "ot. The shot ends in the second shot, fully resolved, with no dark shape left. The dark shape passes" +
+        " close to the lens and is gone once the second shot appears",
+    },
+  }
+
+  it.each(Object.keys(F5_BODIES))("%s renders `term (body)` at the tile-default levers", (id) => {
+    const { term, body } = F5_BODIES[id]!
+    expect(getTransitionPromptHint(id)).toBe(body)
+    expect(composeTransitionHintFromConnections(id, [], [], {}, "full", { scope: "shot" })).toBe(`${term} (${body})`)
+  })
+
+  it.each(Object.keys(F5_BODIES))("%s at middle / short / natural", (id) => {
+    const { term, body } = F5_BODIES[id]!
+    expect(composeTransitionHintFromConnections(id, [], [], { position: "middle", duration: "short", intensity: "natural" })).toBe(
+      `${term} (${body}), the transition occurs in the middle of the clip, lasting approximately 1 second, with natural timing`,
+    )
+  })
+})
+
+describe("shockwave body (2026-09-25 rework: shockwave3 E1)", () => {
+  // The E1 draft as tested: a flash bursts into a bright opaque ring that races past every edge, the ring
+  // the one hard border between the shots. The rendered string at the tile default is byte-identical to
+  // the clause the winning take was generated from.
+  const TERM = "shockwave"
+  const BODY =
+    "a flash at the exact centre of the frame bursts into a sharp, bright ring that races past every edge" +
+    " in a moment, trailing a smear of motion blur behind its rim and warping the picture as it goes. The" +
+    " camera stays where it is and the picture stays level. The second shot shows only inside the ring an" +
+    "d the first only outside it, with the bright ring as the one hard border and no blending anywhere"
+
+  it("renders `term (body)` at the tile-default levers", () => {
+    expect(getTransitionPromptHint("shockwave")).toBe(BODY)
+    expect(composeTransitionHintFromConnections("shockwave", [], [], {}, "full", { scope: "shot" })).toBe(`${TERM} (${BODY})`)
+  })
+
+  it("at middle / short / natural", () => {
+    expect(composeTransitionHintFromConnections("shockwave", [], [], { position: "middle", duration: "short", intensity: "natural" })).toBe(
+      `${TERM} (${BODY}), the transition occurs in the middle of the clip, lasting approximately 1 second, with natural timing`,
+    )
+  })
+})
+
+describe("roll-transition body (2026-09-25 A/B: F6 arm B)", () => {
+  // The F6 roll draft, tidied (first letter lower-cased, final full stop dropped): one full turn one way
+  // that stops level, with no swing back. The rendered string at the tile default is byte-identical to
+  // the clause the winning take was generated from. The other F6 rows keep today's text.
+  const TERM = "camera roll transition"
+  const BODY =
+    "the picture rolls around its centre in one smooth, fast turn, blurred by the speed of the turn. The " +
+    "camera stays in the same spot, turning only around its lens axis. During the turn the second shot ta" +
+    "kes over, and the roll slows and stops with it level and upright. The shot ends on the second shot, " +
+    "level, upright and still. The roll turns one way only and stops once, with no swing back"
+
+  it("renders `term (body)` at the tile-default levers", () => {
+    expect(getTransitionPromptHint("roll-transition")).toBe(BODY)
+    expect(composeTransitionHintFromConnections("roll-transition", [], [], {}, "full", { scope: "shot" })).toBe(`${TERM} (${BODY})`)
+  })
+
+  it("at middle / short / natural", () => {
+    expect(composeTransitionHintFromConnections("roll-transition", [], [], { position: "middle", duration: "short", intensity: "natural" })).toBe(
+      `${TERM} (${BODY}), the transition occurs in the middle of the clip, lasting approximately 1 second, with natural timing`,
+    )
+  })
+})
+
+describe("time-lapse bodies (2026-09-24 A/B at full / long: descab3 row 26)", () => {
+  // Day → night ships arm B, the audit body (B 5 > A 4). Night → day was a tie (A 4 · B 4), so the shorter
+  // body stays: today's (179 characters against B's 220). Both rows keep their "fast-forward time-lapse
+  // transition:" heading, which the renderer strips. Day → night's body has a colon of its own after a
+  // 61-character lead-in; it is a description lead-in, not a heading, and the heading guard in
+  // transitions-instant.test.ts still passes for it. The term + body is byte-identical to the clause the
+  // winning take (d4546594) was generated from.
+  const DN_TERM = "day-to-night time-lapse"
+  const DN_BODY =
+    "the same view with framing locked while hours pass in seconds: light and shadows sweep across the sc" +
+    "ene, daylight warms to dusk and fades to night, lights come on, until the picture matches the end frame"
+  const ND_TERM = "night-to-day time-lapse"
+  const ND_BODY =
+    "stars fade, the sky shifts from deep night through pre-dawn blue to golden sunrise, shadows sweep in r" +
+    "everse, all while framing and camera position remain locked on the same scene"
+  const HEADING = "fast-forward time-lapse transition: "
+
+  it("day → night: the catalog hint keeps its heading and carries the B body", () => {
+    expect(getTransitionPromptHint("fast-forward-day-night")).toBe(HEADING + DN_BODY)
+  })
+
+  it("day → night renders `term (body)` at the tile-default levers", () => {
+    expect(composeTransitionHintFromConnections("fast-forward-day-night", [], [], {}, "full", { scope: "shot" })).toBe(
+      `${DN_TERM} (${DN_BODY})`,
+    )
+  })
+
+  it("day → night at full / long / natural (the levers the take was rendered at)", () => {
+    expect(composeTransitionHintFromConnections("fast-forward-day-night", [], [], { position: "full", duration: "long", intensity: "natural" })).toBe(
+      `${DN_TERM} (${DN_BODY}), ${FULL_CLAUSE}, lasting approximately 3 seconds, with natural timing`,
+    )
+  })
+
+  it("day → night at middle / short / natural", () => {
+    expect(composeTransitionHintFromConnections("fast-forward-day-night", [], [], { position: "middle", duration: "short", intensity: "natural" })).toBe(
+      `${DN_TERM} (${DN_BODY}), the transition occurs in the middle of the clip, lasting approximately 1 second, with natural timing`,
+    )
+  })
+
+  it("night → day keeps today's body", () => {
+    expect(getTransitionPromptHint("fast-forward-night-day")).toBe(HEADING + ND_BODY)
+    expect(composeTransitionHintFromConnections("fast-forward-night-day", [], [], {}, "full", { scope: "shot" })).toBe(
+      `${ND_TERM} (${ND_BODY})`,
+    )
+  })
+})
+
+describe("zoom-into-mirror body (2026-10-03 redraft: mirror3 D2, liquid ripple)", () => {
+  // The mirror3 D2 draft ("liquid ripple"), rated 4/5 against D1 3/5 and D3 2/5. It was tested already
+  // tidied (lower-case start, no final full stop), so it ships exactly as the take was generated (job
+  // 5821fa22): the rendered string at the tile default is byte-identical to the clause in that prompt.
+  const TERM = "zoom into mirror"
+  const BODY =
+    "the camera pushes straight at a mirror in the frame. As the lens meets the glass, the mirror's " +
+    "surface turns liquid and rings ripple out across the whole picture, and the camera keeps moving " +
+    "forward through the rippling surface, out the far side into the second shot. Until the lens touches " +
+    "the glass, the mirror keeps its own reflection. The shot ends in the second shot, still and fully " +
+    "resolved, with no ripples left"
+
+  it("renders `term (body)` at the tile-default levers", () => {
+    expect(getTransitionPromptHint("zoom-into-mirror")).toBe(BODY)
+    expect(composeTransitionHintFromConnections("zoom-into-mirror", [], [], {}, "full", { scope: "shot" })).toBe(`${TERM} (${BODY})`)
+  })
+
+  it("at middle / short / natural", () => {
+    expect(composeTransitionHintFromConnections("zoom-into-mirror", [], [], { position: "middle", duration: "short", intensity: "natural" })).toBe(
+      `${TERM} (${BODY}), the transition occurs in the middle of the clip, lasting approximately 1 second, with natural timing`,
+    )
+  })
+})
+
+describe("F8 cut bodies (2026-10-03 A/B: F8 arm B on snap-to-black, jump-match and match-cut)", () => {
+  // Arm B, the F8 draft with the ship tidy (first letter lower-cased; the drafts carry no final full stop, so
+  // the anti-blend sentence reads on after the body). Each is byte-identical to the body inside the prompt of
+  // the take it was rated on: snap-to-black 03-B-t2 (2bcc8b81), jump-match 04-B-t1 (b9027a0a), match-cut
+  // 07-B (4c6e3ecd). snap-to-black and match-cut keep their "<label>:" heading, which the renderer strips;
+  // jump-match never had one. None of the three bodies contains a colon, so the heading guard in
+  // transitions-instant.test.ts cannot match them, and no comma item equals its row's term. All three are
+  // cuts: the cut sentence rides inside the parentheses, and duration and intensity are dropped.
+  const ROWS = [
+    {
+      id: "snap-to-black",
+      term: "snap to black",
+      heading: "snap to black: ",
+      body:
+        "the first shot cuts straight to full black on a single frame. The camera holds its framing right up " +
+        "to the cut. The frame stays pure black for a single beat, then the second shot cuts in at full brigh" +
+        "tness on a single frame. The shot ends on the second shot, fully resolved",
+    },
+    {
+      id: "jump-match",
+      term: "match cut on a jump",
+      heading: "",
+      body:
+        "the subject launches into a jump, and at the height of the leap the picture cuts to a new place. The" +
+        " camera follows the arc of the jump at the same speed on both sides of the cut, and the subject stay" +
+        "s at the same place in the frame. In the second shot the same jump carries on without a break, and t" +
+        "he subject comes down and lands in the new place. The shot ends on the subject landed in the second " +
+        "shot, fully resolved",
+    },
+    {
+      id: "match-cut",
+      term: "match cut",
+      heading: "match cut: ",
+      body:
+        "the last picture of the first shot and the first picture of the second share one shape, at the same " +
+        "place and the same size in the frame. The camera holds that shape in place across the cut. On the ne" +
+        "xt frame everything around the shape has changed while the shape itself stays put. The shot ends on " +
+        "the second shot, fully resolved, with no flash frame or zoom between the two",
+    },
+  ] as const
+
+  it.each(ROWS)("$id: the catalog hint carries the new body (heading kept where the row had one)", ({ id, heading, body }) => {
+    expect(getTransitionPromptHint(id)).toBe(heading + body)
+  })
+
+  it.each(ROWS)("$id renders `term (body; cut sentence)` at the tile-default levers", ({ id, term, body }) => {
+    const clause = `${term} (${body}; ${INSTANT_CUT_CLAUSE})`
+    expect(composeTransitionHintFromConnections(id, [], [], {}, "full", { scope: "shot" })).toBe(clause)
+    expect(composeTransitionHintFromConnections(id, [], [], {}, "compact", { scope: "shot" })).toBe(clause)
+    expect(composeTransitionHintFromConnections(id, [], [])).toBe(clause)
+  })
+
+  it.each(ROWS)("$id at middle / short / natural keeps only the position", ({ id, term, body }) => {
+    const levers = { position: "middle", duration: "short", intensity: "natural" } as const
+    expect(composeTransitionHintFromConnections(id, [], [], levers)).toBe(
+      `${term} (${body}; ${INSTANT_CUT_CLAUSE}), the transition occurs in the middle of the clip`,
+    )
+    expect(composeTransitionHintFromConnections(id, [], [], levers, "full", { scope: "shot" })).toBe(
+      `${term} (${body}; ${INSTANT_CUT_CLAUSE}), the transition occurs in the middle of this shot`,
+    )
+  })
+
+  // The other F8 rows keep today's text (jump-cut's body changes in the 2026-10-04 block below).
+  const KEPT: Record<string, string> = {
+    "none":
+      "no transition, hard cut, instantaneous switch from first shot to second shot",
+    "smash-cut":
+      "smash cut: an abrupt jarring transition between two visually or tonally contrasting shots with no fa" +
+      "de, on a beat",
+    "seamless-match":
+      "hidden seamless transition: the camera motion, color palette, and on-screen motion at the end of the" +
+      " first shot continue exactly across the cut into the second shot, so the boundary is invisible and t" +
+      "he two shots feel like one unbroken take",
+    "action-relay":
+      "match cut on action: the subject exits the frame on a committed action — a stride, a throw, a turn —" +
+      " and enters the new scene on the same beat continuing that movement at matched speed and direction, " +
+      "so the action carries unbroken across the cut",
+  }
+
+  it.each(Object.entries(KEPT))("%s keeps today's text", (id, hint) => {
+    expect(getTransitionPromptHint(id)).toBe(hint)
+  })
+})
+
+describe("F9 time bodies (2026-10-03 A/B at full / long: F9 arm B on seasonal-shift and flashback)", () => {
+  // Arm B, the F9 draft with the ship tidy (first letter lower-cased, no final full stop). Each is byte-identical to
+  // the body inside the prompt of the take it was rated on: seasonal-shift 01-B (428e79c6) and flashback 02-B
+  // (bc236b0c), both rendered at position full / duration long (the time-row rule), no intensity, scope shot. Both
+  // rows keep their heading, which the renderer strips. Neither body contains a colon, so the heading guard in
+  // transitions-instant.test.ts has nothing to match, and no comma item equals its row's term. weather-shift was a
+  // tie (A 4 · B 4), so the shorter body stays: today's.
+  const ROWS = [
+    {
+      id: "seasonal-shift",
+      term: "seasonal time-lapse",
+      heading: "accelerated seasonal time-lapse: ",
+      body:
+        "the same view races through the seasons in fast motion, from the season of the first shot to the sea" +
+        "son of the second, as growing things bud, turn and fall and snow comes or goes. The camera stays whe" +
+        "re it is and the framing does not change. The change flows continuously across the whole picture, ev" +
+        "ery part moving on together, until the view matches the second shot. The shot ends on the second sho" +
+        "t's season, still and fully resolved. Only the season changes, and the layout of the view stays exac" +
+        "tly the same",
+    },
+    {
+      id: "flashback",
+      term: "flashback",
+      heading: "brief flashback transition: ",
+      body:
+        "a soft warm wash spreads over the whole picture and a faint ripple drifts across it as the present m" +
+        "oment fades. The camera stays where it is and the framing does not change. Through the ripple an ear" +
+        "lier moment of the same subject comes into focus, like a memory. The shot ends on the remembered mom" +
+        "ent, steady and fully resolved, with the ripple gone. The subject stays at the same place in the fra" +
+        "me while the moment around it changes",
+    },
+  ] as const
+
+  it.each(ROWS)("$id: the catalog hint keeps its heading and carries the B body", ({ id, heading, body }) => {
+    expect(getTransitionPromptHint(id)).toBe(heading + body)
+  })
+
+  it.each(ROWS)("$id renders `term (body)` at the tile-default levers", ({ id, term, body }) => {
+    expect(composeTransitionHintFromConnections(id, [], [], {}, "full", { scope: "shot" })).toBe(`${term} (${body})`)
+  })
+
+  it.each(ROWS)("$id at full / long in a shot window (the levers the take was rendered at)", ({ id, term, body }) => {
+    expect(composeTransitionHintFromConnections(id, [], [], { position: "full", duration: "long" }, "full", { scope: "shot" })).toBe(
+      `${term} (${body}), ${FULL_SHOT_CLAUSE}, lasting approximately 3 seconds`,
+    )
+  })
+
+  it.each(ROWS)("$id at middle / short / natural", ({ id, term, body }) => {
+    expect(composeTransitionHintFromConnections(id, [], [], { position: "middle", duration: "short", intensity: "natural" })).toBe(
+      `${term} (${body}), the transition occurs in the middle of the clip, lasting approximately 1 second, with natural timing`,
+    )
+  })
+
+  it("weather-shift keeps today's body", () => {
+    const body =
+      "same scene, framing locked — clear sky darkens to storm clouds, rain begins and intensifies then cle" +
+      "ars, sun returns through breaking clouds"
+    expect(getTransitionPromptHint("weather-shift")).toBe(`accelerated weather transition: ${body}`)
+    expect(composeTransitionHintFromConnections("weather-shift", [], [], {}, "full", { scope: "shot" })).toBe(`weather time-lapse (${body})`)
+  })
+})
+
+describe("F7 glitch and light bodies (2026-10-03 A/B: F7 arm B on channel-flip, display-wipe and color-invert)", () => {
+  // Arm B, the F7 draft with the ship tidy (first letter lower-cased, final full stop dropped). Each is
+  // byte-identical to the body inside the prompt of the take it was rated on: channel-flip 01-B (7f7829ec),
+  // display-wipe 03-B (c66d59bc) and color-invert 04-B (18d66f83), all at the tile-default levers. None of the
+  // three rows has a heading, none of the bodies contains a colon (so the heading guard in
+  // transitions-instant.test.ts has nothing to match), and no comma item equals its row's term. The other F7
+  // rows keep today's text.
+  const ROWS = [
+    {
+      id: "channel-flip",
+      term: "tv channel flip with static",
+      body:
+        "the whole picture breaks into a brief burst of black-and-white static, the image jumping and tearing" +
+        " as if the channel were being changed. The camera stays where it is and the framing does not change." +
+        " The static clears as quickly as it came, and the second shot snaps in, steady, like the next channe" +
+        "l. The shot ends on the second shot, clean and fully resolved, with no static left. The static cover" +
+        "s the whole frame, so the picture itself is what changes channel",
+    },
+    {
+      id: "display-wipe",
+      term: "compress into a screen and expand out",
+      body:
+        "the whole first shot shrinks toward the centre of the frame into a small glowing rectangle, then col" +
+        "lapses to a bright line and a dot as if its power were cut. The camera stays where it is and the fra" +
+        "ming does not change. From the dot a line snaps open and widens into a rectangle showing the second " +
+        "shot, which grows until it fills the frame. The shot ends on the second shot, full frame and fully r" +
+        "esolved, with no border or scanlines left. The picture itself shrinks and grows on a black field, wi" +
+        "th the camera holding still throughout",
+    },
+    {
+      id: "color-invert",
+      term: "color invert flash",
+      body:
+        "the colours of the whole picture turn to their photographic negative in an instant. The camera stays" +
+        " where it is and the framing does not change. The negative holds for a single beat, and when the col" +
+        "ours snap back to normal the second shot is in place. The shot ends on the second shot in natural co" +
+        "lour, fully resolved. The change of shot happens while the picture is in negative, and the picture s" +
+        "tays upright and in place throughout",
+    },
+  ] as const
+
+  it.each(ROWS)("$id: the catalog hint is the B body", ({ id, body }) => {
+    expect(getTransitionPromptHint(id)).toBe(body)
+  })
+
+  it.each(ROWS)("$id renders `term (body)` at the tile-default levers", ({ id, term, body }) => {
+    expect(composeTransitionHintFromConnections(id, [], [], {}, "full", { scope: "shot" })).toBe(`${term} (${body})`)
+    expect(composeTransitionHintFromConnections(id, [], [], {}, "compact", { scope: "shot" })).toBe(`${term} (${body})`)
+    expect(composeTransitionHintFromConnections(id, [], [])).toBe(`${term} (${body})`)
+  })
+
+  it.each(ROWS)("$id at middle / short / natural", ({ id, term, body }) => {
+    expect(composeTransitionHintFromConnections(id, [], [], { position: "middle", duration: "short", intensity: "natural" })).toBe(
+      `${term} (${body}), the transition occurs in the middle of the clip, lasting approximately 1 second, with natural timing`,
+    )
+  })
+})
+
+describe("Redrafted glitch bodies and the jump-cut negative sentence (2026-10-04: hologram-flicker D2, datamosh D1, jump-cut C)", () => {
+  // Each body is byte-identical to the body inside the prompt of the take its tile shows, at the tile-default
+  // levers: hologram-flicker from the F7 redraft's D2, a scan-line rebuild (17245f6b); datamosh from its D1,
+  // blocks that tear loose and pile up into the second shot (a16f906b); jump-cut from the jump-cut retest's arm
+  // C, today's body plus one negative sentence (2bfc4380). datamosh and jump-cut keep their "<label>:" heading,
+  // which the renderer strips; hologram-flicker never had one. No body contains a colon, so the heading guard in
+  // transitions-instant.test.ts cannot match them, and no comma item equals its row's term.
+  const ROWS = [
+    {
+      id: "hologram-flicker",
+      term: "hologram flicker",
+      heading: "",
+      body:
+        "the first shot breaks into thin lines of cyan light that flicker out from the top down, leaving the " +
+        "frame black. The camera stays where it is and the framing does not change. A bright scan line sweeps" +
+        " down and draws the second shot behind it in flickering cyan lines that steady into natural colour. " +
+        "The shot ends on the second shot, solid and fully resolved, with no scan lines left. The second shot" +
+        " is drawn only on black, never over the first shot",
+    },
+    {
+      id: "datamosh",
+      term: "datamosh",
+      heading: "datamosh transition: ",
+      body:
+        "the first shot's pixels tear loose in square compression blocks and slide sideways across the frame " +
+        "in long smeared streaks. The camera stays where it is and the framing does not change. The blocks pi" +
+        "le up into the shapes of the second shot, still in the first shot's colours, until the true colours " +
+        "snap in block by block. The shot ends on the second shot, sharp and fully resolved, with no smears o" +
+        "r blocks left. The smear covers the whole frame",
+    },
+  ] as const
+
+  it.each(ROWS)("$id: the catalog hint carries the new body (heading kept where the row had one)", ({ id, heading, body }) => {
+    expect(getTransitionPromptHint(id)).toBe(heading + body)
+  })
+
+  it.each(ROWS)("$id renders `term (body)` at the tile-default levers", ({ id, term, body }) => {
+    expect(composeTransitionHintFromConnections(id, [], [], {}, "full", { scope: "shot" })).toBe(`${term} (${body})`)
+    expect(composeTransitionHintFromConnections(id, [], [], {}, "compact", { scope: "shot" })).toBe(`${term} (${body})`)
+    expect(composeTransitionHintFromConnections(id, [], [])).toBe(`${term} (${body})`)
+  })
+
+  it.each(ROWS)("$id at middle / short / natural", ({ id, term, body }) => {
+    expect(composeTransitionHintFromConnections(id, [], [], { position: "middle", duration: "short", intensity: "natural" })).toBe(
+      `${term} (${body}), the transition occurs in the middle of the clip, lasting approximately 1 second, with natural timing`,
+    )
+  })
+
+  // jump-cut is a cut: the anti-blend sentence rides inside the parentheses after the body, and duration and
+  // intensity are dropped. The new body has a semicolon of its own; the restatement dedupe splits on commas
+  // only, so it is untouched, and the cut sentence still appears exactly once.
+  const JUMP_CUT_BODY =
+    "the framing, lens, and camera position stay identical across the cut while time skips abruptly forwa" +
+    "rd, so the subject snaps to a new position inside what still reads as one continuous shot. No leap, " +
+    "no run, no lunge and no motion blur between the two positions; the subject is in the old place on on" +
+    "e frame and already in the new place on the next"
+  const JUMP_CUT_CLAUSE = `jump cut (${JUMP_CUT_BODY}; ${INSTANT_CUT_CLAUSE})`
+
+  it("jump-cut: the catalog hint carries the new body after its heading", () => {
+    expect(getTransitionPromptHint("jump-cut")).toBe(`jump cut: ${JUMP_CUT_BODY}`)
+  })
+
+  it("jump-cut renders `term (body; cut sentence)` at the tile-default levers, the cut sentence once", () => {
+    expect(composeTransitionHintFromConnections("jump-cut", [], [], {}, "full", { scope: "shot" })).toBe(JUMP_CUT_CLAUSE)
+    expect(composeTransitionHintFromConnections("jump-cut", [], [], {}, "compact", { scope: "shot" })).toBe(JUMP_CUT_CLAUSE)
+    expect(composeTransitionHintFromConnections("jump-cut", [], [])).toBe(JUMP_CUT_CLAUSE)
+    expect(JUMP_CUT_CLAUSE.split(INSTANT_CUT_CLAUSE).length).toBe(2)
+  })
+
+  it("jump-cut at middle / short / natural keeps only the position", () => {
+    const levers = { position: "middle", duration: "short", intensity: "natural" } as const
+    expect(composeTransitionHintFromConnections("jump-cut", [], [], levers)).toBe(
+      `${JUMP_CUT_CLAUSE}, the transition occurs in the middle of the clip`,
+    )
+    expect(composeTransitionHintFromConnections("jump-cut", [], [], levers, "full", { scope: "shot" })).toBe(
+      `${JUMP_CUT_CLAUSE}, the transition occurs in the middle of this shot`,
+    )
+  })
+})
+
+describe("double-exposure body (2026-10-04: dblexp3 D1, the silhouette wording)", () => {
+  // The D1 draft (first written for dblexp2), byte-identical to the body inside the prompt of the take the
+  // row's tile shows: dblexp3 D1 (c55f1176), rendered at the tile-default levers on a dark profile
+  // silhouette over a near-white ground, cutting to a mountain lake. The row has no heading, the body has no
+  // colon (so the heading guard in transitions-instant.test.ts cannot match it), and no comma item equals the
+  // term. No other row changes.
+  const TERM = "double exposure"
+  const BODY =
+    "the first subject becomes a crisp silhouette filled solid with the second shot, while the rest of th" +
+    "e first shot stays untouched around it. The camera stays where it is and the framing does not change" +
+    ". The silhouette holds for a clear beat, both pictures plainly seen at once, then the first shot aro" +
+    "und it gives way to the second shot. The shot ends on the second shot alone, fully resolved"
+  const CLAUSE = `${TERM} (${BODY})`
+
+  it("the catalog hint is the D1 body", () => {
+    expect(getTransitionPromptHint("double-exposure")).toBe(BODY)
+  })
+
+  it("renders `term (body)` at the tile-default levers", () => {
+    expect(composeTransitionHintFromConnections("double-exposure", [], [], {}, "full", { scope: "shot" })).toBe(CLAUSE)
+    expect(composeTransitionHintFromConnections("double-exposure", [], [], {}, "compact", { scope: "shot" })).toBe(CLAUSE)
+    expect(composeTransitionHintFromConnections("double-exposure", [], [])).toBe(CLAUSE)
+  })
+
+  it("at middle / short / natural", () => {
+    expect(composeTransitionHintFromConnections("double-exposure", [], [], { position: "middle", duration: "short", intensity: "natural" })).toBe(
+      `${CLAUSE}, the transition occurs in the middle of the clip, lasting approximately 1 second, with natural timing`,
+    )
+  })
+})
+
 describe("L1 — a cut spans nothing, so `full` adds no clause", () => {
   it.each(INSTANT_IDS)("%s + full renders no position clause", (id) => {
     const out = composeTransitionHintFromConnections(id, [], [], { position: "full", duration: "short", intensity: "natural" })

package/src/__tests__/video-own-motion.test.ts

@@ -0,0 +1,26 @@
+import { describe, it, expect } from "vitest"
+import { DEFAULT_OWN_MOTION, ownMotionHint } from "../video-own-motion.js"
+
+describe("ownMotionHint", () => {
+  const on = { motionEnabled: true, motion: "dynamic" }
+
+  it("gives legacy Image to Video and Generate Video their own Motion clause", () => {
+    expect(ownMotionHint("image-to-video", on)).toBe("dynamic motion")
+    expect(ownMotionHint("generate-video", on)).toBe("dynamic motion")
+  })
+
+  it("gives none to a node type without the setting", () => {
+    expect(ownMotionHint("text-to-video", on)).toBeUndefined()
+    expect(ownMotionHint("video-to-video", on)).toBeUndefined()
+  })
+
+  it("gives none while the setting is off", () => {
+    expect(ownMotionHint("generate-video", { motionEnabled: false, motion: "dynamic" })).toBeUndefined()
+    expect(ownMotionHint("generate-video", { motion: "dynamic" })).toBeUndefined()
+  })
+
+  it("runs an enabled setting with no step stored as the step the panel shows", () => {
+    expect(ownMotionHint("generate-video", { motionEnabled: true })).toBe(`${DEFAULT_OWN_MOTION} motion`)
+    expect(ownMotionHint("image-to-video", { motionEnabled: true, motion: "" })).toBe(`${DEFAULT_OWN_MOTION} motion`)
+  })
+})