AI media harness for planning, generating, and editing locally
TypeScript
Retire Long Shot scene selection
Bitti89a322aafb8a
diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.mdindex e3c06d8..aae7a2b 100644--- a/RELEASE_NOTES.md+++ b/RELEASE_NOTES.md@@ -22,6 +22,8 @@ Changes since 0.3.2.## Fixes and improvements+- Retired Long Shot from scene choices; use Bridge to connect videos. Existing Long Shot scenes remain compatible.+- Video cards match Shot sizing, show the opening playback frame and open scenes on click; playback shares Timeline's prepared players. Returning to the Video tab restores the open video.- Video card and popout playback preserve full rendered scene ranges and keep decoders running through background updates.- Application Back returns from scenes to Video and from image versions to their parent bar.diff --git a/docs/scene-types.md b/docs/scene-types.mdindex 94e4175..b30dd80 100644--- a/docs/scene-types.md+++ b/docs/scene-types.md@@ -4,9 +4,9 @@ Videos contain ordered Scenes, which contain Shots. The Video library supports fVideo settings provide a shared prompt with reference chips, background music and a reference video. Each scene receives the reference range at its cumulative start time: a 10-second first scene uses 0–10 seconds, and the next starts at 10 seconds. Imported/generated media uses the complete asset; reference entries use their saved trim range. Reordering or resizing scenes updates these ranges for the next generation. A source that ends too early blocks generation.-For a music video, select a complete song on an empty Video and choose **Create scenes for song** to divide its full duration into roughly 10-second scenes. Add visual direction and an image reference to the shared prompt, or select a reference video: SlopFab sound references need visual conditioning and References/Singularity weights. Music guides generated audio; add the original song to Timeline when you want its exact soundtrack. Shared media references support Prompt, Single Shot, Continue, First & Last Frame, Backdrop, Pose and Long Shot scenes; each scene must last at least two seconds.+For a music video, select a complete song on an empty Video and choose **Create scenes for song** to divide its full duration into roughly 10-second scenes. Add visual direction and an image reference to the shared prompt, or select a reference video: SlopFab sound references need visual conditioning and References/Singularity weights. Music guides generated audio; add the original song to Timeline when you want its exact soundtrack. Shared media references support Prompt, Single Shot, Continue, First & Last Frame, Backdrop and Pose scenes; each scene must last at least two seconds.-The Scene panel saves a type on each scene:+The Scene panel saves a type on each scene. Long Shot is retired; use Bridge to connect videos. Saved Long Shot scenes retain their generation and playback behavior, while new or duplicated scenes use the available types.- **Prompt** is the default for ordinary video scenes. It supports shot descriptions, speech, Look, sound, music and references cited in prompts, without start- or last-frame selectors. Stored frame anchors and continuation links are inactive.- **Single Shot** keeps its main prompt in the Shot panel and an optional **Ending prompt** in the Scene panel, both with reference support. It generates an ending first, then anchors the full shot to it; a blank ending prompt uses the main prompt. **Starting video** accepts any generated scene. Its final latents anchor only the beginning; the middle starts from fresh noise and is guided toward the generated ending. The former Continuation strength is ignored. Use matching resolution/upscale settings, at least two seconds, and updated workers. Generate all handles dependency order.diff --git a/docs/slopfab-compatibility.md b/docs/slopfab-compatibility.mdindex 3fb114b..7285cef 100644--- a/docs/slopfab-compatibility.md+++ b/docs/slopfab-compatibility.md@@ -218,7 +218,10 @@ diagnostic getter failure logs a warning without discarding generated media.Both bundled runtimes include the new getter. Restart/rebuild the running appto load the new library and logging code.-## API 1.26: Long Shot latent bridges+## API 1.26: legacy Long Shot latent bridges++Long Shot is no longer offered for new scenes; use Bridge instead. This support+remains for saved projects and their generated media.Consecutive **Long Shot** scenes alternate fresh anchors and bridges. Generateall queues 1, 3, 2, 5, 4, 7, 6. A bridge requires completed neighbors with saveddiff --git a/src/components/workspace/GeneratorView.test.tsx b/src/components/workspace/GeneratorView.test.tsxindex f55d8c1..5e58ddf 100644--- a/src/components/workspace/GeneratorView.test.tsx+++ b/src/components/workspace/GeneratorView.test.tsx@@ -184,18 +184,23 @@ it.each(["queued", "generating", "ready", "draft", "failed"] as const)("allows Sexpect(submitted.mock.calls[0][0][0].request.previousSceneId).toBe("start");});-it("persists Long Shot boundary controls and inherits the scene type for new scenes", () => {+it("preserves saved Long Shot controls but offers Bridge and creates new Prompt scenes", () => {const initial = project();initial.generationJobs.push(createDraftGenerationJob("Keep walking", { id: "third" }));initial.generationJobs.forEach((job) => { job.sceneType = "long-shot"; });const state = setup(initial);fireEvent.click(screen.getByRole("button", { name: "Select scene Second scene" }));+ const picker = screen.getByRole("combobox", { name: "Scene type" });+ expect(picker).toHaveTextContent("Long Shot (legacy)");+ const options = optionNames(picker);+ expect(options).not.toContain("Long Shot");+ expect(options).toContain("Bridge");choose("Edit previous ending", "34 frames (1.42 s)");choose("Edit following beginning", "0 frames (0.00 s)");expect(state.latest().generationJobs[1]).toMatchObject({ sceneType: "long-shot", bridgeLeftMargin: 34, bridgeRightMargin: 0 });expect(screen.queryByLabelText("Start frame for this scene")).toBeNull();fireEvent.click(screen.getByRole("button", { name: "Add scene" }));- expect(state.latest().generationJobs.at(-1)?.sceneType).toBe("long-shot");+ expect(state.latest().generationJobs.at(-1)?.sceneType).toBe("prompt");});it.each([2, 4, 6])("queues every scene in a %s-scene Long Shot, ending with a continuation", (count) => {diff --git a/src/components/workspace/GeneratorView.tsx b/src/components/workspace/GeneratorView.tsxindex 2dc67c5..56d8c5c 100644--- a/src/components/workspace/GeneratorView.tsx+++ b/src/components/workspace/GeneratorView.tsx@@ -367,7 +367,7 @@ export function GeneratorView({ config, sceneIds, toolbarStart, folderPath, runtreferences already named by its shots. */const newScene = () => {const job = createDraftGenerationJob("", { steps: defaultGenerationSteps,- sceneType: selectedTemplate.mode === "animate" ? "animate" : selected?.sceneType === "single-shot" ? "single-shot" : selected?.sceneType === "long-shot" ? "long-shot" : "prompt" });+ sceneType: selectedTemplate.mode === "animate" ? "animate" : selected?.sceneType === "single-shot" ? "single-shot" : "prompt" });onChange({ ...config, generationJobs: [...config.generationJobs, job] });setSelection({ jobId: job.id, shotId: null });};diff --git a/src/components/workspace/SceneEditor.tsx b/src/components/workspace/SceneEditor.tsxindex 5cf397f..09363af 100644--- a/src/components/workspace/SceneEditor.tsx+++ b/src/components/workspace/SceneEditor.tsx@@ -273,7 +273,6 @@ const SCENE_TYPES: { value: SceneType; label: string }[] = [{ value: "single-shot", label: "Single Shot" },{ value: "first-last-frame", label: "First & last frame" },{ value: "backdrop", label: "Backdrop" },- { value: "long-shot", label: "Long Shot" },{ value: "continue", label: "Continue" },{ value: "animate", label: "Animate" },{ value: "pose", label: "Pose" },@@ -302,7 +301,7 @@ const SCENE_TYPE_DESCRIPTIONS: Record<SceneType, string> = {"single-shot": "Generate an ending first, then a continuous shot guided by that ending and an optional starting scene.","first-last-frame": "Generate video guided by optional start and last images, with shot descriptions controlling the action.",backdrop: "Generate subjects and action against a solid green, blue, black or white background for keying.",- "long-shot": "Build a longer continuous sequence by generating clips and connecting them. Generate all handles the required order.",+ "long-shot": "Legacy scene type. Use Bridge to connect videos in new scenes.",continue: "Continue a previously generated scene from its saved beginning or ending, with adjustable overlap.",animate: "Animate a repainted frame using a reference video's motion. Requires an Animate generator; output is limited to 14.375 seconds.",pose: "Use a reference video's body poses, movement and timing while prompts and references define the subject and setting.",@@ -363,9 +362,9 @@ export function SceneInspector({ job, shots, references, folderPath = "", scenesreturn <section className="scene-inspector" aria-label="This scene"><div role="region" aria-label="Scene" className="scene-settings">- <PropSection title="Scene" persistKey="generator.scene" summary={SCENE_TYPES.find((type) => type.value === sceneType)?.label}>+ <PropSection title="Scene" persistKey="generator.scene" summary={SCENE_TYPES.find((type) => type.value === sceneType)?.label ?? "Long Shot (legacy)"}><PropRow label="Scene type" htmlFor={`${id}-type`} tooltip={SCENE_TYPE_DESCRIPTIONS[sceneType]}>- <ComboBox id={`${id}-type`} aria-label="Scene type" value={sceneType} disabled={disabled} options={SCENE_TYPES}+ <ComboBox id={`${id}-type`} aria-label="Scene type" value={sceneType} disabled={disabled} options={SCENE_TYPES} placeholder="Long Shot (legacy)"onChange={(value) => onChange({ sceneType: value as SceneType, usePreviousSceneLastFrame: undefined,...(value === "animate" ? { endFrameReferenceId: undefined } : {}) })} /></PropRow>@@ -382,11 +381,12 @@ export function SceneInspector({ job, shots, references, folderPath = "", scenes<SingleShotEndingPrompt job={job} references={references} folderPath={folderPath} disabled={disabled} onChange={onChange} /></>}{longShot && <>+ <p className="prop-caption">Long Shot is retained for this saved scene. Use Bridge to connect videos in new scenes.</p><p className="prop-caption">{longShot.continuation- ? `Continue from ${longShot.left?.title ?? "the previous scene"}. Generate all completes the preceding scenes first. Adding a following Long Shot scene turns this scene into a bridge.`+ ? `Continue from ${longShot.left?.title ?? "the previous scene"}. Generate all completes the preceding scenes first.`: longShot.bridge- ? `Bridge between ${longShot.left?.title ?? "the previous scene"} and ${longShot.right?.title ?? "a following Long Shot scene (add one first)"}. Both neighbors must be generated first. Generate all handles this order.`- : "Generate a fresh clip. The next Long Shot scene bridges this clip to the following fresh clip."}</p>+ ? `Bridge between ${longShot.left?.title ?? "the previous scene"} and ${longShot.right?.title ?? "the following scene"}. Both neighbors must be generated first. Generate all handles this order.`+ : "Generate a fresh anchor for the saved sequence."}</p>{longShot.bridge && ([['bridgeLeftMargin', 'Edit previous ending'], ['bridgeRightMargin', 'Edit following beginning']] as const).map(([key, label]) =><PropRow key={key} label={label} htmlFor={`${id}-${key}`} tooltip="Frames regenerated along with the bridge, at 24 fps. Zero preserves the anchor latents. The joined decode updates playback for both neighbors."><ComboBox id={`${id}-${key}`} aria-label={label} disabled={disabled} value={String(job[key] ?? 17)}diff --git a/src/lib/project.ts b/src/lib/project.tsindex f49c606..a9e7502 100644--- a/src/lib/project.ts+++ b/src/lib/project.ts@@ -467,6 +467,7 @@ export const SCENE_MIN_SECONDS = 0;* length is read as — the length every shot has always been generated at. */export const DEFAULT_SCENE_SECONDS = 6;+// Keep long-shot readable for saved projects and generation history; new scenes use Bridge instead.export const sceneTypeSchema = z.enum(["prompt", "single-shot", "first-last-frame", "continue", "animate", "pose", "character-replace", "extend", "bridge", "backdrop", "long-shot"]);export type SceneType = z.infer<typeof sceneTypeSchema>;export const DEFAULT_CONTINUATION_OVERLAP = 22;diff --git a/src/lib/sceneHistory.test.ts b/src/lib/sceneHistory.test.tsindex 9c848bd..a911557 100644--- a/src/lib/sceneHistory.test.ts+++ b/src/lib/sceneHistory.test.ts@@ -115,11 +115,13 @@ describe("scene generation history", () => {history.versions.push({ ...history.versions[0], id: "future" });expect(parseProjectConfig(JSON.parse(JSON.stringify(config))).generationJobs[0].generationHistory!.versions).toHaveLength(5);});- it("duplicates inputs and shots with fresh identity and no output or generation history", () => {+ it.each(["prompt", "long-shot"] as const)("duplicates %s inputs as a Prompt scene with fresh identity and no output or history", (sceneType) => {const config = finish(edit(initial(), "First"), "one");+ config.generationJobs[0].sceneType = sceneType;const duplicated = duplicateScene(config, config.generationJobs[0].id)!;const original = config.generationJobs[0], copy = duplicated.config.generationJobs[1];- expect(copy).toMatchObject({ title: `${original.title} copy`, music: "First", steps: 4, seed: 10, status: "draft" });+ expect(copy).toMatchObject({ title: `${original.title} copy`, music: "First", steps: 4, seed: 10, status: "draft", sceneType: "prompt" });+ expect(original.sceneType).toBe(sceneType);expect(copy.id).not.toBe(original.id); expect(copy.shots![0].id).not.toBe(original.shots![0].id);expect(copy.outputRelativePath).toBeFalsy(); expect(copy.generationHistory).toBeUndefined(); expect(copy.clipId).toBeFalsy();copy.shots![0].action = "Changed"; expect(original.shots![0].action).toBe("First");diff --git a/src/lib/sceneHistory.ts b/src/lib/sceneHistory.tsindex d2829da..a24b744 100644--- a/src/lib/sceneHistory.ts+++ b/src/lib/sceneHistory.ts@@ -144,6 +144,7 @@ export function duplicateScene(config: ProjectConfig, sceneId: string): { configconst id = `job-${crypto.randomUUID()}`;const base = createDraftGenerationJob("", { id, title: `${source.title} copy` });const job = applyInput(base, { ...sceneInput(source), title: `${source.title} copy`,+ ...(source.sceneType === "long-shot" ? { sceneType: "prompt" as const } : {}),shots: sceneShots(source).map(shot => ({ ...structuredClone(shot), id: `shot-${crypto.randomUUID()}` })) });const index = config.generationJobs.indexOf(source);return { id, config: { ...config, generationJobs: [...config.generationJobs.slice(0, index + 1), job, ...config.generationJobs.slice(index + 1)] } };diff --git a/src/lib/videoLibrary.ts b/src/lib/videoLibrary.tsindex 531784d..d9692e7 100644--- a/src/lib/videoLibrary.ts+++ b/src/lib/videoLibrary.ts@@ -43,7 +43,7 @@ export function videoGuidedScene(job: GenerationJob, config: ProjectConfig): { jconst guidance: string[] = video.prompt.trim() ? [video.prompt.trim()] : [];let blocker: string | null = null;if ((video.musicSource || video.videoSource) && ["animate", "character-replace", "extend", "bridge"].includes(job.sceneType ?? "")) {- blocker = "Video-level references require a Prompt, Single Shot, Continue, First & Last Frame, Backdrop, Pose or Long Shot scene.";+ blocker = "Video-level references require a Prompt, Single Shot, Continue, First & Last Frame, Backdrop or Pose scene.";}for (const kind of ["audio", "video"] as const) {const chosen = kind === "audio" ? video.musicSource : video.videoSource;