@slatesvideo/shared 0.6.11 → 0.7.0

package/dist/prompts/script-document.d.ts

@@ -0,0 +1,165 @@
+/** Script document wire contract. Spoken text has one home: the scene string. */
+export interface Block {
+    id: string;
+    kind: 'paragraph' | 'heading' | 'direction';
+    start: number;
+    end: number;
+    /** Only non-spoken blocks own text here. Paragraph text lives in Scene.script. */
+    label?: string;
+    level?: number;
+    marks: Array<{
+        start: number;
+        end: number;
+        type: 'strong' | 'em';
+    }>;
+}
+export interface Scene {
+    id: string;
+    name: string;
+    script: string;
+    blocks: Block[];
+}
+export interface Shot {
+    id: string;
+    sceneId: string;
+    range: [number, number] | null;
+    label: string;
+    prompt: string;
+    speaker: string;
+}
+export interface Document {
+    storyboardId: string;
+    recovered?: boolean;
+    version: 1;
+    revision: number;
+    title: string;
+    scenes: Scene[];
+    shots: Shot[];
+}
+export interface DocumentEdit {
+    sceneId: string;
+    at: number;
+    removed: number;
+    text: string;
+}
+export interface DocumentWrite {
+    expectedRevision: number;
+    edits: DocumentEdit[];
+    structures?: Array<{
+        sceneId: string;
+        blocks: Block[];
+    }>;
+    move?: {
+        sceneId: string;
+        blockId: string;
+        delta: -1 | 1;
+    };
+    makeShots?: Array<SectionFragment & {
+        waitingShotId?: string;
+    }>;
+    restoreRevision?: number;
+    sceneAction?: {
+        kind: 'split';
+        sceneId: string;
+        at: number;
+    } | {
+        kind: 'merge';
+        sceneId: string;
+    };
+}
+export interface SectionFragment {
+    sceneId: string;
+    start: number;
+    end: number;
+}
+export interface Section {
+    id: string;
+    storyboardId: string;
+    parentId: string | null;
+    label: string;
+    tags: string[];
+    fragments: SectionFragment[];
+    activeAlternativeId: string | null;
+    locallyChanged: boolean;
+    sourceSectionId?: string | null;
+    sourceRevisionId?: string | null;
+    alternatives: Array<{
+        id: string;
+        label: string;
+        revisionId: string;
+    }>;
+}
+/** `rename` and `archive` act on the section, or on one alternative when
+ * alternativeId is given. Archiving a section keeps its words on the page. */
+export interface SectionInput {
+    expectedRevision: number;
+    action: 'create' | 'alternative' | 'choose' | 'save' | 'reuse' | 'updateUses' | 'rename' | 'archive' | 'tags';
+    sectionId?: string;
+    alternativeId?: string;
+    parentId?: string;
+    label?: string;
+    tags?: string[];
+    fragments?: SectionFragment[];
+    target?: {
+        sceneId: string;
+        at: number;
+        expectedRevision: number;
+    };
+    uses?: Array<{
+        sectionId: string;
+        expectedRevision: number;
+    }>;
+}
+/** A proposed replacement for exact words. It moves with edits around it and
+ * applies only while those words are unchanged (`stale` says they are not).
+ * Suggesting never edits the document; accepting is one undoable write. */
+export interface ScriptSuggestion {
+    id: string;
+    storyboardId: string;
+    sceneId: string;
+    start: number;
+    end: number;
+    original: string;
+    replacement: string;
+    note: string;
+    status: 'pending' | 'accepted' | 'dismissed';
+    stale: boolean;
+    baseRevision: number;
+}
+export interface SuggestionInput {
+    expectedRevision: number;
+    action: 'create' | 'accept' | 'dismiss';
+    suggestions?: Array<{
+        sceneId: string;
+        start: number;
+        end: number;
+        original: string;
+        replacement: string;
+        note?: string;
+    }>;
+    suggestionId?: string;
+}
+export interface VariationChoice {
+    sectionId: string;
+    alternativeId: string;
+}
+/** Enumerate only on demand; even a large Cartesian set costs one row of memory. */
+export declare function variationCombinations(axes: VariationChoice[][], prefix?: VariationChoice[]): Generator<VariationChoice[]>;
+export interface VariationInput {
+    expectedRevision: number;
+    name: string;
+    choices: VariationChoice[];
+    /** When present, this sequence replaces the arrangement: omission and repetition are deliberate. */
+    arrangement?: VariationChoice[];
+    itemOverrides?: Array<{
+        from: string;
+        to: string;
+        voice: 'keep' | 'replace';
+    }>;
+    assetOverrides?: Array<{
+        from: string;
+        to: string;
+    }>;
+    idempotencyKey?: string;
+}
+//# sourceMappingURL=script-document.d.ts.map

package/dist/prompts/script-document.js

@@ -0,0 +1,11 @@
+/** Enumerate only on demand; even a large Cartesian set costs one row of memory. */
+export function* variationCombinations(axes, prefix = []) {
+    if (!axes.length) {
+        yield prefix;
+        return;
+    }
+    const [head, ...tail] = axes;
+    for (const choice of head)
+        yield* variationCombinations(tail, [...prefix, choice]);
+}
+//# sourceMappingURL=script-document.js.map

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

@@ -87,7 +87,7 @@ export interface SpeechRate {
  */
 export declare const SPEECH_RATE_QUERY: string;
 /** When the numbers below were last derived from the query above. */
-export declare const SPEECH_RATE_MEASURED_ON = "2026-09-04";
+export declare const SPEECH_RATE_MEASURED_ON = "2026-09-30";
 /**
  * 🔑 THE REGISTER SPLIT IS REAL AND MEASURED, which is why there is no single
  * number. the performed, genre-acted reads run a median of 133 wpm;
@@ -102,8 +102,8 @@ export declare const SPEECH_RATE: {
         readonly segment: "speech_rate = 'performed'";
     };
     readonly conversational: {
-        readonly wpm: 159;
-        readonly n: 41;
+        readonly wpm: 153;
+        readonly n: 43;
         readonly segment: "speech_rate = 'conversational'";
     };
     readonly direct_response: {
@@ -119,7 +119,7 @@ export declare const SPEECH_RATE: {
      */
     readonly ceiling: {
         readonly wpm: 283;
-        readonly n: 65;
+        readonly n: 67;
         readonly segment: "max over every marked row";
     };
 };

package/dist/prompts/shot-grammar.js

@@ -124,7 +124,7 @@ SELECT id, speech_rate, duration_seconds, transcript
 -- statistic: median per register; ceiling = max over every marked row
 `.trim();
 /** When the numbers below were last derived from the query above. */
-export const SPEECH_RATE_MEASURED_ON = '2026-09-04';
+export const SPEECH_RATE_MEASURED_ON = '2026-09-30';
 /**
  * 🔑 THE REGISTER SPLIT IS REAL AND MEASURED, which is why there is no single
  * number. the performed, genre-acted reads run a median of 133 wpm;
@@ -134,7 +134,7 @@ export const SPEECH_RATE_MEASURED_ON = '2026-09-04';
  */
 export const SPEECH_RATE = {
     performed: { wpm: 133, n: 4, segment: "speech_rate = 'performed'" },
-    conversational: { wpm: 159, n: 41, segment: "speech_rate = 'conversational'" },
+    conversational: { wpm: 153, n: 43, segment: "speech_rate = 'conversational'" },
     direct_response: { wpm: 169, n: 20, segment: "speech_rate = 'direct_response'" },
     /**
      * The fastest read in the whole corpus. **The fit check flags only ABOVE
@@ -142,7 +142,7 @@ export const SPEECH_RATE = {
      * 250, not p90: those are rates real ads actually hit, and flagging an
      * achievable read is exactly how a check gets ignored.
      */
-    ceiling: { wpm: 283, n: 65, segment: 'max over every marked row' },
+    ceiling: { wpm: 283, n: 67, segment: 'max over every marked row' },
 };
 /**
  * The default register, and there is deliberately no picker for it.

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),