@slatesvideo/shared 0.6.11 → 0.7.1

package/dist/prompts/shot-spec.d.ts

@@ -122,6 +122,9 @@ export interface ShotSpec {
      *  only thing that may number anything, and a stored "image 3" would be a
      *  lie the moment a reference is added, removed or reordered. */
     prompt: string;
+    /** Custom bytes remain recoverable when script mode is selected. */
+    recipeMode?: 'script' | 'custom';
+    promptScriptLine?: string | null;
     model: string | null;
     /**
      * The model the PROMPT WAS AUTHORED FOR. Never auto-rewritten.
@@ -229,6 +232,16 @@ export type ScriptTextField = (typeof SCRIPT_TEXT_FIELDS)[number];
  * Dialogue is quoted so a model receives it as speech rather than as
  * description — the one piece of grammar this adds, and the reason it is not
  * just `join(' ')`.
+ *
+ * 🚨 A LINE IS SPEECH ONLY WHEN THE SHOT SAYS WHO SPEAKS OR HOW (2026-09-27).
+ * Since the Script page became one continuous text (2026-09-19, "cues stay
+ * words"), `line` holds whatever script text a Shot's range covers, and most
+ * of a script is action. Composing every speaker-less line as `A voice says
+ * "…"` told the video model that someone speaks the stage direction: an ad
+ * script broken into four Shots sent four of them (first-hour walk finding 15).
+ * Unlabelled text now goes in as written; a speaker (VO included) or a
+ * delivery note still makes it quoted speech. Mirrored byte-for-byte in both
+ * repos, and `check:composer-mirror` compares the two outputs.
  */
 export declare function scriptPromptBody(spec: Pick<ShotSpec, ScriptTextField>): string;
 /**

package/dist/prompts/shot-spec.js

@@ -68,6 +68,16 @@ export const SCRIPT_TEXT_FIELDS = [
  * Dialogue is quoted so a model receives it as speech rather than as
  * description — the one piece of grammar this adds, and the reason it is not
  * just `join(' ')`.
+ *
+ * 🚨 A LINE IS SPEECH ONLY WHEN THE SHOT SAYS WHO SPEAKS OR HOW (2026-09-27).
+ * Since the Script page became one continuous text (2026-09-19, "cues stay
+ * words"), `line` holds whatever script text a Shot's range covers, and most
+ * of a script is action. Composing every speaker-less line as `A voice says
+ * "…"` told the video model that someone speaks the stage direction: an ad
+ * script broken into four Shots sent four of them (first-hour walk finding 15).
+ * Unlabelled text now goes in as written; a speaker (VO included) or a
+ * delivery note still makes it quoted speech. Mirrored byte-for-byte in both
+ * repos, and `check:composer-mirror` compares the two outputs.
  */
 export function scriptPromptBody(spec) {
     const clean = (v) => (v ?? '').trim();
@@ -87,10 +97,16 @@ export function scriptPromptBody(spec) {
     if (line) {
         const speaker = clean(spec.speaker);
         const delivery = clean(spec.delivery).replace(/^\(|\)$/g, '').trim();
-        // "VO" is a screenplay abbreviation, not something to send to a model.
-        const who = !speaker || speaker.toUpperCase() === 'VO' ? 'A voice' : speaker;
-        const how = delivery ? `, ${delivery},` : '';
-        parts.push(`${who} says${how} "${line}"`);
+        if (!speaker && !delivery) {
+            // Script text with no one named to speak it: sent as written.
+            parts.push(line);
+        }
+        else {
+            // "VO" is a screenplay abbreviation, not something to send to a model.
+            const who = !speaker || speaker.toUpperCase() === 'VO' ? 'A voice' : speaker;
+            const how = delivery ? `, ${delivery},` : '';
+            parts.push(`${who} says${how} "${line}"`);
+        }
     }
     return parts.join(' ');
 }
@@ -101,7 +117,7 @@ export function scriptPromptBody(spec) {
  * while the row plainly has a script in it.
  */
 export function effectivePrompt(spec) {
-    const authored = spec.prompt.trim();
+    const authored = spec.recipeMode === 'script' ? '' : spec.prompt.trim();
     return authored || scriptPromptBody(spec);
 }
 /** An empty Shot: a prompt bar nobody has touched. Every reader starts here and
@@ -247,6 +263,8 @@ export function normalizeShotSpec(raw) {
     }
     const out = {
         prompt: typeof v.prompt === 'string' ? v.prompt : '',
+        ...(v.recipeMode === 'script' || v.recipeMode === 'custom' ? { recipeMode: v.recipeMode } : {}),
+        ...(typeof v.promptScriptLine === 'string' || v.promptScriptLine === null ? { promptScriptLine: v.promptScriptLine } : {}),
         model: str(v.model),
         authoredFor: str(v.authoredFor),
         params: readParams(v.params),