@nodaro/prompts 1.26.0 → 1.26.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nodaro/prompts",
-  "version": "1.26.0",
+  "version": "1.26.1",
   "description": "Nodaro's prompt-engineering layer — person/picker catalogs with prompt hints, identity-lock clauses, entity prompt builders, brand presets, and prompt/reference assembly shared by the Nodaro platform and SDK.",
   "type": "module",
   "license": "FSL-1.1-Apache-2.0",

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

@@ -123,6 +123,67 @@ describe("F1 bodies — the subject becomes the material and reforms (2026-09-25
   })
 })
 
+describe("F2 + vortex bodies (2026-09-25 A/B: F2 arm B, vortex rework D2)", () => {
+  // sand-storm, paint-splash and aurora-sweep: the F2 drafts, tidied (first letter lower-cased, final
+  // full stop dropped). vortex-swirl: the rework's D2 body, as tested. Each rendered string below is
+  // byte-identical to the clause the winning take was generated from.
+  const F2_BODIES: Record<string, { term: string; body: string }> = {
+    "sand-storm": {
+      term: "sand storm",
+      body:
+        "a wall of opaque, swirling ochre sand sweeps in from one side of the frame and surges across it " +
+        "until the whole picture is hidden in dust. The camera stays where it is and the framing does not " +
+        "change. The dust then thins and sinks away toward the lower edge of the frame, revealing the second " +
+        "shot behind it. The shot ends on the second shot, clear and fully resolved, with no dust left. The " +
+        "first shot stays as it is until the sand covers it completely, and the second shot appears only as " +
+        "the dust clears",
+    },
+    "paint-splash": {
+      term: "paint splash",
+      body:
+        "vivid splashes of coloured paint fly across the frame in arcing streaks and pile over one another " +
+        "until the whole picture is covered in wet paint. The camera stays where it is and the framing does " +
+        "not change. The paint then gathers toward the centre of the frame and shrinks to nothing, uncovering" +
+        " the second shot from the edges inward. The shot ends on the second shot, clean and fully resolved, " +
+        "with no paint left. The paint lies on the surface of the picture itself, and the second shot appears" +
+        " only where the paint has gone",
+    },
+    "aurora-sweep": {
+      term: "aurora sweep",
+      body:
+        "a luminous curtain of green and violet aurora light ripples across the whole frame, and its bright " +
+        "bands veil the first shot. The camera stays where it is and the framing does not change. As the " +
+        "bands fade, the second shot is revealed behind them. The shot ends on the second shot, clear and " +
+        "fully resolved, with no aurora light left. The aurora glows over the front of the picture, and the " +
+        "second shot appears only as it fades",
+    },
+    "vortex-swirl": {
+      term: "vortex swirl",
+      body:
+        "only the first subject twists, winding around its own centre like wrung cloth into a tight narrow " +
+        "column at the same place in the frame, turning faster as it narrows, while the surroundings stay " +
+        "upright and still. the camera is locked on a tripod head planted in one spot, holding the frame " +
+        "level from start to finish. the column then unwinds in the same direction and opens into the shape " +
+        "of the second subject, while the second shot appears around it. the shot ends on the second subject," +
+        " solid and fully resolved, with nothing left turning. the twist stays inside the outline of the " +
+        "subject, and the edges of the frame stay square and still",
+    },
+  }
+
+  it.each(Object.keys(F2_BODIES))("%s renders `term (body)` at the tile-default levers", (id) => {
+    const { term, body } = F2_BODIES[id]!
+    expect(getTransitionPromptHint(id)).toBe(body)
+    expect(composeTransitionHintFromConnections(id, [], [], {}, "full", { scope: "shot" })).toBe(`${term} (${body})`)
+  })
+
+  it.each(Object.keys(F2_BODIES))("%s at middle / short / natural", (id) => {
+    const { term, body } = F2_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("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/transitions.ts

@@ -163,11 +163,11 @@ export const TRANSITIONS: ReadonlyArray<Transition> = [
   { id: "ink-splash",        label: "Ink Splash",         category: "element", description: "Ink splashes across, scene changes",
     promptHint: "black ink splashes across the frame in expanding tendrils that fully cover the image, then the ink retracts inward and pulls back to reveal the new scene" },
   { id: "sand-storm",        label: "Sand Storm",         category: "element", description: "Sand storm engulfs the frame, scene changes inside",
-    promptHint: "a violent sand storm sweeps in from the side and engulfs the frame in opaque swirling ochre dust, and as the wind dies and the dust settles the second scene is revealed in the now-clear air" },
+    promptHint: "a wall of opaque, swirling ochre sand sweeps in from one side of the frame and surges across it until the whole picture is hidden in dust. The camera stays where it is and the framing does not change. The dust then thins and sinks away toward the lower edge of the frame, revealing the second shot behind it. The shot ends on the second shot, clear and fully resolved, with no dust left. The first shot stays as it is until the sand covers it completely, and the second shot appears only as the dust clears" },
   { id: "paint-splash",      label: "Paint Splash",       category: "element", description: "Vivid paint splash covers, retracts into new scene",
-    promptHint: "a vivid splash of colored paint hurls across the frame in arcing tendrils until it fully covers the image, then the paint flows and retracts inward to pull back and reveal the new scene" },
+    promptHint: "vivid splashes of coloured paint fly across the frame in arcing streaks and pile over one another until the whole picture is covered in wet paint. The camera stays where it is and the framing does not change. The paint then gathers toward the centre of the frame and shrinks to nothing, uncovering the second shot from the edges inward. The shot ends on the second shot, clean and fully resolved, with no paint left. The paint lies on the surface of the picture itself, and the second shot appears only where the paint has gone" },
   { id: "aurora-sweep",      label: "Aurora Sweep",       category: "element", description: "Aurora curtain sweeps across, scene changes behind",
-    promptHint: "a luminous green and violet aurora curtain ripples across the entire frame, the bright bands obscure the first scene, and as the aurora dissipates the second scene resolves in the clear sky" },
+    promptHint: "a luminous curtain of green and violet aurora light ripples across the whole frame, and its bright bands veil the first shot. The camera stays where it is and the framing does not change. As the bands fade, the second shot is revealed behind them. The shot ends on the second shot, clear and fully resolved, with no aurora light left. The aurora glows over the front of the picture, and the second shot appears only as it fades" },
   { id: "sakura-petals",     label: "Sakura Storm",       category: "element", description: "Cherry blossom petals storm across the frame",
     promptHint: "a dense storm of cherry blossom petals swirls in from one side and fills the frame in soft pink motion, the petals cluster to fully veil the image, then drift past to reveal the new scene", term: "cherry blossom petal storm" },
   { id: "garden-bloom",      label: "Garden Bloom",       category: "element", description: "Flowers bloom outward, parting to reveal new scene",
@@ -187,7 +187,7 @@ export const TRANSITIONS: ReadonlyArray<Transition> = [
   { id: "origami-fold",      label: "Origami Fold",       category: "morph", description: "Subject folds like paper into new subject",
     promptHint: "the first subject creases and folds like sheets of origami paper, the folds rotate and re-arrange in elegant geometric steps, and the final fold reveals the new subject" },
   { id: "vortex-swirl",      label: "Vortex Swirl",       category: "morph", description: "Subject swirls into vortex, unwinds as new",
-    promptHint: "the first subject spirals inward into a tight vortex at the center of the frame, the vortex briefly compresses to a point, then unwinds outward into the new subject" },
+    promptHint: "only the first subject twists, winding around its own centre like wrung cloth into a tight narrow column at the same place in the frame, turning faster as it narrows, while the surroundings stay upright and still. the camera is locked on a tripod head planted in one spot, holding the frame level from start to finish. the column then unwinds in the same direction and opens into the shape of the second subject, while the second shot appears around it. the shot ends on the second subject, solid and fully resolved, with nothing left turning. the twist stays inside the outline of the subject, and the edges of the frame stay square and still" },
   { id: "dream-ripple",      label: "Dream Ripple",       category: "morph", description: "Surface ripple wave reveals new scene",
     promptHint: "a circular ripple radiates outward across the frame as if the image were the surface of water, and where the ripple passes the first scene is replaced by the second scene" },
   { id: "wireframe-morph",   label: "Wireframe Morph",    category: "morph", description: "Subject reduces to wireframe, reforms as new subject",