cozyclay 3.1.1 → 3.1.2

package/src/shell/PreferencesDialog.jsx

@@ -1,185 +1,22 @@
 import { useEffect, useMemo, useRef, useState } from "react";
 import { createPortal } from "react-dom";
-import { getAnalyticsOptOut, setAnalyticsOptOut } from "../analytics.js";
-import { loadAutoColor, saveAutoColor } from "../auto-color.js";
-import { ko, LOCALE, setLocale } from "../locale.js";
-import { readStoredGridView, writeStoredGridView } from "../grid-view.js";
-import { readTheme, saveTheme } from "../theme.js";
+import { ko } from "../locale.js";
+import { getAnalyticsOptOut, loadAutoColor, preferenceSection, readStoredGridView } from "./preference-pages.jsx";
 import "./preferences.css";
 
-const LANGUAGES = [
-	{ id: "en", label: "English", action: "Switch to English" },
-	{ id: "ko", label: "한국어", action: "한국어로 전환" },
-];
-
-// Only pages whose settings reach the editor are listed; a control that
-// changes nothing is not offered.
 const NAV_GROUPS = [
 	{
 		label: ko("General", "일반"),
 		items: [
 			{ id: "Appearance", label: ko("Appearance", "모양") },
 			{ id: "Viewport", label: ko("Viewport", "뷰포트") },
+			{ id: "Export", label: ko("Export", "내보내기") },
 			{ id: "Hotkeys", label: ko("Hotkeys", "단축키") },
 		],
 	},
 ];
 const NAV_LABELS = Object.fromEntries(NAV_GROUPS.flatMap((group) => group.items.map((item) => [item.id, item.label])));
 
-const MOD = typeof navigator !== "undefined" && /Mac|iPhone|iPad/.test(navigator.platform ?? "") ? "⌘" : "Ctrl ";
-
-const HOTKEYS = [
-	["Move", "W", "이동"],
-	["Rotate", "E", "회전"],
-	["Scale", "R", "크기 조절"],
-	["Frame selection", "F", "선택 프레임"],
-	["Duplicate", `${MOD}D`, "복제"],
-	["Drop to floor", "End", "바닥에 놓기"],
-];
-
-function PreferenceRow({ title, description, children, testid }) {
-	return (
-		<div className="v2-preferences__row" data-testid={testid}>
-			<div className="v2-preferences__row-copy">
-				<span className="v2-preferences__row-title">{title}</span>
-				{description && <span className="v2-preferences__row-description">{description}</span>}
-			</div>
-			<div className="v2-preferences__row-control">{children}</div>
-		</div>
-	);
-}
-
-// A page with one section leaves out its title: the page header already names it.
-function PreferenceSection({ title, children }) {
-	return (
-		<section className="v2-preferences__section">
-			{title && <h2 className="v2-preferences__section-title">{title}</h2>}
-			<div className="v2-preferences__section-rows">{children}</div>
-		</section>
-	);
-}
-
-function ToggleControl({ pressed, onChange, label, testid }) {
-	return (
-		<button
-			type="button"
-			className="v2-preferences__toggle"
-			role="switch"
-			aria-checked={pressed}
-			aria-pressed={pressed}
-			aria-label={label}
-			data-testid={testid}
-			onClick={() => onChange(!pressed)}
-		>
-			<span className="v2-preferences__toggle-thumb" aria-hidden="true" />
-		</button>
-	);
-}
-
-function ReadonlyHotkeys() {
-	return (
-		<div className="v2-preferences__hotkeys" data-testid="preferences-hotkeys">
-			{HOTKEYS.map(([english, key, korean]) => (
-				<div className="v2-preferences__hotkey" key={english}>
-					<span>{ko(english, korean)}</span>
-					<kbd>{key}</kbd>
-				</div>
-			))}
-		</div>
-	);
-}
-
-function ThemeControls() {
-	const [theme, setTheme] = useState(readTheme);
-	const options = [
-		{ id: "dark", label: ko("Dark", "다크") },
-		{ id: "light", label: ko("Light", "라이트") },
-	];
-	return (
-		<div className="v2-preferences__language-controls" role="group" aria-label={ko("Theme", "테마")}>
-			{options.map((option) => (
-				<button
-					type="button"
-					key={option.id}
-					className={"v2-preferences__language" + (theme === option.id ? " is-selected" : "")}
-					data-testid={`settings-theme-${option.id}`}
-					aria-pressed={theme === option.id}
-					onClick={() => setTheme(saveTheme(option.id))}
-				>
-					{option.label}
-				</button>
-			))}
-		</div>
-	);
-}
-
-function preferenceSection(section, props) {
-	const { autoColor, setAutoColor, analyticsOptOut, setAnalyticsOptOutState, gridView, setGridView } = props;
-	const languageControls = (
-		<div className="v2-preferences__language-controls">
-			{LANGUAGES.map((language) => (
-				<button
-					type="button"
-					key={language.id}
-					className={"v2-preferences__language" + (LOCALE === language.id ? " is-selected" : "")}
-					data-testid={`settings-locale-${language.id}`}
-					aria-pressed={LOCALE === language.id}
-					title={language.action}
-					onClick={() => setLocale(language.id)}
-				>
-					{language.label}
-				</button>
-			))}
-		</div>
-	);
-
-	switch (section) {
-		case "Appearance":
-			return (
-				<>
-					<PreferenceSection title={ko("Display", "표시")}>
-						<PreferenceRow title={ko("Language", "언어")} description={ko("Choose the labels used throughout the editor.", "에디터에서 사용할 언어를 선택하세요.")}>
-							{languageControls}
-						</PreferenceRow>
-						<PreferenceRow title={ko("Theme", "테마")} description={ko("Dark keeps the studio dim around the stage; Light uses bright glass panels.", "다크는 무대 주변을 어둡게, 라이트는 밝은 유리 패널을 써요.")}>
-							<ThemeControls />
-						</PreferenceRow>
-					</PreferenceSection>
-					<PreferenceSection title={ko("Editor", "에디터")}>
-						<PreferenceRow title={ko("Auto colour", "자동 색")} description={ko("Give scene objects stable display colours.", "씬 오브젝트에 고정된 표시 색을 사용해요.")}>
-							<ToggleControl pressed={autoColor} onChange={(value) => { setAutoColor(value); saveAutoColor(value); }} label={ko("Auto colour", "자동 색")} testid="preferences-auto-color" />
-						</PreferenceRow>
-						<PreferenceRow title={ko("Anonymous analytics", "익명 사용 통계")} description={ko("Help improve CozyClay with anonymous product events.", "익명 제품 이벤트로 CozyClay 개선을 도와요.")}>
-							<ToggleControl
-								pressed={!analyticsOptOut}
-								onChange={async (value) => setAnalyticsOptOutState(await setAnalyticsOptOut(!value))}
-								label={ko("Anonymous analytics", "익명 사용 통계")}
-								testid="settings-analytics"
-							/>
-						</PreferenceRow>
-					</PreferenceSection>
-				</>
-			);
-		case "Viewport":
-			return (
-				<PreferenceSection>
-					<PreferenceRow title={ko("Reference grid", "기준 그리드")} description={ko("Use a dark reference grid instead of the clay deck.", "클레이 데크 대신 어두운 기준 그리드를 사용해요.")}>
-						<ToggleControl pressed={gridView} onChange={(value) => { setGridView(value); writeStoredGridView(globalThis.localStorage, value); }} label={ko("Reference grid", "기준 그리드")} testid="preferences-grid" />
-					</PreferenceRow>
-				</PreferenceSection>
-			);
-		case "Hotkeys":
-			return (
-				<PreferenceSection>
-					<p className="v2-preferences__section-note">{ko("Shortcuts are read-only here. They stay active whenever focus is outside a text field.", "단축키는 여기서 읽기 전용이에요. 텍스트 입력란 밖에서 항상 사용할 수 있어요.")}</p>
-					<ReadonlyHotkeys />
-				</PreferenceSection>
-			);
-		default:
-			return null;
-	}
-}
-
 export default function PreferencesDialog({ open, onClose, initialSection = "Appearance" }) {
 	const dialogRef = useRef(null);
 	const searchRef = useRef(null);

package/src/shell/StatusBar.jsx

@@ -47,7 +47,7 @@ function ExportStatus({ status, label, recording }) {
 	const detail = [
 		message,
 		retryable && ko("Retry keeps the original shot, camera, range and settings; it does not change your edits.", "다시 시도하면 원래 샷·카메라·범위·설정을 사용하며 편집 내용은 바꾸지 않아요."),
-		handedOff > 0 && ko(`${handedOff} file(s) already handed off. Retry skips those downloads.`, `파일 ${handedOff}개는 이미 전달했어요. 다시 시도할 때 해당 다운로드는 건너뛰어요.`),
+		handedOff > 0 && ko(`${handedOff} file(s) already handed off. Retry skips those files.`, `파일 ${handedOff}개는 이미 전달했어요. 다시 시도할 때 해당 파일은 건너뛰어요.`),
 		busy && stage === "mux" && ko("Finalizing MP4; this stage cannot be interrupted.", "MP4 마무리 중이에요. 이 단계는 중단할 수 없어요."),
 	].filter(Boolean).join(" ");
 	return (

package/src/shell/preference-controls.jsx

@@ -0,0 +1,114 @@
+import { useState } from "react";
+import { ko, LOCALE, setLocale } from "../locale.js";
+import { readTheme, saveTheme } from "../theme.js";
+
+const MOD = typeof navigator !== "undefined" && /Mac|iPhone|iPad/.test(navigator.platform ?? "") ? "⌘" : "Ctrl ";
+
+const HOTKEYS = [
+	["Move", "W", "이동"],
+	["Rotate", "E", "회전"],
+	["Scale", "R", "크기 조절"],
+	["Frame selection", "F", "선택 프레임"],
+	["Duplicate", `${MOD}D`, "복제"],
+	["Drop to floor", "End", "바닥에 놓기"],
+];
+
+export function PreferenceRow({ title, description, children, testid, full = false }) {
+	return (
+		<div className={"v2-preferences__row" + (full ? " v2-preferences__row--full" : "")} data-testid={testid}>
+			<div className="v2-preferences__row-copy">
+				<span className="v2-preferences__row-title">{title}</span>
+				{description && <span className="v2-preferences__row-description">{description}</span>}
+			</div>
+			<div className="v2-preferences__row-control">{children}</div>
+		</div>
+	);
+}
+
+// A page with one section leaves out its title: the page header already names it.
+export function PreferenceSection({ title, children }) {
+	return (
+		<section className="v2-preferences__section">
+			{title && <h2 className="v2-preferences__section-title">{title}</h2>}
+			<div className="v2-preferences__section-rows">{children}</div>
+		</section>
+	);
+}
+
+export function ToggleControl({ pressed, onChange, label, testid }) {
+	return (
+		<button
+			type="button"
+			className="v2-preferences__toggle"
+			role="switch"
+			aria-checked={pressed}
+			aria-pressed={pressed}
+			aria-label={label}
+			data-testid={testid}
+			onClick={() => onChange(!pressed)}
+		>
+			<span className="v2-preferences__toggle-thumb" aria-hidden="true" />
+		</button>
+	);
+}
+
+export function ThemeControls() {
+	const [theme, setTheme] = useState(readTheme);
+	const options = [
+		{ id: "dark", label: ko("Dark", "다크") },
+		{ id: "light", label: ko("Light", "라이트") },
+	];
+	return (
+		<div className="v2-preferences__language-controls" role="group" aria-label={ko("Theme", "테마")}>
+			{options.map((option) => (
+				<button
+					type="button"
+					key={option.id}
+					className={"v2-preferences__language" + (theme === option.id ? " is-selected" : "")}
+					data-testid={`settings-theme-${option.id}`}
+					aria-pressed={theme === option.id}
+					onClick={() => setTheme(saveTheme(option.id))}
+				>
+					{option.label}
+				</button>
+			))}
+		</div>
+	);
+}
+
+export function LanguageControls() {
+	const options = [
+		{ id: "en", label: "English", action: "Switch to English" },
+		{ id: "ko", label: "한국어", action: "한국어로 전환" },
+	];
+	return (
+		<div className="v2-preferences__language-controls">
+			{options.map((language) => (
+				<button
+					type="button"
+					key={language.id}
+					className={"v2-preferences__language" + (LOCALE === language.id ? " is-selected" : "")}
+					data-testid={`settings-locale-${language.id}`}
+					aria-pressed={LOCALE === language.id}
+					title={language.action}
+					onClick={() => setLocale(language.id)}
+				>
+					{language.label}
+				</button>
+			))}
+		</div>
+	);
+}
+
+export function ReadonlyHotkeys() {
+	return (
+		<div className="v2-preferences__hotkeys" data-testid="preferences-hotkeys">
+			{HOTKEYS.map(([english, key, korean]) => (
+				<div className="v2-preferences__hotkey" key={english}>
+					<span>{ko(english, korean)}</span>
+					<kbd>{key}</kbd>
+				</div>
+			))}
+		</div>
+	);
+}

package/src/shell/preference-pages.jsx

@@ -0,0 +1,72 @@
+import { getAnalyticsOptOut, setAnalyticsOptOut } from "../analytics.js";
+import { loadAutoColor, saveAutoColor } from "../auto-color.js";
+import { readStoredGridView, writeStoredGridView } from "../grid-view.js";
+import { ko } from "../locale.js";
+import ExportFolderPreference from "./ExportFolderPreference.jsx";
+import {
+	LanguageControls,
+	PreferenceRow,
+	PreferenceSection,
+	ReadonlyHotkeys,
+	ThemeControls,
+	ToggleControl,
+} from "./preference-controls.jsx";
+
+export function preferenceSection(section, props) {
+	const { autoColor, setAutoColor, analyticsOptOut, setAnalyticsOptOutState, gridView, setGridView } = props;
+
+	switch (section) {
+		case "Appearance":
+			return (
+				<>
+					<PreferenceSection title={ko("Display", "표시")}>
+						<PreferenceRow title={ko("Language", "언어")} description={ko("Choose the labels used throughout the editor.", "에디터에서 사용할 언어를 선택하세요.")}>
+							<LanguageControls />
+						</PreferenceRow>
+						<PreferenceRow title={ko("Theme", "테마")} description={ko("Dark keeps the studio dim around the stage; Light uses bright glass panels.", "다크는 무대 주변을 어둡게, 라이트는 밝은 유리 패널을 써요.")}>
+							<ThemeControls />
+						</PreferenceRow>
+					</PreferenceSection>
+					<PreferenceSection title={ko("Editor", "에디터")}>
+						<PreferenceRow title={ko("Auto colour", "자동 색")} description={ko("Give scene objects stable display colours.", "씬 오브젝트에 고정된 표시 색을 사용해요.")}>
+							<ToggleControl pressed={autoColor} onChange={(value) => { setAutoColor(value); saveAutoColor(value); }} label={ko("Auto colour", "자동 색")} testid="preferences-auto-color" />
+						</PreferenceRow>
+						<PreferenceRow title={ko("Anonymous analytics", "익명 사용 통계")} description={ko("Help improve CozyClay with anonymous product events.", "익명 제품 이벤트로 CozyClay 개선을 도와요.")}>
+							<ToggleControl
+								pressed={!analyticsOptOut}
+								onChange={async (value) => setAnalyticsOptOutState(await setAnalyticsOptOut(!value))}
+								label={ko("Anonymous analytics", "익명 사용 통계")}
+								testid="settings-analytics"
+							/>
+						</PreferenceRow>
+					</PreferenceSection>
+				</>
+			);
+		case "Viewport":
+			return (
+				<PreferenceSection>
+					<PreferenceRow title={ko("Reference grid", "기준 그리드")} description={ko("Use a dark reference grid instead of the clay deck.", "클레이 데크 대신 어두운 기준 그리드를 사용해요.")}>
+						<ToggleControl pressed={gridView} onChange={(value) => { setGridView(value); writeStoredGridView(globalThis.localStorage, value); }} label={ko("Reference grid", "기준 그리드")} testid="preferences-grid" />
+					</PreferenceRow>
+				</PreferenceSection>
+			);
+		case "Export":
+			return (
+				<PreferenceSection>
+					<ExportFolderPreference />
+				</PreferenceSection>
+			);
+		case "Hotkeys":
+			return (
+				<PreferenceSection>
+					<p className="v2-preferences__section-note">{ko("Shortcuts are read-only here. They stay active whenever focus is outside a text field.", "단축키는 여기서 읽기 전용이에요. 텍스트 입력란 밖에서 항상 사용할 수 있어요.")}</p>
+					<ReadonlyHotkeys />
+				</PreferenceSection>
+			);
+		default:
+			return null;
+	}
+}
+
+// Kept here so the dialog can load a new setting's initial value lazily.
+export { getAnalyticsOptOut, loadAutoColor, readStoredGridView };

package/src/shell/preferences.css

@@ -623,3 +623,49 @@
 		grid-template-columns: 1fr;
 	}
 }
+
+/* Export folder: full-width row because folder names and three controls do not
+   fit the 240px control column used by toggles and language pairs. */
+.v2-preferences .v2-preferences__row--full .v2-preferences__row-copy {
+	margin-bottom: var(--sp-2, 12px);
+}
+
+.v2-preferences .v2-preferences__row--full .v2-preferences__row-control {
+	justify-content: flex-start;
+	flex-wrap: wrap;
+	width: 100%;
+}
+
+.v2-preferences .v2-preferences__export-folder {
+	display: flex;
+	flex-direction: column;
+	align-items: flex-start;
+	gap: var(--sp-1, 8px);
+	min-width: 0;
+	width: 100%;
+}
+
+.v2-preferences .v2-preferences__export-folder .v2-preferences__language-controls {
+	justify-content: flex-start;
+}
+
+.v2-preferences .v2-preferences__export-folder-name {
+	color: var(--text-1, #e4e4e7);
+	font-size: var(--prefs-ui-size, 12px);
+	line-height: 1.35;
+	overflow-wrap: anywhere;
+}
+
+.v2-preferences .v2-preferences__export-folder-status {
+	color: var(--select, #e8a33d);
+	font-size: var(--prefs-secondary-size, 11px);
+	line-height: 1.35;
+}
+
+.v2-preferences .v2-preferences__export-folder-note {
+	display: block;
+	margin-top: var(--sp-1, 8px);
+	color: var(--text-3, #636369);
+	font-size: var(--prefs-secondary-size, 11px);
+	line-height: 1.35;
+}

package/src/shot-prompt.js

@@ -1,20 +1,40 @@
 // Builds the labelled text prompt sent alongside a reference clip when a shot
-// goes to an image or video model. Pure string building: no DOM, no imports.
+// goes to an image or video model. Pure string building: no DOM; the only
+// import is the editor's own lens math, so the prompt and the viewport share
+// one focal <-> fov calibration.
+import { fovToFocalMm, shotAspectRatio } from "./shot.js";
 
 const CAMERA_FOLLOWS_REFERENCE = "follow the reference clip's framing and camera motion exactly";
 const NEUTRAL_LOOK = "clay previs, neutral look";
 const MOTION_LINE = "motion and blocking come from the reference; keep timing";
 
-// FOV degrees -> 35mm-equivalent focal length -> shot-size word.
-// A wide field of view reads as a wide shot; a narrow one as a long shot.
-export function shotSizeFromFov(fovDeg) {
-	if (!Number.isFinite(fovDeg) || fovDeg <= 0) return "normal";
-	const equivalentFocalMm = 18 / Math.tan((fovDeg * Math.PI) / 360);
-	if (equivalentFocalMm <= 20) return "wide";
-	if (equivalentFocalMm <= 40) return "normal";
+// Focal length (on the editor's filmback) -> lens word, in crew terms:
+// under 35 mm reads wide, 35-50 mm normal, longer than 50 mm long.
+export function lensWordFromFocalMm(focalMm) {
+	if (!Number.isFinite(focalMm) || focalMm <= 0) return "normal";
+	if (focalMm < 35) return "wide";
+	if (focalMm <= 50) return "normal";
 	return "long";
 }
 
+// FOV degrees -> focal length through the editor's own calibration
+// (shot.js fovToFocalMm on the given filmback) -> lens word. No second,
+// independently calibrated conversion: the word matches the lens the editor
+// reports for that field of view.
+export function shotSizeFromFov(fovDeg, filmback = {}) {
+	if (!Number.isFinite(fovDeg) || fovDeg <= 0) return "normal";
+	const focalMm = fovToFocalMm((fovDeg * Math.PI) / 180, filmback.sensorId, filmback.aspectRatio);
+	// Round to 0.1 mm so a lens that round-trips through fov keeps its word.
+	return lensWordFromFocalMm(Math.round(focalMm * 10) / 10);
+}
+
+// The editor already reports the focal length it framed with; only a meta
+// without one falls back to converting its fov on the meta's filmback.
+function lensWord(meta) {
+	if (Number.isFinite(meta.focalMm) && meta.focalMm > 0) return lensWordFromFocalMm(meta.focalMm);
+	return shotSizeFromFov(meta.fovDeg, { sensorId: meta.sensorId, aspectRatio: shotAspectRatio(meta.aspect) });
+}
+
 function secondsText(seconds) {
 	return `${Number(seconds.toFixed(2))}s`;
 }
@@ -68,7 +88,7 @@ export function buildShotPrompt(meta, options = {}) {
 
 	const lines = [
 		`SHOT: ${meta.shotTitle || "untitled shot"}, ${secondsText(seconds)}, ${meta.aspect || ""}`.trimEnd(),
-		`LENS: ${meta.focalMm}mm, ${shotSizeFromFov(meta.fovDeg)} shot`,
+		`LENS: ${meta.focalMm}mm, ${lensWord(meta)} shot`,
 		referenceOwnsCamera ? `CAMERA: ${CAMERA_FOLLOWS_REFERENCE}` : `CAMERA: ${cameraWords(meta.cameraMove)}`,
 		`LIGHT: ${lightWords(meta.keyLight)}`,
 		`CAST: ${(meta.cast || []).map((member) => member.name).join(", ") || "none"}`,

package/src/studio-actions.js

@@ -130,7 +130,7 @@ export const STUDIO_ACTIONS = freezeStudioData([
 	{ id: "view.setGhosts", label: "Ghosts", kind: "transient", input: input({ mode: { type: "string", enum: ["off", "step", "keys"] } }, { count: { type: "integer", minimum: 1, maximum: 6 }, step: { type: "integer", minimum: 1, maximum: 24 } }),
 		description: "Onion skin in the editor viewport, like the View menu's Ghosts: translucent poses of the active character's installed take, count (1-6, default 3) before the playhead in blue and as many after it in orange, fading with distance in time; props the take carries (a kit's bat) ghost with the body. mode step spaces them every step frames (1-24, default 4), keys puts them on the spec's key frames, off hides them; e.g. { mode: \"step\", count: 3, step: 4 }. An editor overlay: never in capture_frame, exports or contact sheets (verify_result ghosts: true draws them on a views sheet). A viewer setting: never saved or undone." },
 	{ id: "export.shotVideo", exposure: "confirm", confirmationReason: "Exporting writes a video file outside the Studio.", label: "Export video (mp4)", kind: "job", timeoutMs: 300_000, input: input({}, { ...shotId, scope: { type: "string", enum: ["timeline", "shot"], description: "timeline: the whole timeline, every shot back to back; shot: one shot (shotId, or the one under the playhead)." } }),
-		description: "Record a shot to an MP4 (camera move and character motion, no editor chrome), like the Export menu's Video (mp4), and ask the browser to download it. With shotId it records that shot's own range; without it, what the menu records: the whole take when there is motion, else the shot under the playhead (else the first shot), keyed from the current camera if it has no keys. Waits until the file is encoded (up to 5 minutes) and answers status \"completed\" with output.fileName and output.frameCount. One export at a time; not a motion generation." },
+		description: "Record a shot to an MP4 (camera move and character motion, no editor chrome), like the Export menu's Video (mp4), and hand it to the configured export folder or, when none is usable, the browser download. With shotId it records that shot's own range; without it, what the menu records: the whole take when there is motion, else the shot under the playhead (else the first shot), keyed from the current camera if it has no keys. Waits until the file is encoded (up to 5 minutes) and answers status \"completed\" with output.fileName and output.frameCount. One export at a time; not a motion generation." },
 	{ id: "scene.create", label: "New scene", kind: "document", input: input(),
 		description: `Add an empty scene (named SCENE 01, SCENE 02, ...) after the others and open it, like the scene menu's New scene. ${SCENE_MOVES} ${NOT_UNDOABLE}` },
 	{ id: "scene.duplicate", label: "Duplicate scene", kind: "document", input: input(sceneId),
@@ -152,7 +152,7 @@ export const STUDIO_ACTIONS = freezeStudioData([
 	{ id: "object.duplicate", label: "Duplicate object", kind: "mutation", undoDomain: "objects", input: input({}, { objectId: idSchema }),
 		description: "Copy a scene object (the selected one when objectId is omitted) and place the copy half a metre beside it." },
 	{ id: "ai.prepareShot", label: "Send to AI", kind: "job", input: input({}, { mode: { type: "string", enum: ["image", "video"] }, model: { type: "string", enum: AI_IMAGE_MODELS } }),
-		description: "Prepare the Studio's Send-to-AI package for the shot under the playhead (else the current camera): the prompt for an external image or video model, written from the shot's camera, cast, poses, environment and style, plus reference frames rendered from the shot camera (its first and last camera key when it has keys). No AI service is called. mode \"image\" is a still, \"video\" a shot with its camera move; model is the image model the prompt is written for (image mode only). Each omitted choice keeps the Studio's current one; a given one becomes it. The Studio opens its result panel, where the user copies the prompt and downloads the frames; the frame images stay there and are not in the answer. Answers status \"completed\" with output.prompt, mode, modelLabel, shot (id, name, range), aspectRatio, cameraMode and referenceFrames (how many frames the panel shows). Changes nothing in the scene; not a motion generation." },
+		description: "Prepare the Studio's Send-to-AI package for the shot under the playhead (else the current camera): the prompt for an external image or video model, written from the shot's camera, cast, poses, environment and style, plus reference frames rendered from the shot camera (its first and last camera key when it has keys). No AI service is called. mode \"image\" is a still, \"video\" a shot with its camera move; model is the image model the prompt is written for (image mode only). Each omitted choice keeps the Studio's current one; a given one becomes it. The Studio opens its result panel, where the user copies the prompt and exports the frames to the configured export folder or browser downloads; the frame images stay there and are not in the answer. Answers status \"completed\" with output.prompt, mode, modelLabel, shot (id, name, range), aspectRatio, cameraMode and referenceFrames (how many frames the panel shows). Changes nothing in the scene; not a motion generation." },
 	// The instruction leads the H3 prompt, which the motion API caps at 4000
 	// characters with its camera-lock text (about 225) appended.
 ]);

package/src/studio-agent-motion.js

@@ -12,7 +12,8 @@ import { buildCollisionCapsules, detectPenetrations, supportsCollisionCleanup }
 import { collisionBlockers, blockerSummary } from './motion/collision-blockers.js';
 import { createGroundSampler } from './motion/ground.js';
 import { OBJECT_LIBRARY } from './scene-objects.js';
-import { objectTransformAt } from './object-path.js';
+import { sceneObjectsAt } from './object-travel.js';
+import { objectTracksOf } from './motion3/object-tracks.js';
 import { sampleAt } from './sample-at.js';
 import { isProxyFigure } from './scenes.js';
 
@@ -88,7 +89,7 @@ function stageCast(env, characterId, cast) {
 
 /* One take under evaluation, `t`: {evaluator, motion, env, cast, characterId,
  * character, protectedFrames, range, poseCast?, yieldTask, checkpoint}. */
-function blockersAt(t, frame) {
+function blockersAt(t, frame, objects) {
   t.checkpoint();
   const rigs = {};
   for (const member of t.cast) {
@@ -99,18 +100,19 @@ function blockersAt(t, frame) {
     rigs[member.character.id] = member.evaluator.rig;
   }
   const cast = t.cast.map((member) => member.character).filter(Boolean);
-  return collisionBlockers({ rigs, activeId: t.characterId, characterIds: cast, sceneObjects: t.env.objects, library: OBJECT_LIBRARY, frame, take: { frameCount: t.env.frameCount, fps: 24 } });
+  // `objects` already stand where this frame renders them (routes and take tracks), so no re-sampling here.
+  return collisionBlockers({ rigs, activeId: t.characterId, characterIds: cast, sceneObjects: objects, library: OBJECT_LIBRARY });
 }
 async function samples(t, layer) {
   const rows = [], poses = [], collisions = [], blockers = [];
   const cast = t.cast.map((member) => member.character).filter(Boolean);
   for (let frame = t.range.startFrame; frame < t.range.endFrameExclusive; frame++) {
     t.checkpoint(); poseFrame(t.evaluator, t.motion, layer, frame);
-    const shapes = blockersAt(t, frame);
-    const objects = t.env.objects.map(object => {
-      const at = objectTransformAt(object, frame, { frameCount: t.env.frameCount, fps: 24 });
-      return at ? { ...object, x: at.x, y: at.y, z: at.z, rot: at.rot ?? object.rot } : object;
-    });
+    // Objects as the editor renders them at this frame: travel routes plus the
+    // object tracks the installed takes bake (object-travel.js sceneObjectsAt).
+    const objects = sceneObjectsAt(t.env.objects, frame, t.objectTake);
+    for (const o of objects) if (!o.hidden && (o.rotX || o.rotZ)) t.tilted.add(o.id);
+    const shapes = blockersAt(t, frame, objects);
     rows.push(readSample(t.evaluator, createGroundSampler(objects, { floorY: t.env.floor.y, characters: cast })));
     poses.push(poseValues(t.evaluator.rest));
     const capsules = buildCollisionCapsules(t.evaluator.rig);
@@ -136,7 +138,7 @@ function judge(t, before, after) {
   }
   const supportedCollisionFrames = after.collisions.filter(p => p.length).length;
   const elevatedFrames = after.rows.flatMap((row, f) => Object.values(row.ground).some(y => y !== t.env.floor.y) ? [t.range.startFrame + f] : []);
-  const unsupportedObjects = t.env.objects.filter(o => o.attach || o.rotX || o.rotZ);
+  const unsupportedObjects = t.env.objects.filter(o => o.attach || o.rotX || o.rotZ || t.tilted.has(o.id));
   const missingCast = t.cast.filter(m => !m.evaluator || ((m.character.layer?.waypoints?.length ?? 0) > 0 && !t.poseCast));
   const measuredSupportFrames = after.support.frames.filter(f => f.measured).length;
   const flat = t.env.floor.model === 'flat' && elevatedFrames.length === 0 && Math.abs(t.character.y ?? 0) < 1e-8;
@@ -164,6 +166,13 @@ function receiptVerification(v) {
     limitations: v.limitations, surfaceMeasured: m.surfaceMeasured, maxFloorPenetrationM: m.maxFloorPenetrationM, maxContactSlipM: m.maxContactSlipM, maxContactFloatM: m.maxContactFloatM,
     unsupportedFrames: m.unsupportedFrames, supportedCollisionFrames: m.supportedCollisionFrames, continuityRegressed: m.continuityRegressed, semanticStatus: 'unavailable' };
 }
+/** Object tracks the installed takes bake (this take and the other cast's), keyed by object id. */
+function installedObjectTracks(target, environment) {
+  const takes = new Map((environment.cast ?? []).map(member => [member.character?.id, member.motion]));
+  takes.set(target.character.id, target.motion);
+  const characters = [...takes.keys()].filter(id => typeof id === 'string').map(id => ({ id }));
+  return objectTracksOf({ motionFor: id => takes.get(id) }, characters);
+}
 /** Motion verification of an installed take, on a private rig clone over
  * `range` (default and upper bound: the whole take). target: {character, rig,
  * motion, ikState?, protectedFrames?}; environment has readEnvironment()'s
@@ -177,6 +186,7 @@ export async function verifyInstalledTake({ target, environment, range, poseCast
   const deadline = now() + verificationBudget(endFrameExclusive - startFrame, verificationMs);
   const t = { evaluator: isolatedRig(target.rig), motion, env, cast: [], characterId: target.character.id, character: target.character,
     protectedFrames: target.protectedFrames ?? [], range: { startFrame, endFrameExclusive }, poseCast, yieldTask,
+    objectTake: { frameCount: env.frameCount, fps: 24, objectTracks: installedObjectTracks(target, environment) }, tilted: new Set(),
     checkpoint: () => { if (now() > deadline) fail('VERIFICATION_FAILED', 'Private verification budget exceeded.'); } };
   try {
     stageCast(environment, t.characterId, t.cast);

package/src/studio-agent-protocol.js

@@ -307,7 +307,7 @@ const receiptSchema = union(...Object.values(receiptVariants));
 const failureSchema = object({ ok: literal(false), commandId: id, host: identity, code: choices(STUDIO_ERROR_CODES), phase: choices(["admission", "execution", "prepare", "verify", "repair", "commit", "reconcile", "undo"]),
 	affectedIds: ids(100, 0), expectedTargets: array(guardSchema, 24), currentTargets: array(guardSchema, 24), mutated: union(bool, literal("unknown")),
 	preserved: object({ authoredState: choices(["unchanged", "changed", "unknown"]) }), recovery: object({ action: choices(["none", "inspect", "retry", "new_intent", "reconcile", "sign_in"]) }, { retryAllowed: bool }),
-}, { message: text(500), jobId: id, txId: id, candidates: array(object({ id, kind: choices(["object", "character", "rig"]), position: nullable(vec3) }), 5) });
+}, { message: text(2000), jobId: id, txId: id, candidates: array(object({ id, kind: choices(["object", "character", "rig"]), position: nullable(vec3) }), 5) });
 
 // These are JSON Schema data, not validators with hidden browser dependencies.
 // x-studio-range is the sole relational schema annotation: end > start.

package/src/studio-app-binding.js

@@ -196,9 +196,10 @@ export function createStudioAppBinding(ports) {
 				...(childIds.length ? { childIds: childIds.slice(0, 12), ...(childIds.length > 12 ? { childCount: childIds.length } : {}) } : {}) };
 		};
 		if (patched.length) return { patched, ...extras() };
-		const shot = s.shots.find(row => row.id === id);
+		// A camera key lives inside its shot: still present there means retained, not removed (#863).
+		const shot = s.shots.find(row => row.id === id), key = !shot && !entity && s.shots.flatMap(row => row.cameraKeys?.map(k => ({ shotId: row.id, frame: k.frame, id: k.id })) ?? []).find(k => k.id === id);
 		if (shot) return { name: shot.name || shot.id, range: { startFrame: shot.startFrame, endFrameExclusive: shot.endFrame + 1 } };
-		if (!entity) return { removed: true };
+		if (!entity) return key ? { shotId: key.shotId, frame: key.frame } : { removed: true };
 		const brief = { name: entity.name || entity.subject || entity.id, position: { x: entity.x, y: entity.y ?? 0, z: entity.z } };
 		if (compact) return brief;
 		if (!object) return { ...brief, yawDeg: entity.rot ?? 0, scale: entity.scale ?? 1, ...extras() };

package/src/workflow/AgentPanel.jsx

@@ -3,7 +3,7 @@ import { FiAlertTriangle, FiArrowUp, FiCamera, FiCheck, FiChevronRight, FiClock,
 import { ATTACHMENT_ACCEPT, ATTACHMENT_FAILED_NOTICE, ATTACHMENT_LIMIT_NOTICE, ATTACHMENT_TYPE_NOTICE, attachmentFilesFromTransfer, attachmentFromFile, transferCarriesFiles } from "./attachment-image.js";
 import { isImeComposing } from "../ime.js";
 import { useStudioShell } from "../shell/studio-shell-context.js";
-import { ko } from "../locale.js";
+import { ko } from "../locale.js"; import { saveExport } from "../export-workspace.js";
 import {
 	AGENT_PANEL_OVERLAY_BREAKPOINT,
 	AGENT_PANEL_RAIL_WIDTH,
@@ -73,7 +73,7 @@ function ImageResultCard({ image, onUse, onUndo, onRegenerate, onOpen }) {
 			? <div className="agent-placed"><StatusDot tone="ok" />Placed<button type="button" className="agent-image-undo" disabled={applying} onClick={() => onUndo(image)}>{applying ? "Removing…" : "Undo"}</button></div>
 			: <div className="agent-image-actions">
 				<button type="button" className="primary agent-image-use" disabled={applying} onClick={() => onUse(image)}><FiImage size={11} /> {applying ? "Applying…" : "Use in scene"}</button>
-				<a className="agent-image-download" role="button" href={image.dataUrl} download={`${image.imageId || "agent-image"}.png`}><FiDownload size={11} /> Download</a>
+				<a className="agent-image-download" role="button" href={image.dataUrl} download={`${image.imageId || "agent-image"}.png`} onClick={(event) => { event.preventDefault(); void saveExport(image.dataUrl, `${image.imageId || "agent-image"}.png`); }}><FiDownload size={11} /> Download</a>
 				<button type="button" className="agent-image-regenerate" onClick={() => onRegenerate(image)}><FiRotateCw size={11} /> Regenerate</button>
 			</div>}
 		{/* The card states what the editor actually did: an unacknowledged or