cozyclay 2.1.1 → 3.0.1

package/src/object-travel.js

@@ -66,8 +66,67 @@ export function travelPose(object, at) {
 	};
 }
 
-/** The record's own route sample as a matrix, or null when it does not travel. */
+const trackFrame = (track, frame) => Math.max(0, Math.min(track.frameCount - 1, Math.round(frame) || 0));
+
+// A compiled take's per-frame pose for the record (a hinged door), as a matrix, or null. A
+// switch track (vis/lvl only, no pos/quat: C15) is no motion of its own, so a parent's carry still applies.
+function trackMatrix(object, frame, take, out) {
+	const track = take?.objectTracks?.get?.(object.id);
+	if (!track?.pos) return null;
+	const f = trackFrame(track, frame);
+	scratchPos.set(track.pos[f * 3], track.pos[f * 3 + 1], track.pos[f * 3 + 2]);
+	scratchQuat.set(track.quat[f * 4], track.quat[f * 4 + 1], track.quat[f * 4 + 2], track.quat[f * 4 + 3]);
+	scratchScale.set(object.scaleX ?? 1, object.scaleY ?? 1, object.scaleZ ?? 1);
+	return out.compose(scratchPos, scratchQuat, scratchScale);
+}
+
+// The record's own vis track at `frame`: true or false, null when the take has none for it.
+const visAt = (id, frame, take) => {
+	const track = take?.objectTracks?.get?.(id);
+	return track?.vis ? track.vis[trackFrame(track, frame)] === 1 : null;
+};
+
+// False while a compiled take carries the record out of sight (a cigarette still in the pocket),
+// or hides a record it is grouped under: with `objects` (the authored records, a Map by id or the
+// list) every ancestor's vis track counts too, so a group's visible channel hides its parts.
+// A record marked showOnlyInTake (a kit's flame, ember, tip smoke, exhale puff or muzzle flash, and
+// their lights) is hidden unless a vis track drives it: its own or, with `objects`, a group's above it
+// (the exhale kit's root shows its puff). A static scene never draws it.
+export function trackShown(id, frame, take, objects = null) {
+	const lookup = objects && asLookup(objects), own = visAt(id, frame, take);
+	if (own === false) return false;
+	let driven = own === true;
+	if (lookup && take?.objectTracks?.size) {
+		const seen = new Set([id]);
+		for (let parent = lookup.get(id)?.parent; typeof parent === "string" && !seen.has(parent); parent = lookup.get(parent)?.parent) {
+			seen.add(parent);
+			const shown = visAt(parent, frame, take);
+			if (shown === false || (shown === null && lookup.get(parent)?.showOnlyInTake === true)) return false;
+			driven ||= shown === true;
+		}
+	}
+	return driven || lookup?.get(id)?.showOnlyInTake !== true;
+}
+
+// The take's level of the record at `frame` (its lvl track: 0 dark, 1 as authored, up to 4; C15), else 1.
+export function trackLevel(id, frame, take) {
+	const track = take?.objectTracks?.get?.(id), value = track?.lvl ? Number(track.lvl[trackFrame(track, frame)]) : 1;
+	return Number.isFinite(value) ? Math.min(4, Math.max(0, value)) : 1;
+}
+
+/**
+ * True while a compiled take holds the record in a hand (a grabbed cup): its track is in world
+ * space then, so the carry from its own parents (the table it stood on) is cut, like `attach`.
+ */
+function held(id, frame, take) {
+	const track = take?.objectTracks?.get?.(id);
+	return !!track?.hold && track.hold[trackFrame(track, frame)] === 1;
+}
+
+/** The record's own route sample (or compiled track) as a matrix, or null when it does not travel. */
 function ownTravelMatrix(object, frame, take, out) {
+	const tracked = trackMatrix(object, frame, take, out);
+	if (tracked) return tracked;
 	if (!object.path) return null;
 	const at = objectTransformAt(object, frame, take);
 	if (!at) return null;
@@ -129,11 +188,13 @@ export function sceneObjectTravelMatrixAt(objects, id, frame, take = {}, out = n
 	for (let index = chain.length - 1; index >= 0; index -= 1) {
 		const ancestor = chain[index];
 		if (!ownTravelMatrix(ancestor, frame, take, scratchOwn)) continue;
+		if (held(ancestor.id, frame, take)) scratchMotion.identity();
 		scratchMotion.multiply(scratchOwn).multiply(authoredMatrix(ancestor, scratchAuthored).invert());
 		moved = true;
 	}
 	const own = ownTravelMatrix(object, frame, take, scratchOwn);
 	if (!moved && !own) return null;
+	if (own && held(object.id, frame, take)) return out.copy(own);
 	return out.multiplyMatrices(scratchMotion, own ?? authoredMatrix(object, scratchAuthored));
 }
 
@@ -177,11 +238,12 @@ const wrapDegrees = (value) => {
 
 /**
  * The records as they stand at `frame`: x/y/z and rotation replaced for every
- * record that travels on its own route or under a routed ancestor. Untouched
+ * record that travels on its own route or compiled track, or under an ancestor
+ * that does. Untouched
  * records are returned as-is, and so is the list when nothing moves.
  */
 export function sceneObjectsAt(objects, frame, take = {}) {
-	if (!objects.some((object) => object.path)) return objects;
+	if (!objects.some((object) => object.path || object.showOnlyInTake || take?.objectTracks?.has?.(object.id))) return objects;
 	const lookup = asLookup(objects);
 	const matrix = new Matrix4();
 	const position = new Vector3();
@@ -205,8 +267,11 @@ export function sceneObjectsAt(objects, frame, take = {}) {
 		}
 		return next;
 	};
-	return objects.map((object) => {
-		if (object.attach || (!ancestorsOf(lookup, object).some((ancestor) => ancestor.path) && !ridden(lookup, object))) {
+	return objects.map((object) => { const record = placedAt(object); return trackShown(record.id, frame, take, lookup) ? record : { ...record, hidden: true }; });
+	function placedAt(object) {
+		// A compiled track (a hinged door, a carried cup) on the record or above it places it too; a switch track moves nothing.
+		const tracked = (record) => !!take?.objectTracks?.get?.(record.id)?.pos;
+		if (object.attach || (!tracked(object) && !ancestorsOf(lookup, object).some((ancestor) => ancestor.path || tracked(ancestor)) && !ridden(lookup, object))) {
 			// Nothing above it travels (and nothing below carries it): the route
 			// sample alone, exactly as before the hierarchy carry — for a carried
 			// prop, in the frame its numbers already live in.
@@ -220,5 +285,5 @@ export function sceneObjectsAt(objects, frame, take = {}) {
 		}
 		if (!sceneObjectTravelMatrixAt(lookup, object.id, frame, take, matrix)) return object;
 		return recordAt(object, matrix);
-	});
+	}
 }

package/src/panels/CameraPanel.jsx

@@ -9,9 +9,9 @@ export default function CameraPanel({ isCameraSelection, shot, moveSequence, cam
 	return (
 <Foldout hidden={!isCameraSelection} title={ko("Camera", "카메라")}>
 						<div className="readout v2-details-readout">
-						<span title={ko("camera to subject", "카메라와 피사체 거리")}>{shot.distance.toFixed(2)} m</span>
-						<span title={ko("nearest prime on the cropped filmback", "크롭된 필름백 기준 가장 가까운 단렌즈")}>{shot.focalMm} mm</span>
-						<span title={ko("angle relative to the subject's eyes", "피사체 눈높이 기준 각도")}>{shot.elevationDeg.toFixed(0)}°</span>
+						<span title={ko("camera to subject", "카메라와 피사체 거리")}><small>{ko("Distance", "거리")}</small> {shot.distance.toFixed(2)} m</span>
+						<span title={ko("nearest prime on the cropped filmback", "크롭된 필름백 기준 가장 가까운 단렌즈")}><small>{ko("Lens", "렌즈")}</small> {shot.focalMm} mm</span>
+						<span title={ko("angle relative to the subject's eyes", "피사체 눈높이 기준 각도")}><small>{ko("Angle", "각도")}</small> {shot.elevationDeg.toFixed(0)}°</span>
 						</div>
 						<h3 className="move-head v2-details-subsection-title">{ko("Move keys", "움직임 키")}</h3>
 						{moveSequence ? (
@@ -19,11 +19,11 @@ export default function CameraPanel({ isCameraSelection, shot, moveSequence, cam
 								{moveSequence.displaySlate} · {moveSequence.spanS}{ko("s", "초")}
 							</div>
 						) : (
-							<div className="move-slate v2-details-value-box">
+							<p className="inspector-hint v2-details-hint">
 								{cameraKeys.length === 1
-									? (isKo ? `프레임 ${cameraKeys[0].frame}부터 고정 샷 — 샷 블록 아래 빈 줄을 클릭해 움직임을 추가하세요` : `locked-off hold from frame ${cameraKeys[0].frame} — click the empty lower strip in a Shot block to add a move`)
-									: ko("click a Shot block's lower strip to key the current framing at that frame", "샷 블록 아래 빈 줄을 클릭하면 해당 프레임에 현재 프레이밍을 저장합니다")}
-							</div>
+									? (isKo ? `프레임 ${cameraKeys[0].frame}부터 고정 샷이에요. 샷 블록 아래 빈 줄을 클릭해 움직임을 추가하세요.` : `Locked-off hold from frame ${cameraKeys[0].frame}. Click the empty lower strip of a Shot block to add a move.`)
+									: ko("Click a Shot block's lower strip to key the current framing at that frame.", "샷 블록 아래 빈 줄을 클릭하면 해당 프레임에 현재 프레이밍을 저장합니다.")}
+							</p>
 						)}
 
 						<h3 className="move-head v2-details-subsection-title">{ko("Follow cam", "팔로우 카메라")}</h3>

package/src/panels/HdrEnvironmentControls.jsx

@@ -0,0 +1,59 @@
+import { useEffect, useRef, useState, useSyncExternalStore } from "react";
+import { ko } from "../locale.js";
+import { Dropdown, Field, Slider } from "../ui.jsx";
+import { HDR_BUILTINS } from "../stage-hdr.js";
+import { hdrEnvironmentCatalogue, importHdrFile, refreshHdrLibrary, subscribeHdrLibrary } from "../stage-hdr-library.js";
+
+const KO_NAMES = Object.fromEntries(HDR_BUILTINS.map(({ id, ko: name }) => [id, name]));
+
+/**
+ * The Light panel's HDR environment: load a .hdr / .exr / equirectangular
+ * picture, pick a loaded or built-in map, turn and scale it, show it as the
+ * backdrop or not, remove it. Picking, loading and removing are one undo step
+ * each; the sliders ride the panel's gesture transaction (`setLighting`).
+ */
+export default function HdrEnvironmentControls({ lighting, run, setLighting }) {
+	const environments = useSyncExternalStore(subscribeHdrLibrary, hdrEnvironmentCatalogue);
+	const [problem, setProblem] = useState(null), [loading, setLoading] = useState(false), input = useRef(null);
+	useEffect(() => { void refreshHdrLibrary(); }, []);
+	// A map lights the set only while envLight > 0, so choosing one under the studio look turns that on too.
+	const choose = (hdr) => run("stage.set", { lighting: hdr ? { hdr, ...(lighting.envLight > 0 ? {} : { envLight: 1 }) } : { hdr: null } });
+	const load = async (event) => {
+		const file = event.target.files?.[0];
+		event.target.value = "";
+		if (!file) return;
+		setLoading(true);
+		try {
+			const { id } = await importHdrFile(file);
+			setProblem(null);
+			choose(id);
+		} catch (error) {
+			setProblem(error.message);
+		} finally {
+			setLoading(false);
+		}
+	};
+	const options = [{ value: "", label: ko("None (the look's sky)", "없음 (룩의 하늘)") },
+		...environments.map(({ id, name, source }) => ({ value: id, label: source === "builtin" ? ko(name, KO_NAMES[id] ?? name) : name }))];
+	return (
+		<div data-testid="hdr-environment">
+			<Field label={ko("HDR environment", "HDR 환경")}>
+				<Dropdown value={lighting.hdr ?? ""} ariaLabel={ko("HDR environment", "HDR 환경")} options={options} onChange={(value) => choose(value || null)} />
+			</Field>
+			<button type="button" className="btn ghost" disabled={loading} onClick={() => input.current?.click()}>
+				{loading ? ko("Loading HDR…", "HDR 불러오는 중…") : ko("Load HDR…", "HDR 불러오기…")}
+			</button>
+			<input ref={input} type="file" hidden data-testid="hdr-file" accept=".hdr,.exr,.png,.jpg,.jpeg,image/vnd.radiance,image/x-exr,image/png,image/jpeg" onChange={load} />
+			{problem && <p className="hint v2-details-hint" role="alert">{problem}</p>}
+			{lighting.hdr && <>
+				<Slider label={ko("Rotation", "회전")} min={-180} max={180} step={1} unit="°" value={lighting.hdrRotation} onChange={(hdrRotation) => setLighting({ hdrRotation })} />
+				<Slider label={ko("Intensity", "세기")} min={0} max={4} step={0.05} value={lighting.hdrIntensity} onChange={(hdrIntensity) => setLighting({ hdrIntensity })} />
+				<label className="check details-toggle-row">
+					<span>{ko("Show as background", "배경으로 표시")}</span>
+					<input type="checkbox" checked={lighting.hdrBackground} onChange={(event) => run("stage.set", { lighting: { hdrBackground: event.target.checked } })} />
+				</label>
+				<button type="button" className="btn ghost" onClick={() => choose(null)}>{ko("Remove HDR", "HDR 제거")}</button>
+			</>}
+		</div>
+	);
+}

package/src/panels/LightPanel.jsx

@@ -1,17 +1,38 @@
 import { ko } from "../locale.js";
 import Foldout from "./Foldout.jsx";
-import { Slider } from "../ui.jsx";
-import { createKeyLight } from "../scenes.js";
+import { Dropdown, Field, Slider } from "../ui.jsx";
+import { createKeyLight, LIGHTING_PRESETS } from "../stage-lighting.js";
+import { STAGE_BACKGROUND } from "../grid-view.js";
 import { useStageTransaction } from "../domains/stage.js";
+import HdrEnvironmentControls from "./HdrEnvironmentControls.jsx";
 
-export default function LightPanel({ keyLightSelected, keyLight }) {
+const LOOK_LABELS = { studio: ["Studio", "스튜디오"], day: ["Day", "낮"], overcast: ["Overcast", "흐린 날"], golden: ["Golden hour", "골든아워"],
+	dusk: ["Dusk", "해 질 녘"], night: ["Night", "밤"], interior: ["Interior", "실내"], stage: ["Stage spotlight", "무대 조명"] };
+
+export default function LightPanel({ keyLightSelected, keyLight, lighting }) {
 	const { run, begin, commit, cancel } = useStageTransaction();
+	// One look in one undo step; sky and exposure then tweak it like any slider.
+	const setLighting = (patch) => run("run.update", { txId: begin("stage.set"), args: { lighting: patch } });
 	return (
 <Foldout hidden={!keyLightSelected} title={ko("Light", "조명")}>
 						<p className="hint v2-details-hint">{ko("Drag the sun in the scene to move the light. Shadows and warmth follow it.", "씬의 해를 드래그해 조명을 옮깁니다. 그림자와 빛의 방향이 따라옵니다.")}</p>
+						{lighting && <Field label={ko("Look", "조명 룩")}>
+							<Dropdown value={lighting.preset} ariaLabel={ko("Lighting look", "조명 룩")} options={LIGHTING_PRESETS.map((value) => ({ value, label: ko(...LOOK_LABELS[value]) }))}
+								onChange={(preset) => run("stage.applyLighting", { preset })} />
+						</Field>}
 						<div onPointerUp={commit} onPointerCancel={cancel} onKeyUp={commit} onBlur={commit}>
 						<Slider label={ko("Brightness", "밝기")} min={0} max={4} step={0.05} value={keyLight.intensity} onChange={(value) => run("run.update", { txId: begin("stage.setKeyLight"), args: { keyLight: { intensity: value } } })} />
-						<Slider label={ko("Warm ↔ Cool", "따뜻함 ↔ 차가움")} min={0} max={1} step={0.05} value={keyLight.warmth ?? 0.5} onChange={(value) => run("run.update", { txId: begin("stage.setKeyLight"), args: { keyLight: { warmth: value } } })} />
+						<Slider label={ko("Warm ↔ Cool", "따뜻함 ↔ 차가움")} min={0} max={1} step={0.05} value={keyLight.warmth ?? 0.5} onChange={(value) => run("run.update", { txId: begin("stage.setKeyLight"), args: { keyLight: { warmth: value, color: null } } })} />
+						{lighting && <>
+							<Slider label={ko("Exposure", "노출")} min={0.2} max={3} step={0.05} value={lighting.exposure} onChange={(exposure) => setLighting({ exposure })} />
+							<Slider label={ko("Sky light", "하늘빛")} min={0} max={2} step={0.05} value={lighting.envLight ?? 0} onChange={(envLight) => setLighting({ envLight })} />
+							<Slider label={ko("Ambient occlusion", "앰비언트 오클루전")} min={0} max={1} step={0.05} value={lighting.ao ?? 0} onChange={(ao) => setLighting({ ao })} />
+							<Field label={ko("Sky", "하늘")}>
+								<input type="color" className="object-color object-color-free" value={lighting.sky ?? STAGE_BACKGROUND} title={ko("Sky colour", "하늘 색")} aria-label={ko("Sky colour", "하늘 색")}
+									onChange={(event) => setLighting({ sky: event.target.value })} />
+							</Field>
+							<HdrEnvironmentControls lighting={lighting} run={run} setLighting={setLighting} />
+						</>}
 						</div>
 						<div className="readout v2-details-readout">
 							<span title={ko("light position", "조명 위치")}>{`x ${keyLight.x.toFixed(1)}  y ${keyLight.y.toFixed(1)}  z ${keyLight.z.toFixed(1)}`}</span>

package/src/panels/ObjectLookPanel.jsx

@@ -0,0 +1,88 @@
+import { useContext, useEffect, useRef } from "react";
+import { AppContext } from "../app-context.js";
+import { useStudioShell } from "../shell/studio-shell-context.js";
+import Foldout from "./Foldout.jsx";
+import { Field, Slider } from "../ui.jsx";
+import { ko } from "../locale.js";
+import { LIGHT_KIND, practicalShadows } from "../object-look.js";
+
+/**
+ * Light and glow for the selected record: a practical light's type, colour,
+ * brightness, reach, cone, shadow and flicker, and any record's glow. A drag is
+ * one open transaction (one undo); a switch is one atomic edit.
+ */
+export default function ObjectLookPanel() {
+	const { selectedSceneObject: object, sceneObjects, beginSceneTransaction, endSceneTransaction } = useStudioShell();
+	const app = useContext(AppContext), session = useRef(null);
+	const run = (...args) => {
+		const receipt = app.bus.run(...args);
+		if (receipt && !receipt.ok) app.notify(receipt.message);
+		return receipt;
+	};
+	function commit() {
+		const active = session.current;
+		if (!active) return;
+		session.current = null;
+		endSceneTransaction(active.txId, { commit: true });
+	}
+	function drag(field, patch) {
+		if (session.current?.field !== field) commit();
+		if (!session.current) session.current = { field, txId: beginSceneTransaction({ owner: `inspector:${field}`, cancel: () => { session.current = null; } }) };
+		run("run.update", { txId: session.current.txId, args: { id: object.id, patch } });
+	}
+	const set = (patch) => { commit(); run("object.update", { id: object.id, patch }); };
+	useEffect(() => () => commit(), [object?.id]);
+	if (!object) return null;
+	const light = object.renderer === LIGHT_KIND ? object.light : null;
+	const glow = object.glow ?? null;
+	const capped = light?.shadow && practicalShadows(sceneObjects).capped.includes(object.id);
+	const ends = { onPointerUp: commit, onPointerCancel: commit, onKeyUp: commit, onBlur: commit };
+	const lightSlider = (field, label, min, max, step, unit = "") => (
+		<Slider label={label} min={min} max={max} step={step} unit={unit} softMax value={light[field]} onChange={(value) => drag(`light.${field}`, { light: { [field]: value } })} />
+	);
+	return (
+		<>
+			{light && (
+				<Foldout title={ko("Light", "조명")}>
+					<div {...ends}>
+						<Field label={ko("Type", "종류")}>
+							<select value={light.type} onChange={(event) => set({ light: { type: event.target.value } })}>
+								<option value="point">{ko("Point", "점 조명")}</option>
+								<option value="spot">{ko("Spot", "스포트")}</option>
+							</select>
+						</Field>
+						<Field label={ko("Colour", "색")}>
+							<input type="color" value={light.color} onChange={(event) => drag("light.color", { light: { color: event.target.value } })} />
+						</Field>
+						{lightSlider("intensity", ko("Intensity (cd)", "밝기 (cd)"), 0, 100, 0.05)}
+						{lightSlider("range", ko("Range (0 = none)", "범위 (0 = 없음)"), 0, 30, 0.1, " m")}
+						{light.type === "spot" && lightSlider("angle", ko("Cone angle", "원뿔 각도"), 1, 89, 1, "°")}
+						{light.type === "spot" && lightSlider("softness", ko("Edge softness", "가장자리 부드럽기"), 0, 1, 0.05)}
+						{lightSlider("flicker", ko("Flicker", "깜빡임"), 0, 1, 0.05)}
+						<label className="check details-toggle-row">
+							<span>{capped ? ko("Shadow (off: only 2 lights cast)", "그림자 (꺼짐: 2개까지만)") : ko("Shadow", "그림자")}</span>
+							<input type="checkbox" checked={light.shadow} onChange={(event) => set({ light: { shadow: event.target.checked } })} />
+						</label>
+					</div>
+				</Foldout>
+			)}
+			<Foldout title={ko("Glow", "발광")} defaultOpen={Boolean(glow)}>
+				<div {...ends}>
+					<label className="check details-toggle-row">
+						<span>{ko("Glows (lit by itself)", "스스로 빛남")}</span>
+						<input type="checkbox" checked={Boolean(glow)} onChange={(event) => set({ glow: event.target.checked ? {} : null })} />
+					</label>
+					{glow && (
+						<>
+							<Field label={ko("Colour", "색")}>
+								<input type="color" value={glow.color} onChange={(event) => drag("glow.color", { glow: { color: event.target.value } })} />
+							</Field>
+							<Slider label={ko("Intensity", "세기")} min={0} max={20} step={0.1} value={glow.intensity} onChange={(value) => drag("glow.intensity", { glow: { intensity: value } })} />
+							<Slider label={ko("Halo (× size)", "후광 (× 크기)")} min={0} max={4} step={0.05} value={glow.halo} onChange={(value) => drag("glow.halo", { glow: { halo: value } })} />
+						</>
+					)}
+				</div>
+			</Foldout>
+		</>
+	);
+}

package/src/panels/PosePanel.jsx

@@ -1,18 +1,15 @@
 import Foldout from "./Foldout.jsx";
 import { ko, isKo } from "../locale.js";
-import { I2vMotionCaptureCard } from "../i2v-motion-studio.jsx";
 import { PoseTileGrid } from "../posestudio.jsx";
 import { DEFAULT_POSE } from "../poses.js";
 import { poseLabelKo } from "../app-stage.jsx";
 import ReferenceImageField from "./ReferenceImageField.jsx";
 import { useBus } from '../app-context.js';
-import { trackFeature } from "../analytics.js";
 
 export default function PosePanel({
-	isCharacterSelection, activeCharIndex, i2vMotionModel, i2vMotionActions, setI2vMotionStudioOpen,
+	isCharacterSelection, activeCharIndex,
 	selectablePoses, activeChar, ikMode, ikApplyPoseAsKey, motion,
-	setStudioPick, setToast, removePose, setPhotoPoseError, photoPoseFileRef,
-	photoPoseState, photoPoseError, activeRig, saveCurrentPose,
+	setStudioPick, setToast, removePose, activeRig, saveCurrentPose,
 }) {
 	const { run } = useBus();
 	return (
@@ -24,12 +21,6 @@ export default function PosePanel({
 					<p className="inspector-hint v2-details-hint">
 						{isKo ? `인물 ${activeCharIndex + 1}의 자세입니다.` : `The pose on Subject ${activeCharIndex + 1}.`}
 					</p>
-					<I2vMotionCaptureCard model={i2vMotionModel} actions={i2vMotionActions} onOpen={() => {
-						// While the route is locked its Generate button is disabled, so opening
-						// the authoring modal is the card's demand signal (#466).
-						trackFeature("fal_motion_open");
-						setI2vMotionStudioOpen(true);
-					}} />
 					<PoseTileGrid
 						poses={selectablePoses}
 						model={activeChar.model}
@@ -50,14 +41,8 @@ export default function PosePanel({
 								: ko("Pose applied", "포즈를 적용했어요"));
 						}}
 						onDelete={removePose}
-						onPhoto={() => {
-							setPhotoPoseError("");
-							photoPoseFileRef.current?.click();
-						}}
-						photoState={photoPoseState}
 						labelOf={poseLabelKo}
 					/>
-					{photoPoseError && <p className="studio-hint error" data-pose-photo-error role="status">{photoPoseError}</p>}
 					{/* Bottles whatever the viewport shows right now — a take frame,
 					    IK corrections included — without touching the character, so a
 					    good mid-clip moment becomes a reusable library pose. */}

package/src/panels/RigControlPanel.jsx

@@ -1,48 +1,18 @@
-import { useEffect } from "react";
 import Foldout from "./Foldout.jsx";
-import { useStudioShell } from "../shell/studio-shell-context.js";
-import { useMotionCommands } from "../domains/motion.js";
 import { ko, isKo } from "../locale.js";
-import { HIERARCHY_INSPECTOR_TITLES, lineTrackLabel } from "../app-stage.jsx";
-import { PhysicsPanel } from "../ardy/physics-panel.jsx";
-import { Field } from "../ui.jsx";
-import { MotionReadiness } from "../motion-readiness-ui.jsx";
+import { HIERARCHY_INSPECTOR_TITLES } from "../app-stage.jsx";
 import { RangePinPanel } from "../range-pin-panel.jsx";
-import { TRAIL_TRACKS } from "../motion-trail.js";
-import { PlatformFitPanel } from "../ardy/platform-fit-panel.jsx";
-import "../ardy/auto-fix-panel.css";
+
 import "./pose.css";
 
 export default function RigControlPanel({
  isRigSelection, rigSelection, ikChains, ikFocus, footSnap, ikMode, poseObjectOpacity = 0.2, setPoseObjectOpacity,
- collisionCleanupSupported, motion, autoPhysicsRunning, physicsProgress, physicsPreview,
- physicsShow, physicsOptions, tlFrame, changePhysicsOptions, runAutoPhysics, showPhysicsPreview,
- applyPhysicsPreview, cancelPhysicsPreview, setTlFrame, platformFitRunning, platformFitProgress,
- platformFitLast, platformFitApplied, ikEditTool, setIkEditTool, showTrails, setShowTrails,
- trailFalloffS, setTrailFalloffS, trailEdit, trailTrackFocus = null, selectTrailTrack, clearTrailTrackFocus, pendingIkEdit = null, applyPendingIkEdit, cancelPendingIkEdit, generationBusy, bridgeChecking, bridge,
- runTrailRegeneration, trailReadinessState, openMotionSetup, recheckMotionHealth,
+ motion, tlFrame, ikEditTool, setIkEditTool, pendingIkEdit = null, applyPendingIkEdit, cancelPendingIkEdit,
  rangePins = [], rangePinResiduals = new Map(), rangePinSelection = null, rangePinPartPick = null,
  rangePinPreview = null, objects = [], setRangePinSelection, setRangePinPartPick,
  previewRangePinDraft, applyRangePinDraft, deleteRangePin,
 }) {
- const { run } = useMotionCommands();
- const shell = useStudioShell();
- useEffect(() => {
-  const preview = platformFitLast && !platformFitApplied && platformFitLast.candidate;
-  const physics = physicsPreview && !preview;
-  if (preview) {
-   shell?.setStatusText?.(ko("Platform fit preview — review before applying", "발판 맞춤 미리보기 — 적용 전에 확인하세요"));
-   const next = (platformFitLast.steps ?? []).map((step) => ({ start: step.start, end: step.end, kind: "body" }));
-   shell?.setPreviewRanges?.((current) => JSON.stringify(current) === JSON.stringify(next) ? current : next);
-  } else if (physics) {
-   shell?.setStatusText?.(ko("Physics cleanup preview — review before applying", "물리 정리 미리보기 — 적용 전에 확인하세요"));
-   const next = (physicsPreview.changedFrames ?? []).map((frame) => ({ start: frame, end: frame, kind: "body" }));
-   shell?.setPreviewRanges?.((current) => JSON.stringify(current) === JSON.stringify(next) ? current : next);
-  } else if (!platformFitRunning) {
-   shell?.setStatusText?.(""); shell?.setPreviewRanges?.((current) => current.length ? [] : current);
-  }
- }, [platformFitLast, platformFitApplied, platformFitRunning, physicsPreview, shell]);
- const activeTool = ikEditTool === "trail" ? "Path fix" : ikEditTool === "pin" ? "Pin" : "IK";
+ const activeTool = ikEditTool === "pin" ? "Pin" : "IK";
  return <Foldout hidden={!isRigSelection} title={ko("Pose", "포즈")}>
   <div className="pose-details" data-testid="pose-details">
    <section className="pose-section">
@@ -60,10 +30,9 @@ export default function RigControlPanel({
     <p className="inspector-hint">{rigSelection && rigSelection.token !== "rig" ? (isKo ? `${HIERARCHY_INSPECTOR_TITLES[rigSelection.token]}이 활성 제어 그룹입니다.` : `${HIERARCHY_INSPECTOR_TITLES[rigSelection.token]} is the active control group.`) : ko("Select a body group to pose it in the viewport.", "몸 그룹을 선택해 뷰포트에서 포즈를 잡으세요.")}</p>
    </section>
    {ikMode && <section className="pose-section" data-testid="pose-active-tool">
-    <h4>{ko("Active tool", "활성 도구")} · {ko(activeTool, activeTool === "Path fix" ? "경로 수정" : activeTool === "Pin" ? "고정" : "IK")}</h4>
+    <h4>{ko("Active tool", "활성 도구")} · {ko(activeTool, activeTool === "Pin" ? "고정" : "IK")}</h4>
     <div className="pose-actions">
      <button type="button" className={"btn" + (ikEditTool === "ik" ? " primary" : "")} aria-pressed={ikEditTool === "ik"} onClick={() => setIkEditTool("ik")}>{ko("IK", "IK")}</button>
-     <button type="button" className={"btn" + (ikEditTool === "trail" ? " primary" : "")} aria-pressed={ikEditTool === "trail"} disabled={!showTrails} onClick={() => setIkEditTool("trail")}>{ko("Path fix", "경로 수정")}</button>
      <button type="button" data-testid="range-pin-tool" className={"btn" + (ikEditTool === "pin" ? " primary" : "")} aria-pressed={ikEditTool === "pin"} disabled={!motion} onClick={() => { setIkEditTool("pin"); setRangePinPartPick?.(null); }}>{ko("Pin", "고정")}</button>
     </div>
     {pendingIkEdit && <div className="pose-section" data-testid="ik-pending-edit">
@@ -75,25 +44,8 @@ export default function RigControlPanel({
      </div>
     </div>}
     {ikEditTool === "pin" && <RangePinPanel active motion={motion} frame={tlFrame} frameCount={motion?.frames ?? 1} fps={motion?.fps ?? 24} pins={rangePins} residuals={rangePinResiduals} objects={objects} selectedPinId={rangePinSelection} partPick={rangePinPartPick} conflictFrames={rangePinPreview?.conflictFrames ?? []} overlapError={rangePinPreview?.overlapError ?? ""} onSelectPin={(id) => { setRangePinSelection?.(id); if (id) setIkEditTool("pin"); }} onApply={applyRangePinDraft} onCancel={() => { setRangePinSelection?.(null); setIkEditTool("ik"); }} onDelete={deleteRangePin} onPreviewTarget={previewRangePinDraft} />}
-    {ikEditTool === "trail" && <>
-     <button type="button" className="btn full" aria-pressed={showTrails} onClick={() => setShowTrails((value) => !value)}>{ko(`Trails ${showTrails ? "on" : "off"}`, `궤적선 ${showTrails ? "표시" : "숨김"}`)}</button>
-     <label className="pose-row" data-testid="trail-selection"><span>{ko("Shown line", "표시 라인")}</span><select data-testid="trail-track-select" value={trailTrackFocus ?? ""} onChange={(event) => selectTrailTrack(event.target.value)}>
-      <option value="" disabled>{ko("All lines", "모든 라인")}</option>
-      {TRAIL_TRACKS.map((track) => <option key={track.id} value={track.id}>{lineTrackLabel(track.id)}</option>)}
-     </select></label>
-     {trailTrackFocus && <button type="button" className="btn full" data-testid="trail-show-all" onClick={clearTrailTrackFocus}>{ko("Show all lines", "모든 라인 보기")}</button>}
-     <Field label={ko("Falloff", "영향 범위")}><div className="trail-falloff-row"><input type="range" min={0.1} max={2} step={0.1} value={trailFalloffS} onChange={(event) => setTrailFalloffS(Number(event.target.value))} /><span className="trail-falloff-value">{trailFalloffS.toFixed(1)}s</span></div></Field>
-     <button type="button" className="btn primary full" disabled={!trailEdit || !motion?.url || generationBusy || bridgeChecking || bridge === null} onClick={runTrailRegeneration}>{ko("Regenerate", "재생성")}</button>
-     <MotionReadiness state={trailReadinessState} checking={bridgeChecking} onSetup={() => openMotionSetup("trail")} onRetry={recheckMotionHealth} />
-    </>}
     {ikEditTool === "ik" && <p className="inspector-hint">{ko("Grab a hand, foot, elbow or knee handle in the viewport.", "뷰포트에서 손·발·팔꿈치·무릎 핸들을 잡으세요.")}</p>}
    </section>}
-   <section className="pose-section" data-testid="pose-auto-fix">
-    <h4>{ko("Auto-fix", "자동 수정")}</h4>
-    {collisionCleanupSupported && <div className="pose-actions"><button type="button" className="btn" disabled={!ikChains} onClick={() => run("motion.fixCollisions", { scope: "frame" })}>{ko("Body collisions · Frame", "신체 충돌 · 프레임")}</button><button type="button" className="btn" disabled={!ikChains || !motion} onClick={() => run("motion.fixCollisions", { scope: "clip" })}>{ko("Body collisions · Clip", "신체 충돌 · 클립")}</button></div>}
-    <PlatformFitPanel ko={ko} disabled={!ikChains || !motion || autoPhysicsRunning} running={platformFitRunning} progress={platformFitProgress} last={platformFitLast} applied={platformFitApplied} onRun={() => run("motion.platformFit.run", { preview: true })} onApply={() => run("motion.platformFit.remove", { apply: true })} onCancel={() => run("motion.platformFit.remove")} onRemove={() => run("motion.platformFit.remove")} onFrame={setTlFrame} />
-    <PhysicsPanel ko={ko} disabled={!ikChains || !motion} running={autoPhysicsRunning} progress={physicsProgress} preview={physicsPreview} show={physicsShow} options={physicsOptions} frame={tlFrame} frames={motion?.frames ?? 1} onOptions={changePhysicsOptions} onRun={runAutoPhysics} onShow={showPhysicsPreview} onApply={applyPhysicsPreview} onCancel={cancelPhysicsPreview} onFrame={setTlFrame} />
-   </section>
   </div>
  </Foldout>;
 }

package/src/panels/SubjectBox.jsx

@@ -32,7 +32,10 @@ export default function SubjectBox({ label, onRemove, onPose, posing, color, onC
 							title={isKo ? `${label} 포즈` : `Pose ${label}`}
 							onClick={onPose}
 						>
-							⌘
+							{/* The Pose mode figure, not a keyboard glyph. */}
+							<svg width="14" height="14" viewBox="0 0 16 16" fill="none" stroke="currentColor" strokeWidth="1.3" strokeLinecap="round" strokeLinejoin="round" aria-hidden="true">
+								<path d="M8 2.25a1.5 1.5 0 1 1 0 3 1.5 1.5 0 1 1 0-3z M5 7.25h6 M8 7.25v3.5 M6.25 13.75 8 10.75l1.75 3" />
+							</svg>
 						</button>
 					)}
 					{onRemove && (

package/src/panels/details.css

@@ -135,6 +135,20 @@
 	line-height: var(--details-hint-line-height, 1.4);
 }
 
+/* The follow-cam pointer is a plain hint here, not the dark theme's tinted box. */
+.v2-details-section.v2-details-section .camera-editor-pointer {
+	padding: 0;
+	border: 0;
+	background: none;
+}
+
+/* Each camera readout number carries its name. */
+.v2-details-section.v2-details-section .v2-details-readout small {
+	color: var(--text-3, #636369);
+	font-family: var(--sans);
+	font-size: 10px;
+}
+
 .v2-details-section.v2-details-section .inspector-hint + .inspector-hint,
 .v2-details-section.v2-details-section .hint + .hint {
 	margin-top: var(--details-gap, 4px);

package/src/posestudio.jsx

@@ -4,7 +4,7 @@ import { Html, Line } from "@react-three/drei";
 import * as THREE from "three";
 import { POSE_BONES, normalizeBoneName, primeBindPose } from "./poses.js";
 import { poseThumbnail, warmThumbnailModels } from "./pose-thumbs.js";
-import { IK_TRACKS, MID_TRACKS, ikControlIsExposed } from "./ardy/ik.js";
+import { IK_TRACKS, MID_TRACKS, ikControlIsExposed } from "./motion/ik.js";
 import { shouldRefreshIkExposure } from "./use-render-activity.js";
 import { POSER_LAYER } from "./dualview.jsx";
 import { ko, isKo } from "./locale.js";
@@ -1250,7 +1250,7 @@ export function warmPoseThumbnails() {
 	warmThumbnailModels(["y-bot-tpose", "x-bot-tpose"]);
 }
 
-export function PoseStudioPanel({ subject, model, poses, selectedId, onSelect, onApply, onReset, onSave, onDelete, onClose, closing, motionActive = false, ikCorrection = false, docked = false, onPhoto, photoState = "idle", photoError = "" }) {
+export function PoseStudioPanel({ subject, model, poses, selectedId, onSelect, onApply, onReset, onSave, onDelete, onClose, closing, motionActive = false, ikCorrection = false, docked = false }) {
 	const poseLabelsKo = {
 		"T-pose": ko("T-pose", "T 포즈"),
 		Relaxed: ko("Relaxed", "편안한 자세"),
@@ -1333,8 +1333,8 @@ export function PoseStudioPanel({ subject, model, poses, selectedId, onSelect, o
 			{poses.length === 0 && (
 				<p className="studio-hint" data-pose-empty role="status">
 					{ko(
-						"Your pose library is empty. Read a pose out of a photograph, or pose the character and save it — both stay here for every project.",
-						"포즈 라이브러리가 비어 있어요. 사진에서 자세를 읽어오거나 캐릭터 자세를 잡아 저장하면, 모든 프로젝트에서 계속 쓸 수 있어요.",
+						"Your pose library is empty. Pose the character and save it — it stays here for every project.",
+						"포즈 라이브러리가 비어 있어요. 캐릭터 자세를 잡아 저장하면, 모든 프로젝트에서 계속 쓸 수 있어요.",
 					)}
 				</p>
 			)}
@@ -1345,14 +1345,9 @@ export function PoseStudioPanel({ subject, model, poses, selectedId, onSelect, o
 				onSelect={selectPose}
 				onDelete={onDelete}
 				onSave={onSave}
-				onPhoto={onPhoto}
-				photoState={photoState}
 				categoryOf={poseCategory}
 				labelOf={displayPoseLabel}
 			/>
-			{photoError && (
-				<p className="studio-hint error" data-pose-photo-error role="status">{photoError}</p>
-			)}
 		</div>
 	);
 }
@@ -1372,8 +1367,6 @@ export function PoseTileGrid({
 	onSelect,
 	onDelete,
 	onSave,
-	onPhoto,
-	photoState = "idle",
 	categoryOf = () => "custom",
 	labelOf = (pose) => pose.label,
 }) {
@@ -1411,22 +1404,6 @@ export function PoseTileGrid({
 					<span className="add-text">{ko("Save pose", "포즈 저장")}</span>
 				</button>
 				)}
-				{onPhoto && (
-					<button
-						type="button"
-						className={"pose-tile add photo" + (photoState === "running" ? " busy" : "")}
-						data-pose-id="photo-pose"
-						data-photo-state={photoState}
-						disabled={photoState === "running"}
-						title={ko("Read the pose out of a reference photograph", "참조 사진에서 자세 읽어오기")}
-						onClick={onPhoto}
-					>
-						<span className="add-plus">{photoState === "running" ? "◌" : "◳"}</span>
-						<span className="add-text">
-							{photoState === "running" ? ko("Reading…", "읽는 중…") : ko("From photo", "사진에서")}
-						</span>
-					</button>
-				)}
 			</div>
 	);
 }

package/src/project-browser.jsx

@@ -200,7 +200,8 @@ export default function ProjectBrowser({ currentName, onOpen, onOpenFile, onNew,
 
 	const selectTemplate = (template) => {
 		setSelectedTemplateId(template.id);
-		setName((current) => current.trim() ? current : template.name);
+		// A name the previous card (or the open project) filled in follows the new card; a typed one stays.
+		setName((current) => !current.trim() || current.trim() === selectedTemplate?.name || current.trim() === currentName ? template.name : current);
 	};
 
 	const choosePrevisMode = (mode) => {
@@ -364,9 +365,7 @@ export default function ProjectBrowser({ currentName, onOpen, onOpenFile, onNew,
 				</main>
 
 				<aside className="v2-start-preview" data-testid="start-project-preview" aria-label={ko("Project preview", "프로젝트 미리보기")}>
-					<div className={`v2-start-preview-art ${selectedTemplate?.kind || "blank"}`} aria-hidden="true">
-						<span>{ko("template preview", "템플릿 미리보기")}</span>
-					</div>
+					<div className={`v2-start-preview-art ${selectedTemplate?.kind || "blank"}`} aria-hidden="true" />
 					<div className="v2-start-preview-copy">
 						<strong>{selectedTemplate?.name}</strong>
 						<span>{selectedTemplate?.description}</span>