@nodaro/shared 2.14.0 → 2.15.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nodaro/shared",
-  "version": "2.14.0",
+  "version": "2.15.0",
   "description": "Shared types, model catalog, wire contracts, and structural vocabularies for the Nodaro platform and SDK.",
   "type": "module",
   "license": "Apache-2.0",

package/src/__tests__/video-analysis.test.ts

@@ -287,6 +287,17 @@ describe("cinematography fields (angle / speed / onScreenText / look)", () => {
     expect(windowAnalysisSchema.safeParse({ slots: [slot], scenes: [{ ...baseScene }] }).success).toBe(true)
   })
 
+  it("round 4: a scene carries a free-text `transition` beside the legacy enum", () => {
+    // F.8: the analyser describes the edit in its own words; the enum is legacy.
+    const ok = windowAnalysisSchema.safeParse({ slots: [slot], scenes: [{ ...baseScene, transition: "fast blurred pan left" }] })
+    expect(ok.success).toBe(true)
+    expect(ok.success && ok.data.scenes[0]!.transition).toBe("fast blurred pan left")
+    expect(windowAnalysisSchema.safeParse({ slots: [slot], scenes: [{ ...baseScene, transition: "" }] }).success).toBe(false)
+    expect(windowAnalysisSchema.safeParse({ slots: [slot], scenes: [{ ...baseScene, transition: "x".repeat(121) }] }).success).toBe(false)
+    // legacy blueprints still parse
+    expect(windowAnalysisSchema.safeParse({ slots: [slot], scenes: [{ ...baseScene, transitionOut: "whip" }] }).success).toBe(true)
+  })
+
   it("marks the viewpoints where no face is visible — auto-cast reads this", () => {
     // A reference frame shot from behind cannot cast a face, however well framed.
     expect([...VIDEO_ANALYSIS_FACELESS_ANGLES].sort()).toEqual(["from-behind", "over-the-shoulder"])

package/src/video-analysis.ts

@@ -334,6 +334,15 @@ const windowSceneBase = z.object({
   /** Effects on this shot's PICTURE. Absent ⇒ a clean image. */
   effects: z.array(z.enum(VIDEO_ANALYSIS_VISUAL_EFFECTS)).optional(),
   transitionOut: z.enum(VIDEO_ANALYSIS_TRANSITIONS).optional(),
+  // Round 4 (2026-08-30, recast shot craft rev 1.5 Appendix F.8): the edit into
+  // the next scene in the analyser's OWN WORDS — a few words of what it saw
+  // ("fast blurred pan left", "fade to black", "zoom-blur warp into the tunnel")
+  // — or absent when the take continues through the change or no edit is seen
+  // (nothing asserted: the video model decides from story and refs). The closed
+  // `transitionOut` vocabulary above is LEGACY from here on: kept so stored
+  // blueprints still parse, never emitted again. Readers take
+  // `transition ?? transitionOut`.
+  transition: z.string().trim().min(1).max(120).optional(),
   // Array of concurrent layers (music + speech + sfx together); [] = silence.
   audio: z.array(audioLayerSchema),
   /** slotId → variationId for slots wearing a NON-default look in this scene