@clipwright/core 0.19.0 → 0.20.0

package/dist/faceless-short-61.js

@@ -0,0 +1,152 @@
+import { z } from "zod";
+import { brollPolicy } from "./broll-policy.js";
+import { CANVAS_FPS } from "./media-timebase.js";
+import { speechTextFor, TTS_MODEL_CHAR_CAP, TTS_MODELS } from "./voices.js";
+export const SHORT61_BOUNDARIES = [
+    0, 93, 162, 309, 412, 472, 562, 643, 753, 822, 902, 948,
+    1010, 1081, 1192, 1243, 1316, 1344, 1373, 1410, 1447, 1484, 1522,
+];
+const id = z.string().trim().min(1);
+const imageAsset = z.strictObject({
+    id,
+    role: z.enum(["scene", "style", "character"]),
+    prompt: z.string().trim().min(1),
+    origin: z.enum(["prior_probe", "new"]),
+    styleAssetId: id.optional(),
+    characterAssetIds: z.array(id).optional(),
+});
+const replacementAttempt = z.strictObject({
+    id,
+    replacesAssetId: id,
+    prompt: z.string().trim().min(1),
+});
+const shot = z.strictObject({
+    id,
+    mediaType: z.enum(["video", "image"]),
+    assetId: id,
+    startFrame: z.number().int().nonnegative().safe(),
+    endFrame: z.number().int().positive().safe(),
+    motion: z.enum(["PAN_UP", "PAN_DOWN"]).optional(),
+});
+const captionPhrase = z.strictObject({
+    wordStart: z.number().int().nonnegative(),
+    wordEnd: z.number().int().positive(),
+    accentWord: z.number().int().nonnegative(),
+});
+const plan = z.strictObject({
+    version: z.literal("faceless_short_61_v1"),
+    pricingVersion: z.literal("faceless-image-v1-shadow"),
+    budgetVersion: z.literal("short61-five-usd-provisional-v1"),
+    aspectRatio: z.literal("9:16"),
+    resolution: z.literal("1080p"),
+    brollPolicy,
+    script: z.string().trim().min(1),
+    voice: z.strictObject({ model: z.enum(TTS_MODELS), voiceId: id }),
+    styleAssetId: id,
+    characterAssetId: id,
+    imageAssets: z.array(imageAsset),
+    replacementAttempts: z.array(replacementAttempt),
+    openingVideo: z.strictObject({ assetId: id, prompt: z.string().trim().min(1) }),
+    shots: z.array(shot).length(22),
+    captionPhrases: z.array(captionPhrase).min(1),
+});
+export function parseShort61Plan(input) {
+    const parsed = plan.parse(input);
+    if (speechTextFor(parsed.script, parsed.voice.model).length > TTS_MODEL_CHAR_CAP[parsed.voice.model]) {
+        throw new Error("short61 script exceeds the selected speech model limit");
+    }
+    if (parsed.brollPolicy !== "anyone")
+        throw new Error("short61 Mira scenes require the anyone policy");
+    const assets = new Map();
+    for (const asset of parsed.imageAssets) {
+        if (assets.has(asset.id) || asset.id === parsed.openingVideo.assetId)
+            throw new Error(`duplicate short61 asset ID: ${asset.id}`);
+        assets.set(asset.id, asset);
+    }
+    if (assets.get(parsed.styleAssetId)?.role !== "style" || assets.get(parsed.characterAssetId)?.role !== "character") {
+        throw new Error("short61 style and character references have wrong roles");
+    }
+    if (parsed.styleAssetId === parsed.characterAssetId)
+        throw new Error("short61 reference IDs must differ");
+    const sceneAssets = parsed.imageAssets.filter(asset => asset.role === "scene");
+    if (sceneAssets.length !== 21 || parsed.imageAssets.length !== 23) {
+        throw new Error("short61 requires 21 scenes and two shared references");
+    }
+    for (const asset of parsed.imageAssets) {
+        if (asset.role !== "scene") {
+            if (asset.styleAssetId !== undefined || asset.characterAssetIds !== undefined) {
+                throw new Error(`short61 references belong only on scene assets: ${asset.id}`);
+            }
+            continue;
+        }
+        if (asset.styleAssetId !== parsed.styleAssetId ||
+            asset.characterAssetIds?.length !== 1 ||
+            asset.characterAssetIds[0] !== parsed.characterAssetId) {
+            throw new Error(`short61 scene ${asset.id} must use shared style and Mira references`);
+        }
+    }
+    const usedImages = new Set();
+    const shotIds = new Set();
+    for (let i = 0; i < parsed.shots.length; i++) {
+        const current = parsed.shots[i];
+        if (shotIds.has(current.id))
+            throw new Error(`duplicate short61 shot ID: ${current.id}`);
+        shotIds.add(current.id);
+        if (current.id !== `shot_${i + 1}` ||
+            current.startFrame !== SHORT61_BOUNDARIES[i] ||
+            current.endFrame !== SHORT61_BOUNDARIES[i + 1] ||
+            current.mediaType !== (i === 0 ? "video" : "image") ||
+            (i === 0 && (current.assetId !== parsed.openingVideo.assetId || current.motion !== undefined)) ||
+            (i > 0 && current.motion !== (i % 2 === 1 ? "PAN_UP" : "PAN_DOWN"))) {
+            throw new Error(`short61 shot ${i + 1} differs from the frozen frame plan`);
+        }
+        if (i > 0) {
+            if (assets.get(current.assetId)?.role !== "scene" || usedImages.has(current.assetId)) {
+                throw new Error(`short61 shot ${i + 1} needs a distinct scene image`);
+            }
+            usedImages.add(current.assetId);
+        }
+    }
+    for (const asset of sceneAssets) {
+        if (!usedImages.has(asset.id))
+            throw new Error(`unreferenced short61 scene image: ${asset.id}`);
+    }
+    const attemptIds = new Set(assets.keys());
+    attemptIds.add(parsed.openingVideo.assetId);
+    for (const attempt of parsed.replacementAttempts) {
+        if (attemptIds.has(attempt.id))
+            throw new Error(`duplicate short61 replacement ID: ${attempt.id}`);
+        attemptIds.add(attempt.id);
+        if (assets.get(attempt.replacesAssetId)?.role !== "scene") {
+            throw new Error(`short61 replacement target is not a scene: ${attempt.replacesAssetId}`);
+        }
+    }
+    const outputFrames = SHORT61_BOUNDARIES.at(-1);
+    const imageAllowance = Math.floor(24 * outputFrames / (60 * CANVAS_FPS));
+    if (parsed.imageAssets.length + parsed.replacementAttempts.length > imageAllowance) {
+        throw new Error("short61 image allowance exceeded");
+    }
+    for (const phrase of parsed.captionPhrases) {
+        if (phrase.wordEnd <= phrase.wordStart || phrase.accentWord < phrase.wordStart || phrase.accentWord >= phrase.wordEnd) {
+            throw new Error("short61 caption phrase indices are invalid");
+        }
+    }
+    return parsed;
+}
+export function reportShort61(input) {
+    const parsed = parseShort61Plan(input);
+    const baseGeneratedImages = parsed.imageAssets.length;
+    const replacementAttempts = parsed.replacementAttempts.length;
+    return {
+        outputFrames: 1522,
+        imageAllowance: 24,
+        baseGeneratedImages,
+        replacementAttempts,
+        retryHeadroom: 24 - baseGeneratedImages - replacementAttempts,
+        imageOnlyComparisonCredits: 200,
+        videoPriceStatus: "unpriced",
+        maxPaidAttempts: 0,
+        maxUsdSpend: 0,
+    };
+}
+//# sourceMappingURL=faceless-short-61.js.map

package/dist/faceless-short-61.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"faceless-short-61.js","sourceRoot":"","sources":["../src/faceless-short-61.ts"],"names":[],"mappings":"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"}

package/dist/faceless-storyboard-timing.d.ts

@@ -0,0 +1,40 @@
+import { type StoryboardProposal } from "./faceless-storyboard.js";
+type WordTiming = {
+    word: string;
+    startSec: number;
+    endSec: number;
+};
+type PhraseRange = {
+    wordStart: number;
+    wordEnd: number;
+    accentWord: number;
+};
+type Cut = {
+    afterWord: number;
+    frame: number;
+    reason: string;
+};
+export type StoryboardFramePlan = {
+    version: "faceless_storyboard_61_v1";
+    outputFrames: 1522;
+    script: string;
+    captionPhrases: PhraseRange[];
+    narrationStartFrame: number;
+    shots: Array<{
+        id: string;
+        mediaType: "video" | "image";
+        startFrame: number;
+        endFrame: number;
+        motion?: "PAN_UP" | "PAN_DOWN";
+        beatIds: string[];
+        cutAfterWord?: number;
+        cutReason?: string;
+    }>;
+    rejectedCandidates: Cut[];
+    imageBudget: {
+        allowance: 24;
+        remaining: number;
+    };
+};
+export declare function planStoryboardFrames(input: StoryboardProposal, words: readonly WordTiming[], narrationStartFrame: number): StoryboardFramePlan;
+export {};

package/dist/faceless-storyboard-timing.js

@@ -0,0 +1,97 @@
+import { assertStoryboardWords, parseStoryboardProposal, storyboardImageBudget } from "./faceless-storyboard.js";
+const priority = { place: 4, reveal: 4, action: 3, emphasis: 1 };
+function better(candidate, current) {
+    return !current || candidate.score > current.score ||
+        (candidate.score === current.score && candidate.penalty < current.penalty);
+}
+export function planStoryboardFrames(input, words, narrationStartFrame) {
+    const proposal = parseStoryboardProposal(input);
+    assertStoryboardWords(proposal.script, words);
+    if (!Number.isSafeInteger(narrationStartFrame) || narrationStartFrame < 0 || narrationStartFrame >= 1522) {
+        throw new Error("invalid narration start frame");
+    }
+    const speechEnd = narrationStartFrame / 25 + words[words.length - 1].endSec;
+    if (speechEnd > 1522 / 25)
+        throw new Error("narration exceeds output duration");
+    if (1522 / 25 - speechEnd > 0.5 + 1e-9)
+        throw new Error("narration leaves more than 0.5 seconds tail");
+    const candidates = proposal.beats.slice(1).map((beat, i) => {
+        const afterWord = beat.wordStart - 1;
+        const previous = words[afterWord];
+        const next = words[afterWord + 1];
+        const edgeSec = next.startSec > previous.endSec ? (previous.endSec + next.startSec) / 2 : next.startSec;
+        const frame = narrationStartFrame + Math.round(edgeSec * 25);
+        if (!Number.isSafeInteger(frame) || frame <= 0 || frame >= 1522)
+            throw new Error("cut outside output");
+        const time = (frame - narrationStartFrame) / 25;
+        const inside = words.some(w => time - w.startSec > 1 / 25 + 1e-9 && w.endSec - time > 1 / 25 + 1e-9);
+        return { afterWord, frame, reason: beat.reason, beatIndex: i + 1, priority: priority[beat.reason],
+            ...(inside ? { rejection: "cut more than one frame inside timed word" } : {}) };
+    });
+    const opener = candidates[0];
+    if (opener.rejection || opener.frame < 75 || opener.frame > 125) {
+        throw new Error("no feasible storyboard: mandatory VIDEO boundary violates timing");
+    }
+    const nodes = [...candidates, { frame: 1522, beatIndex: proposal.beats.length, priority: 0, afterWord: words.length - 1, reason: "output end" }];
+    const states = nodes.map(() => Array(20));
+    states[0][0] = { score: opener.priority, penalty: 0, previous: -1 };
+    for (let end = 1; end < nodes.length; end++) {
+        const destination = nodes[end];
+        if ("rejection" in destination && destination.rejection)
+            continue;
+        for (let start = 0; start < end; start++) {
+            const duration = destination.frame - nodes[start].frame;
+            if (duration < 25 || duration > 150)
+                continue;
+            for (let count = 1; count <= 19; count++) {
+                const prior = states[start][count - 1];
+                if (!prior)
+                    continue;
+                const state = { score: prior.score + destination.priority,
+                    penalty: prior.penalty + Math.abs(duration - 68.75), previous: start };
+                if (better(state, states[end][count]))
+                    states[end][count] = state;
+            }
+        }
+    }
+    const last = nodes.length - 1;
+    let imageCount = 0;
+    let best;
+    for (let count = 1; count <= 19; count++) {
+        const state = states[last][count];
+        if (state && better(state, best)) {
+            best = state;
+            imageCount = count;
+        }
+    }
+    if (!best)
+        throw new Error("no feasible storyboard within scene duration and image budget limits");
+    const chosen = [last];
+    let cursor = last;
+    for (let count = imageCount; count > 0; count--) {
+        cursor = states[cursor][count].previous;
+        chosen.push(cursor);
+    }
+    chosen.reverse();
+    const selected = new Set(chosen);
+    const shots = [];
+    let startFrame = 0;
+    let beatStart = 0;
+    for (const [shotIndex, nodeIndex] of chosen.entries()) {
+        const node = nodes[nodeIndex];
+        shots.push({ id: proposal.beats[beatStart].id, mediaType: shotIndex === 0 ? "video" : "image",
+            startFrame, endFrame: node.frame,
+            ...(shotIndex > 0 ? { motion: shotIndex % 2 === 1 ? "PAN_UP" : "PAN_DOWN" } : {}),
+            beatIds: proposal.beats.slice(beatStart, node.beatIndex).map(b => b.id),
+            ...(nodeIndex < last ? { cutAfterWord: node.afterWord, cutReason: node.reason } : {}), });
+        startFrame = node.frame;
+        beatStart = node.beatIndex;
+    }
+    return { version: proposal.version, outputFrames: 1522, script: proposal.script,
+        captionPhrases: proposal.captionPhrases, narrationStartFrame, shots,
+        rejectedCandidates: candidates.flatMap((candidate, i) => selected.has(i) ? [] : [{
+                afterWord: candidate.afterWord, frame: candidate.frame,
+                reason: candidate.rejection ?? `unselected ${candidate.reason} boundary under timing and image budget constraints`,
+            }]), imageBudget: storyboardImageBudget(imageCount, 2) };
+}
+//# sourceMappingURL=faceless-storyboard-timing.js.map

package/dist/faceless-storyboard-timing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"faceless-storyboard-timing.js","sourceRoot":"","sources":["../src/faceless-storyboard-timing.ts"],"names":[],"mappings":"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"}

package/dist/faceless-storyboard-v2-plan.d.ts

@@ -0,0 +1,3 @@
+import type { StoryboardV2FramePlan } from "./faceless-storyboard-v2-timing.js";
+import type { WordTiming } from "./tts-backend.js";
+export declare function parseStoryboardV2Plan(input: unknown, words: readonly WordTiming[]): StoryboardV2FramePlan;

package/dist/faceless-storyboard-v2-plan.js

@@ -0,0 +1,112 @@
+import { assertStoryboardWords } from "./faceless-storyboard.js";
+const phases = ["setup", "development", "climax", "resolution"];
+const reasons = ["action", "place", "reveal", "emphasis"];
+function record(value, keys) {
+    if (!value || typeof value !== "object" || Array.isArray(value) ||
+        Object.keys(value).some(key => !keys.includes(key)))
+        throw new Error("invalid storyboard v2 object or unknown fields");
+    return value;
+}
+function uint(value) { return Number.isSafeInteger(value) && value >= 0; }
+function finite(value) { return typeof value === "number" && Number.isFinite(value) && value >= 0; }
+function label(value) { return typeof value === "string" && value.trim().length > 0; }
+function score(value) {
+    const s = record(value, ["semanticValue", "cutCost", "pacePenalty", "net"]);
+    if (!finite(s.semanticValue) || !finite(s.cutCost) || !finite(s.pacePenalty) ||
+        typeof s.net !== "number" || !Number.isFinite(s.net) ||
+        Math.abs(s.net - (s.semanticValue - s.cutCost - s.pacePenalty)) > 1e-8)
+        throw new Error("invalid storyboard v2 score");
+}
+export function parseStoryboardV2Plan(input, words) {
+    const raw = record(input, ["version", "outputFrames", "script", "narrationStartFrame", "captionPhrases", "shots", "rejectedCandidates", "scoreBreakdown"]);
+    if (raw.version !== "faceless_storyboard_61_v2" || raw.outputFrames !== 1522 || !label(raw.script) ||
+        !uint(raw.narrationStartFrame) || raw.narrationStartFrame > 50 ||
+        !Array.isArray(raw.shots) || raw.shots.length < 2 ||
+        !Array.isArray(raw.captionPhrases) || !raw.captionPhrases.length || !Array.isArray(raw.rejectedCandidates)) {
+        throw new Error("invalid storyboard v2 frame plan");
+    }
+    assertStoryboardWords(raw.script, words);
+    if (raw.narrationStartFrame + words.at(-1).endSec * 25 > 1522 + 1e-9 ||
+        1522 - raw.narrationStartFrame - words.at(-1).endSec * 25 > 12.5 + 1e-9)
+        throw new Error("invalid storyboard v2 narration tail");
+    let captionEnd = 0;
+    for (const phrase of raw.captionPhrases) {
+        const p = record(phrase, ["wordStart", "wordEnd", "accentWord"]);
+        if (!uint(p.wordStart) || !uint(p.wordEnd) || !uint(p.accentWord) || p.wordStart !== captionEnd || p.wordStart >= p.wordEnd ||
+            p.wordEnd > words.length || p.accentWord < p.wordStart || p.accentWord >= p.wordEnd)
+            throw new Error("invalid storyboard v2 caption");
+        captionEnd = p.wordEnd;
+    }
+    if (captionEnd !== words.length)
+        throw new Error("incomplete storyboard v2 captions");
+    const ids = new Set();
+    const beatIds = new Set();
+    let end = 0;
+    let previousWord = -1;
+    let previousPhase = -1;
+    let semanticValue = 0, cutCost = 0, pacePenalty = 0, total = 0, cuts = 0;
+    for (const [i, value] of raw.shots.entries()) {
+        const shot = record(value, ["id", "mediaType", "startFrame", "endFrame", "beatIds", "phase", "mergedPhases", "motion", "panExceptionReason", "cutAfterWord", "cutReason", "score"]);
+        if (!label(shot.id) || ids.has(shot.id))
+            throw new Error("duplicate or invalid storyboard v2 shot ID");
+        ids.add(shot.id);
+        if (!uint(shot.startFrame) || !uint(shot.endFrame) || shot.startFrame !== end || shot.endFrame > 1522 ||
+            shot.endFrame - shot.startFrame < (i ? 25 : 50) || shot.endFrame - shot.startFrame > (i ? 150 : 125) ||
+            shot.mediaType !== (i ? "image" : "video") || (i ? !(typeof shot.motion === "string" && ["PAN_UP", "PAN_DOWN"].includes(shot.motion)) : shot.motion !== undefined) ||
+            !Array.isArray(shot.beatIds) || !shot.beatIds.length || !shot.beatIds.every(label) ||
+            !(typeof shot.phase === "string" && phases.includes(shot.phase)) || phases.indexOf(shot.phase) < previousPhase ||
+            (shot.mergedPhases !== undefined && (!Array.isArray(shot.mergedPhases) || !shot.mergedPhases.length || !shot.mergedPhases.every(p => phases.includes(p)))) ||
+            (shot.panExceptionReason !== undefined && (!i || !label(shot.panExceptionReason))))
+            throw new Error("invalid storyboard v2 shot coverage, duration, or fields");
+        for (const beat of shot.beatIds) {
+            if (beatIds.has(beat))
+                throw new Error("duplicate storyboard v2 beat ID");
+            beatIds.add(beat);
+        }
+        previousPhase = phases.indexOf(shot.phase);
+        end = shot.endFrame;
+        score(shot.score);
+        const s = shot.score;
+        semanticValue += s.semanticValue;
+        cutCost += s.cutCost;
+        pacePenalty += s.pacePenalty;
+        total += s.net;
+        if (i < raw.shots.length - 1) {
+            if (!uint(shot.cutAfterWord) || shot.cutAfterWord <= previousWord || shot.cutAfterWord >= words.length - 1 ||
+                !(typeof shot.cutReason === "string" && reasons.includes(shot.cutReason)))
+                throw new Error("invalid storyboard v2 cut word or reason");
+            const previous = words[shot.cutAfterWord];
+            const next = words[shot.cutAfterWord + 1];
+            const edgeSec = next.startSec > previous.endSec ? (previous.endSec + next.startSec) / 2 : next.startSec;
+            const frame = raw.narrationStartFrame + Math.round(edgeSec * 25);
+            const sec = (shot.endFrame - raw.narrationStartFrame) / 25;
+            if (shot.endFrame !== frame || words.some(w => sec - w.startSec > 1 / 25 + 1e-9 && w.endSec - sec > 1 / 25 + 1e-9)) {
+                throw new Error("storyboard v2 cut lies mid-word or differs from measured boundary");
+            }
+            previousWord = shot.cutAfterWord;
+            cuts++;
+        }
+        else if (shot.cutAfterWord !== undefined || shot.cutReason !== undefined)
+            throw new Error("final storyboard v2 shot cannot end in a cut");
+    }
+    if (end !== 1522)
+        throw new Error("incomplete storyboard v2 output coverage");
+    for (const value of raw.rejectedCandidates) {
+        const candidate = record(value, ["afterWord", "frame", "beatId", "reason", "semanticValue", "cutCost", "pacePenalty", "net"]);
+        if (!uint(candidate.afterWord) || candidate.afterWord >= words.length - 1 || !uint(candidate.frame) || candidate.frame > 1522 ||
+            !label(candidate.beatId) || !label(candidate.reason) || !finite(candidate.semanticValue) || !finite(candidate.cutCost) ||
+            (candidate.pacePenalty !== null && !finite(candidate.pacePenalty)) ||
+            (candidate.net !== null && (typeof candidate.net !== "number" || !Number.isFinite(candidate.net))) ||
+            ((candidate.pacePenalty === null) !== (candidate.net === null)))
+            throw new Error("invalid storyboard v2 rejected candidate");
+    }
+    const summary = record(raw.scoreBreakdown, ["semanticValue", "cutCost", "pacePenalty", "total", "cuts"]);
+    if (!finite(summary.semanticValue) || !finite(summary.cutCost) || !finite(summary.pacePenalty) ||
+        typeof summary.total !== "number" || !Number.isFinite(summary.total) || !uint(summary.cuts) ||
+        Math.abs(summary.semanticValue - semanticValue) > 1e-8 || Math.abs(summary.cutCost - cutCost) > 1e-8 ||
+        Math.abs(summary.pacePenalty - pacePenalty) > 1e-8 || Math.abs(summary.total - total) > 1e-8 || summary.cuts !== cuts) {
+        throw new Error("invalid storyboard v2 score breakdown");
+    }
+    return raw;
+}
+//# sourceMappingURL=faceless-storyboard-v2-plan.js.map

package/dist/faceless-storyboard-v2-plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"faceless-storyboard-v2-plan.js","sourceRoot":"","sources":["../src/faceless-storyboard-v2-plan.ts"],"names":[],"mappings":"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"}

package/dist/faceless-storyboard-v2-timing.d.ts

@@ -0,0 +1,52 @@
+import { type StoryboardV2Proposal } from "./faceless-storyboard-v2.js";
+import type { CutStyleProfile } from "./faceless-cut-style.js";
+import type { WordTiming } from "./tts-backend.js";
+type Phase = StoryboardV2Proposal["beats"][number]["phase"];
+type Score = {
+    semanticValue: number;
+    cutCost: number;
+    pacePenalty: number;
+    net: number;
+};
+export type StoryboardV2FramePlan = {
+    version: "faceless_storyboard_61_v2";
+    outputFrames: 1522;
+    script: string;
+    captionPhrases: StoryboardV2Proposal["captionPhrases"];
+    narrationStartFrame: number;
+    shots: Array<{
+        id: string;
+        mediaType: "video" | "image";
+        startFrame: number;
+        endFrame: number;
+        beatIds: string[];
+        phase: Phase;
+        mergedPhases?: Phase[];
+        motion?: "PAN_UP" | "PAN_DOWN";
+        panExceptionReason?: string;
+        cutAfterWord?: number;
+        cutReason?: string;
+        score: Score;
+    }>;
+    /** Rejected scores are local incoming-edge estimates, not alternate complete-path scores.
+     * Null pacePenalty/net means no feasible incoming edge was reachable. */
+    rejectedCandidates: Array<{
+        afterWord: number;
+        frame: number;
+        beatId: string;
+        reason: string;
+        semanticValue: number;
+        cutCost: number;
+        pacePenalty: number | null;
+        net: number | null;
+    }>;
+    scoreBreakdown: {
+        semanticValue: number;
+        cutCost: number;
+        pacePenalty: number;
+        total: number;
+        cuts: number;
+    };
+};
+export declare function planStoryboardV2(input: StoryboardV2Proposal, words: readonly WordTiming[], narrationStartFrame: number, style: CutStyleProfile): StoryboardV2FramePlan;
+export {};

package/dist/faceless-storyboard-v2-timing.js

@@ -0,0 +1,136 @@
+import { assertStoryboardWords } from "./faceless-storyboard.js";
+import { parseStoryboardV2 } from "./faceless-storyboard-v2.js";
+const semantic = { place: 4, reveal: 4, action: 3, emphasis: 1 };
+const CUT_COST = 2;
+const OUTPUT_FRAMES = 1522;
+const FPS = 25;
+function better(a, b) {
+    if (!b)
+        return true;
+    if (Math.abs(a.total - b.total) > 1e-9)
+        return a.total > b.total;
+    if (a.cuts !== b.cuts)
+        return a.cuts < b.cuts;
+    for (let i = 0; i < a.path.length; i++) {
+        if (a.path[i] !== b.path[i])
+            return a.path[i] < b.path[i];
+    }
+    return false;
+}
+export function planStoryboardV2(input, words, narrationStartFrame, style) {
+    const proposal = parseStoryboardV2(input);
+    assertStoryboardWords(proposal.script, words);
+    if (!Number.isSafeInteger(narrationStartFrame) || narrationStartFrame < 0 || narrationStartFrame > 50) {
+        throw new Error("invalid narration start frame");
+    }
+    const speechEndFrame = narrationStartFrame + words.at(-1).endSec * FPS;
+    if (speechEndFrame > OUTPUT_FRAMES + 1e-9)
+        throw new Error("narration exceeds output duration");
+    if (OUTPUT_FRAMES - speechEndFrame > 12.5 + 1e-9)
+        throw new Error("narration leaves more than 0.5 seconds tail");
+    const candidates = proposal.beats.slice(1).map((beat, i) => {
+        const afterWord = beat.wordStart - 1;
+        const previous = words[afterWord];
+        const next = words[afterWord + 1];
+        const edgeSec = next.startSec > previous.endSec ? (previous.endSec + next.startSec) / 2 : next.startSec;
+        const frame = narrationStartFrame + Math.round(edgeSec * FPS);
+        const time = (frame - narrationStartFrame) / FPS;
+        const inside = words.some(w => time - w.startSec > 1 / FPS + 1e-9 && w.endSec - time > 1 / FPS + 1e-9);
+        return { beatIndex: i + 1, afterWord, frame, reason: beat.reason,
+            ...(frame <= 0 || frame >= OUTPUT_FRAMES ? { invalidReason: "candidate lies outside output frames" } : {}),
+            ...(inside ? { invalidReason: "candidate lies more than one frame inside a timed word" } : {}) };
+    });
+    const opener = candidates[0];
+    if (opener.invalidReason || opener.frame < 50 || opener.frame > 125) {
+        throw new Error(`no feasible storyboard: mandatory VIDEO boundary violates timing${opener.invalidReason ? ` (${opener.invalidReason})` : ""}`);
+    }
+    const nodes = [...candidates, { beatIndex: proposal.beats.length, afterWord: words.length - 1, frame: OUTPUT_FRAMES, reason: "output end" }];
+    const final = nodes.length - 1;
+    const states = Array(nodes.length);
+    const openerValue = semantic[proposal.beats[1].reason];
+    states[0] = { total: openerValue - CUT_COST, semantic: openerValue, cutCost: CUT_COST, pacePenalty: 0,
+        cuts: 1, path: [0], previous: -1, edge: { semanticValue: openerValue, cutCost: CUT_COST, pacePenalty: 0, net: openerValue - CUT_COST } };
+    function pacePenalty(start, end) {
+        const phase = proposal.beats[nodes[start].beatIndex].phase;
+        const phaseRange = style.pacing.by_phase[phase];
+        const range = phaseRange && phaseRange.n > 0 ? phaseRange : style.pacing.global_image_frames;
+        const duration = nodes[end].frame - nodes[start].frame;
+        const distance = duration < range.p25 ? range.p25 - duration : duration > range.p75 ? duration - range.p75 : 0;
+        return 0.25 * distance / 25;
+    }
+    for (let end = 1; end <= final; end++) {
+        const destination = nodes[end];
+        if (destination.invalidReason)
+            continue;
+        const value = end === final ? 0 : semantic[proposal.beats[destination.beatIndex].reason];
+        const cost = end === final ? 0 : CUT_COST;
+        for (let start = 0; start < end; start++) {
+            const prior = states[start];
+            if (!prior)
+                continue;
+            const duration = destination.frame - nodes[start].frame;
+            if (duration < 25 || duration > 150)
+                continue;
+            const penalty = pacePenalty(start, end);
+            const edge = { semanticValue: value, cutCost: cost, pacePenalty: penalty, net: value - cost - penalty };
+            const next = { total: prior.total + edge.net, semantic: prior.semantic + value,
+                cutCost: prior.cutCost + cost, pacePenalty: prior.pacePenalty + penalty,
+                cuts: prior.cuts + (end === final ? 0 : 1), path: [...prior.path, end], previous: start, edge };
+            if (better(next, states[end]))
+                states[end] = next;
+        }
+    }
+    const best = states[final];
+    if (!best)
+        throw new Error("no feasible storyboard within VIDEO and IMAGE duration bounds");
+    const selected = new Set(best.path);
+    const shots = [];
+    let startFrame = 0;
+    let beatStart = 0;
+    for (const [shotIndex, nodeIndex] of best.path.entries()) {
+        const node = nodes[nodeIndex];
+        const current = states[nodeIndex];
+        const included = proposal.beats.slice(beatStart, node.beatIndex);
+        const phases = [...new Set(included.map(b => b.phase))];
+        const holdMotion = style.motion.pan_transition_n > 0 && style.motion.pan_flip_probability !== null && style.motion.pan_flip_probability < 0.5;
+        const motion = shotIndex === 0 ? undefined : holdMotion ? "PAN_UP" : shotIndex % 2 === 1 ? "PAN_UP" : "PAN_DOWN";
+        shots.push({ id: included[0].id, mediaType: shotIndex === 0 ? "video" : "image", startFrame, endFrame: node.frame,
+            beatIds: included.map(b => b.id), phase: included[0].phase,
+            ...(phases.length > 1 ? { mergedPhases: phases } : {}),
+            ...(motion ? { motion } : {}),
+            ...(holdMotion && shotIndex > 1 ? { panExceptionReason: "style profile favors holding PAN direction" } : {}),
+            ...(nodeIndex < final ? { cutAfterWord: node.afterWord, cutReason: node.reason } : {}),
+            score: current.edge });
+        startFrame = node.frame;
+        beatStart = node.beatIndex;
+    }
+    const rejectedCandidates = candidates.flatMap((candidate, index) => {
+        if (selected.has(index))
+            return [];
+        let possiblePenalty = null;
+        if (!candidate.invalidReason) {
+            for (let start = 0; start < index; start++) {
+                if (!states[start])
+                    continue;
+                const duration = candidate.frame - nodes[start].frame;
+                if (duration < 25 || duration > 150)
+                    continue;
+                const penalty = pacePenalty(start, index);
+                possiblePenalty = possiblePenalty === null ? penalty : Math.min(possiblePenalty, penalty);
+            }
+        }
+        const value = semantic[proposal.beats[candidate.beatIndex].reason];
+        const reason = candidate.invalidReason ?? (possiblePenalty === null
+            ? "no reachable preceding IMAGE shot within 25–150 frames"
+            : value < CUT_COST ? "semantic value does not cover fixed cut cost"
+                : "lower total path score or deterministic tie break after IMAGE duration and pace costs");
+        return [{ afterWord: candidate.afterWord, frame: candidate.frame, beatId: proposal.beats[candidate.beatIndex].id,
+                reason, semanticValue: value, cutCost: CUT_COST, pacePenalty: possiblePenalty,
+                net: possiblePenalty === null ? null : value - CUT_COST - possiblePenalty }];
+    });
+    return { version: proposal.version, outputFrames: OUTPUT_FRAMES, script: proposal.script,
+        captionPhrases: proposal.captionPhrases, narrationStartFrame, shots, rejectedCandidates,
+        scoreBreakdown: { semanticValue: best.semantic, cutCost: best.cutCost,
+            pacePenalty: best.pacePenalty, total: best.total, cuts: best.cuts } };
+}
+//# sourceMappingURL=faceless-storyboard-v2-timing.js.map