@koda-sl/baker-cli 0.281.0-dev.1f1c09c80 → 0.281.2-dev.1f1c09c80

package/dist/cli.js

@@ -32699,9 +32699,17 @@ var Beat = z30.object({
    */
   sound: z30.string().min(1).max(200).optional(),
   /**
-   * Set only when this beat's subject is talking to camera. Off by default, and
-   * the default is load-bearing: a person visibly speaking under a voice that is
-   * not theirs reads as bad dubbing, which is what sank the first cut of this.
+   * Whether this beat's subject is talking to camera.
+   *
+   * Left unset it follows the cast: an ad that cast a presenter, in a shot they are in,
+   * with a line, is that person speaking. Set it to FALSE for the exception — a cutaway,
+   * a product shot, a beat you want a narrator to carry over.
+   *
+   * It used to be opt-in, back when the only route was dubbing and OFF was the safe
+   * default. That inverted the moment on-camera started meaning the video model voices
+   * the clip itself: measured on a real run, a brief that said "talking to camera all the
+   * way through" produced an ad with her face on screen and a narrator cast from a prose
+   * description reading her lines, because nothing set this flag.
    */
   on_camera: z30.boolean().optional(),
   /**
@@ -32770,14 +32778,19 @@ var AdSpec = z30.object({
     message: "give `avatar` (a cast avatar's handle) or `description` \u2014 a cast with neither grounds on nothing"
   }).optional(),
   /**
-   * A bed, described in words. Omitted leaves the ad dry — the engine only wires
-   * music when asked, and silence is a legitimate choice.
+   * The bed, described in words — or `false` for an ad that is meant to be dry.
    *
-   * The bed never plays over the first beat: the opening line is the
-   * scroll-stopper and has to read clean. That is the engine's rule, not this
-   * one, and it is why the prompt is all this needs to carry.
+   * Omitted lays a soft, neutral bed. It used to leave the ad silent, on the reasoning
+   * that silence is a legitimate choice; it is, but only as a choice. In practice nothing
+   * ever set this, and finished ads shipped with a voice over nothing — which reads as
+   * unfinished, not as restraint. A bed is the ordinary case, so it is the default, and
+   * an ad that wants silence says `false` and means it.
+   *
+   * The bed never plays over the first beat: the opening line is the scroll-stopper and
+   * has to read clean. That is the engine's rule, not this one, and it is why the prompt
+   * is all this needs to carry.
    */
-  music: z30.string().min(1).optional(),
+  music: z30.union([z30.string().min(1), z30.literal(false)]).optional(),
   /**
    * How the ad closes.
    *
@@ -32948,10 +32961,10 @@ function adSpecCastElements(spec, avatar) {
     }
   ];
 }
-function motionPrompt(beat, isClosingCard, place, physics) {
+function motionPrompt(beat, toCamera, isClosingCard, place, physics) {
   if (isClosingCard) return BRAND_PLATE;
   const shot = `${beat.show}${place}${physics}`;
-  if (beat.on_camera) return shot;
+  if (toCamera) return shot;
   return `${shot} Nobody in frame is speaking: mouths CLOSED and STILL throughout, no talking, no lip movement. Whoever is in shot is looking, reacting or working \u2014 never addressing the camera.`;
 }
 function staticTranscript(spec) {
@@ -32973,11 +32986,21 @@ function staticTranscript(spec) {
   }
   return out;
 }
+function musicBed(spec) {
+  if (spec.music === false) return null;
+  if (typeof spec.music === "string") return spec.music;
+  return "A soft, warm instrumental bed that sits well under a spoken voiceover: gentle acoustic guitar or soft piano with light pads, steady and unobtrusive, no vocals, no lyrics, no drop, no build to a climax, nothing that pulls attention off the voice.";
+}
+function beatToCamera(spec, beat, isClosingCard) {
+  if (isClosingCard) return false;
+  if (beat.on_camera !== void 0) return beat.on_camera;
+  return Boolean(spec.cast) && beat.cast !== false;
+}
 function wantsNativeSpeech(spec, closesOnCard) {
   if (!spec.cast || spec.voiceover === false) return false;
   const last = spec.beats.length - 1;
   const speaking = spec.beats.filter((_, i) => !(closesOnCard && i === last));
-  return speaking.length > 0 && speaking.every((beat) => beat.on_camera === true && beat.cast !== false);
+  return speaking.length > 0 && speaking.every((beat) => beatToCamera(spec, beat, false) && beat.cast !== false);
 }
 function beatDialogue(spec, beat, window2) {
   if (spec.voiceover === false) return [];
@@ -32986,12 +33009,9 @@ function beatDialogue(spec, beat, window2) {
       line: beat.say,
       start_s: window2.start,
       end_s: window2.end,
-      // `on_camera` is the engine's own switch for "this line is narration" — absent, it
-      // guesses from who is in frame, which is how a still photograph once got lip-synced.
-      // Never true on the closing plate: it is a flat colour card with no one in it, and
-      // saying someone is on camera there sent the engine looking for a mouth to lip-sync
-      // on a picture that has no person.
-      on_camera: beat.on_camera === true && !window2.isClosingCard,
+      // Always stated, never left to the engine: absent, it guesses from who is in frame,
+      // which is how a still photograph once got lip-synced.
+      on_camera: beatToCamera(spec, beat, window2.isClosingCard),
       // Naming the CAST as speaker is the other half of what sends this beat down the
       // native path. Left unnamed, the speaker defaults to "voiceover" — a narrator, who is
       // by definition never on camera — so every beat took the dubbed path: a clip generated
@@ -33044,7 +33064,7 @@ function adSpecToBlueprint(spec) {
         isClosingCard,
         nativeSpeech
       }),
-      motion_prompt: motionPrompt(beat, isClosingCard, place, physics),
+      motion_prompt: motionPrompt(beat, beatToCamera(spec, beat, isClosingCard), isClosingCard, place, physics),
       start_frame_prompt: isClosingCard ? BRAND_PLATE : `${beat.show}${place}${physics}`
     };
   });
@@ -33071,7 +33091,7 @@ function adSpecToBlueprint(spec) {
         }
       } : {},
       ...spec.brand?.palette?.length ? { style: { palette: spec.brand.palette.map((hex) => ({ hex })) } } : {},
-      ...spec.music ? { music: { music_prompt: spec.music } } : {}
+      ...musicBed(spec) ? { music: { music_prompt: musicBed(spec) } } : {}
     },
     scenes
   };
@@ -33233,7 +33253,7 @@ function pickBrandMark(files) {
   const score = (f) => {
     const name = f.toLowerCase();
     let s = 0;
-    if (name.endsWith(".svg")) s += 4;
+    if (/\.(png|webp)$/.test(name)) s += 1;
     if (/\b(logo|wordmark|lockup)\b/.test(name)) s += 2;
     if (/\b(mono|white|black|inverse|icon|favicon|mark-only|isotipo)\b/.test(name)) s -= 3;
     return s;
@@ -33439,8 +33459,20 @@ var scaffoldAdCommand = defineCommand105({
       return;
     }
     if (resolvedLogo?.toLowerCase().endsWith(".svg")) {
-      const svg = await readFile16(resolvedLogo, "utf-8").catch(() => "");
-      if (svg && svgIsLiveText(svg)) {
+      const svg = await readFile16(resolvedLogo, "utf-8").catch(() => null);
+      if (svg === null) {
+        writeJson({
+          ok: false,
+          error: {
+            code: "VALIDATION_ERROR",
+            message: `The brand mark at \`${resolvedLogo}\` could not be read, so there is no way to tell whether it is a real logo or a typed stand-in. An ad is not shipped on a mark nobody could open.`,
+            fix: `Check the file is there and readable, or put the client's logo in \`${BRAND_DIR}/logos/\` \u2014 a PNG at 1000px or wider, or an outlined SVG.`
+          }
+        });
+        process.exit(1);
+        return;
+      }
+      if (svgIsLiveText(svg)) {
         writeJson({
           ok: false,
           error: {