@nodaro/shared 1.14.0 → 1.15.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nodaro/shared",
-  "version": "1.14.0",
+  "version": "1.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

@@ -104,6 +104,23 @@ describe("appearance variations (cast-variations spec §4)", () => {
   })
 })
 
+describe("variationFolds (cast-variations §4/§6 — review F5)", () => {
+  const meta = { durationSec: 10, width: 1920, height: 1080, aspectRatio: "16:9" }
+  const doc = {
+    meta,
+    slots: [slot],
+    scenes: [{ ...baseScene, sceneNumber: 1, visualResolved: "a man juggles", slotRefs: ["hero"] }],
+  }
+  it("videoAnalysisResultSchema round-trips variationFolds — strip-mode consumers keep the §6 fold note", () => {
+    const withFolds = { ...doc, variationFolds: [{ slotId: "hero", variationId: "era", label: "Era" }] }
+    expect(videoAnalysisResultSchema.parse(withFolds)).toEqual(withFolds)
+  })
+  it("absent variationFolds stays absent (no [] materialization)", () => {
+    const parsed = videoAnalysisResultSchema.parse(doc)
+    expect("variationFolds" in parsed && parsed.variationFolds !== undefined).toBe(false)
+  })
+})
+
 describe("binding rewrite helpers (merge consumes — spec §4)", () => {
   it("rewriteSceneBindings renames slot keys and per-slot variation values", () => {
     expect(rewriteSceneBindings({ "man-2": "dream", other: "era" }, { "man-2": "hero" }, { hero: { dream: "flashback" } }))

package/src/video-analysis.ts

@@ -128,6 +128,16 @@ export const videoAnalysisResultSchema = z.object({
   }),
   slots: z.array(entitySlotSchema),
   scenes: z.array(analyzedSceneSchema).min(1),
+  /** CAST VARIATIONS (§4 cap handling): looks the analyzer's merge FOLDED into
+   *  the default at VIDEO_ANALYSIS_MAX_VARIATIONS — recorded, never silent. In
+   *  the wire schema so strip-mode consumers (the recast client's validated
+   *  blueprint view) keep it: the §6 "folded into default look" note is the
+   *  user's only pre-pay defense against a wrong split. */
+  variationFolds: z.array(z.object({
+    slotId: z.string(),
+    variationId: z.string(),
+    label: z.string(),
+  })).optional(),
 })
 export type VideoAnalysisResult = z.infer<typeof videoAnalysisResultSchema>