cozyclay 3.2.0 → 3.2.1

package/src/motion3/repair.js

@@ -12,13 +12,16 @@
 // else is kept, and the applied entry says so (movedBody). A patch tried and not kept is not tried
 // again, so the groups after it get their turn. A round that keeps nothing ends the repair. The
 // compiler is deterministic and the candidates come in a fixed order, so the repair is too; no new
-// compile starts after 20 s.
+// compile starts after 20 s. A group whose hint has candidate patches (g.candidates, qa/patch.js: the
+// faces of a box a second hand can take, load.js) gets them all compiled, at most CANDIDATES, and the
+// one with the lowest summed severity stands for its patch: a hint compiles nothing, so only here
+// can the cheapest be found.
 import { applyPatch } from "./json-patch.js";
 import { groupKey } from "./qa/severity.js";
 import { tuneCandidates } from "./repair-tune.js";
 import { compareQa } from "./qa/verdict.js";
 
-const TRIES = 3, TUNE_GROUPS = 2, LIMIT_MS = 20000;
+const TRIES = 3, TUNE_GROUPS = 2, LIMIT_MS = 20000, CANDIDATES = 4;
 const groupsOf = r => r?.qa?.groups ?? [];
 const totalOf = r => groupsOf(r).reduce((sum, g) => sum + (g.severity ?? 0), 0);
 const failedOf = r => (r?.qa?.goals ?? []).filter(g => !g.ok).length;
@@ -38,14 +41,14 @@ const MOVED = "the body moved: no change that keeps it in place fixed this arm's
 /**
  * repairSpec(spec, { rounds }, compile) -> { spec, result, repair }
  * @param {object} spec  the agent's spec (patches address it)
- * @param {{ rounds?: number }} opts  1..8 (default 4)
+ * @param {{ rounds?: number, limitMs?: number }} opts  rounds 1..8 (default 4); limitMs, the wall-clock stop (default 20 s)
  * @param {(spec: object) => object} compile  spec -> pipeline.js compileSpec result (qa.groups[i].patch)
  * @returns {{ spec: object, result: object, repair: { rounds: number, compiles: number,
  *   applied: { kind: string, subject: string, patch: object[], severity: number[], movedBody?: string }[], rejected: number } }}
  */
 export function repairSpec(spec, opts, compile) {
 	const want = Math.min(8, Math.max(1, Math.round(Number(opts?.rounds ?? 4)) || 4)), t0 = performance.now();
-	const late = () => performance.now() - t0 >= LIMIT_MS;
+	const late = () => performance.now() - t0 >= (opts?.limitMs > 0 ? opts.limitMs : LIMIT_MS);
 	let current = spec, result = compile(spec), compiles = 1, rejected = 0, rounds = 0;
 	const refused = new Set();
 	const applied = [];
@@ -60,6 +63,23 @@ export function repairSpec(spec, opts, compile) {
 			return null;
 		}
 	};
+	/** g's patch compiled, or of its candidates ranked by summed severity the first that better() keeps ({ next, r, patch });
+	 * with none kept, the cheapest (the caller refuses it); null when none compiles. A cheaper face that breaks a goal
+	 * that held does not hide a dearer one that is kept. */
+	const cheapest = g => {
+		const tried = [];
+		for (const patch of (g.candidates ?? [g.patch]).slice(0, CANDIDATES)) {
+			if (tried.length && late()) break;
+			const t = attempt(patch);
+			if (!t) continue;
+			tried.push({ ...t, patch });
+			if (totalOf(t.r) === 0 && !failedOf(t.r) && better(t.r, result)) break;
+		}
+		tried.sort((a, b) => totalOf(a.r) - totalOf(b.r));
+		const pick = tried.find(t => better(t.r, result)) ?? tried[0] ?? null;
+		rejected += tried.filter(t => t !== pick).length;
+		return pick;
+	};
 	const keep = (g, key, patch, { next, r }) => {
 		const moved = armLocal(g) && movesBody(patch);
 		applied.push({ kind: g.kind, subject: g.subject, patch, severity: [g.severity, groupIn(r, key)?.severity ?? 0], ...(moved ? { movedBody: MOVED } : {}) });
@@ -97,8 +117,8 @@ export function repairSpec(spec, opts, compile) {
 			if (!g?.patch || late()) continue;
 			// an arm's failure whose patch moves the body waits until nothing else is kept this round
 			if (armLocal(g) && movesBody(g.patch)) { deferred.push(key); continue; }
-			const t = attempt(g.patch);
-			if (t && better(t.r, result)) { keep(g, key, g.patch, t); kept += 1; } else { refused.add(JSON.stringify(g.patch)); if (t) rejected += 1; }
+			const t = cheapest(g);
+			if (t && better(t.r, result)) { keep(g, key, t.patch, t); kept += 1; } else { refused.add(JSON.stringify(g.patch)); if (t) rejected += 1; }
 		}
 		for (const key of kept ? [] : near) {
 			const g = groupIn(result, key);
@@ -107,8 +127,8 @@ export function repairSpec(spec, opts, compile) {
 		for (const key of kept ? [] : deferred) {
 			const g = groupIn(result, key);
 			if (!g?.patch || late()) continue;
-			const t = attempt(g.patch);
-			if (t && better(t.r, result)) { keep(g, key, g.patch, t); kept += 1; break; } else { refused.add(JSON.stringify(g.patch)); if (t) rejected += 1; }
+			const t = cheapest(g);
+			if (t && better(t.r, result)) { keep(g, key, t.patch, t); kept += 1; break; } else { refused.add(JSON.stringify(g.patch)); if (t) rejected += 1; }
 		}
 		if (!kept) break;
 	}

package/src/motion3/skills/catch.js

@@ -42,7 +42,8 @@ export function catchObject(ctx) {
 	// the hand needs REACH frames from f0: a later pick it would get to in time; else it comes late to where the thing was
 	const contact = Math.max(pick.f, ctx.f0 + REACH + ARRIVE), p = pick.p;
 	const incoming = scale(sub(at(pick.f), at(pick.f - 1)), fps), speed = len(incoming), mass = massOf({ objects: ctx.objects }, scene, id);
-	const give = clamp(0.08 + 0.02 * mass * speed, 0.08, 0.15), u = norm(incoming), ease = t => 1 - (1 - t) ** 3;
+	// the give's first frame takes 24% of it (1 - (5/6)^1.5): a cubic's 42% of a 3 kg ball's 0.15 m jolted the hands, POP (#819)
+	const give = clamp(0.08 + 0.02 * mass * speed, 0.08, 0.15), u = norm(incoming), ease = t => 1 - (1 - t) ** 1.5;
 	const path = [p, ...Array.from({ length: ABSORB }, (_, i) => add(p, scale(u, give * ease((i + 1) / ABSORB)))), add(p, scale(u, give * 0.4))];
 	const start = Math.max(ctx.f0, contact - ARRIVE - LONG), both = side === "both" || mass > HEAVY;
 	// the left hand (both hands, or a heavy thing) on its left side, its finger middles across the thing from the right's

package/src/panels/FingerPanel.jsx

@@ -0,0 +1,38 @@
+import { ko } from "../locale.js";
+import { FINGER_PRESETS, fingerCurl } from "../motion/fingers.js";
+
+const FINGER_LABELS = { Thumb: ["Thumb", "엄지"], Index: ["Index", "검지"], Middle: ["Middle", "중지"], Ring: ["Ring", "약지"], Pinky: ["Pinky", "새끼"] };
+const PRESET_LABELS = { open: ["Open", "펴기"], fist: ["Fist", "주먹"], point: ["Pointing", "가리키기"] };
+
+/** A slider previews while it moves and bakes once on release, the same gesture shape as a viewport drag. */
+export default function FingerPanel({ fingers, tick, editing = false, onToggleEdit, onCurl, onCommit, onPreset }) {
+	if (!fingers.length) return null;
+	const side = fingers[0].side;
+	return (
+		<section className="pose-section" data-testid="finger-panel">
+			<h4>{side === "Left" ? ko("Left hand fingers", "왼손 손가락") : ko("Right hand fingers", "오른손 손가락")}</h4>
+			<div className="pose-actions">
+				<button type="button" className={"btn" + (editing ? " primary" : "")} aria-pressed={editing} data-testid="finger-edit-toggle" onClick={onToggleEdit}>
+					{editing ? ko("Editing fingertips", "손끝 편집 중") : ko("Edit fingertips", "손끝 편집")}
+				</button>
+			</div>
+			<div className="pose-actions">
+				{Object.keys(FINGER_PRESETS).map((name) => (
+					<button key={name} type="button" className="btn" data-testid={`finger-preset-${name}`} onClick={() => onPreset(name)}>{ko(...PRESET_LABELS[name])}</button>
+				))}
+			</div>
+			{fingers.map((finger) => (
+				<label key={`${finger.id}:${tick}`} className="pose-row pose-object-opacity">
+					<span>{ko(...FINGER_LABELS[finger.name])}</span>
+					<input type="range" min={0} max={100} step={1} defaultValue={Math.round(fingerCurl(finger) * 100)}
+						data-testid={`finger-curl-${finger.name.toLowerCase()}`} aria-label={ko(`${finger.name} bend`, `${FINGER_LABELS[finger.name][1]} 굽힘`)}
+						onChange={(event) => onCurl(finger.id, Number(event.target.value) / 100)}
+						onPointerUp={onCommit} onKeyUp={onCommit} />
+				</label>
+			))}
+			<p className="inspector-hint">{editing
+				? ko("Drag a fingertip dot to bend that finger. The hand's move and rotate tools come back when you leave fingertip editing.", "손끝 점을 끌면 그 손가락이 굽어요. 손끝 편집을 끄면 손 이동·회전 도구가 돌아와요.")
+				: ko("Turn on fingertip editing to drag fingertips in the viewport.", "손끝 편집을 켜면 뷰포트에서 손끝을 끌 수 있어요.")}</p>
+		</section>
+	);
+}

package/src/panels/RigControlPanel.jsx

@@ -2,12 +2,13 @@ import Foldout from "./Foldout.jsx";
 import { ko } from "../locale.js";
 import { HIERARCHY_INSPECTOR_TITLES } from "../app-stage.jsx";
 import { RangePinPanel } from "../range-pin-panel.jsx";
+import FingerPanel from "./FingerPanel.jsx";
 
 import "./pose.css";
 
 export default function RigControlPanel({
  isRigSelection, rigSelection, ikChains, ikFocus, footSnap, ikMode, poseObjectOpacity = 0.2, setPoseObjectOpacity,
- motion, tlFrame, ikEditTool, setIkEditTool, pendingIkEdit = null, applyPendingIkEdit, cancelPendingIkEdit,
+ motion, tlFrame, ikEditTool, setIkEditTool, pendingIkEdit = null, applyPendingIkEdit, cancelPendingIkEdit, onResetPose, fingerPanel = null,
  rangePins = [], rangePinResiduals = new Map(), rangePinSelection = null, rangePinPartPick = null,
  rangePinPreview = null, objects = [], setRangePinSelection, setRangePinPartPick,
  previewRangePinDraft, applyRangePinDraft, deleteRangePin,
@@ -27,6 +28,12 @@ export default function RigControlPanel({
       onChange={(event) => setPoseObjectOpacity(Number(event.target.value) / 100)} />
      <b>{Math.round(poseObjectOpacity * 100)}%</b>
     </div>}
+    {onResetPose && <div className="pose-actions">
+     <button type="button" className="btn" data-testid="pose-reset-default" onClick={onResetPose}
+      title={motion ? ko("Remove every IK edit; the motion plays as it was", "IK 수정을 모두 지워요. 모션은 원래대로 재생돼요") : ko("Back to the default pose", "기본 포즈로 되돌려요")}>
+      {motion ? ko("Clear pose edits", "포즈 수정 지우기") : ko("Reset to default pose", "기본 포즈로")}
+     </button>
+    </div>}
     <p className="inspector-hint">{rigSelection && rigSelection.token !== "rig" ? ko(`${HIERARCHY_INSPECTOR_TITLES[rigSelection.token]} is the active control group.`, `${HIERARCHY_INSPECTOR_TITLES[rigSelection.token]}이 활성 제어 그룹입니다.`, `${HIERARCHY_INSPECTOR_TITLES[rigSelection.token]}是当前控制组。`) : ko("Select a body group to pose it in the viewport.", "몸 그룹을 선택해 뷰포트에서 포즈를 잡으세요.")}</p>
    </section>
    {ikMode && <section className="pose-section" data-testid="pose-active-tool">
@@ -46,6 +53,7 @@ export default function RigControlPanel({
     {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 === "ik" && <p className="inspector-hint">{ko("Grab a hand, foot, elbow or knee handle in the viewport.", "뷰포트에서 손·발·팔꿈치·무릎 핸들을 잡으세요.")}</p>}
    </section>}
+   {ikMode && ikEditTool === "ik" && fingerPanel && <FingerPanel {...fingerPanel} />}
   </div>
  </Foldout>;
 }

package/src/panels/SculptPanel.jsx

@@ -2,6 +2,7 @@ import { useEffect, useRef, useState } from "react";
 import Foldout from "./Foldout.jsx";
 import { ko } from "../locale.js";
 import { effortOptions } from "../workflow/agent-client.js"; import { saveExport } from "../export-workspace.js";
+import SculptPartTree from "./SculptPartTree.jsx";
 import "./sculpt.css";
 
 // Sculpt mode side panel (#739). Pure view: the run controller owns the run state and the
@@ -202,8 +203,7 @@ function ModelPicker({ picker, locked }) {
 function BlueprintSection({ blueprint, disabled }) {
 	if (!blueprint) return null;
 	const { state = "idle", pose = "keep", notes = "", prompt = "", sheet = null, error = null, startedAt = null, refusal = null, onPose, onNotes, onGenerate, onCancel, layout = [] } = blueprint;
-	const busy = state === "generating";
-	const waited = busy && startedAt ? Math.floor((Date.now() - startedAt) / 1000) : 0;
+	const busy = state === "generating", waited = busy && startedAt ? Math.floor((Date.now() - startedAt) / 1000) : 0;
 	return (
 		<div className="sculpt-blueprint" data-testid="sculpt-blueprint" data-state={state}>
 			<div className="sculpt-label"><span>{ko("Blueprint (model sheet)", "도면 (모델 시트)")}</span><small>{ko("front · side · back · top", "정면 · 측면 · 뒷면 · 윗면")}</small></div>
@@ -224,13 +224,15 @@ function BlueprintSection({ blueprint, disabled }) {
 					<span className="sculpt-now-expect">{ko("usually ~40–90s", "보통 ~40–90초")}</span>
 					<button type="button" className="btn ghost small" data-testid="sculpt-blueprint-cancel" onClick={() => onCancel?.()}>{ko("Cancel", "취소")}</button>
 				</div>
-			) : (
-				<button type="button" className="btn full" data-testid="sculpt-blueprint-generate" disabled={disabled || Boolean(refusal)} onClick={() => onGenerate?.()}>
+			) : !refusal && (
+				// Without a ChatGPT token there is no button: the refusal below says why (#970).
+				<button type="button" className="btn full" data-testid="sculpt-blueprint-generate" disabled={disabled} onClick={() => onGenerate?.()}>
 					{sheet ? ko("Generate again", "다시 생성") : ko("Generate blueprint", "도면 생성")}
 				</button>
 			)}
 			{refusal && !busy && <p className="inspector-hint" role="status" data-testid="sculpt-blueprint-refusal">{refusal}</p>}
 			{error && !busy && <p className="inspector-hint sculpt-error" role="alert" data-testid="sculpt-blueprint-error">{error}</p>}
+			{sheet?.notices?.length > 0 && !busy && <p className="inspector-hint" role="status" data-testid="sculpt-blueprint-notices">{sheet.notices.join(" ")}</p>}
 			{sheet && (
 				<figure className="sculpt-sheet-figure" data-testid="sculpt-blueprint-sheet">
 					<a href={sheet.dataUrl} target="_blank" rel="noreferrer" title={ko("Open full size", "원본 크기로 열기")}>
@@ -255,7 +257,7 @@ function BlueprintSection({ blueprint, disabled }) {
 	);
 }
 
-export default function SculptPanel({ run, reference, onReference, onStart, onCancel, onPlaceInScene, canStart, startRefusal, sculptName, hidden, modelPicker = null, blueprint = null }) {
+export default function SculptPanel({ run, reference, onReference, onStart, onCancel, onPlaceInScene, onSaveToShelf, canStart, startRefusal, sculptName, hidden, modelPicker = null, blueprint = null, parts = null }) {
 	const fileRef = useRef(null);
 	const [dragging, setDragging] = useState(false);
 	// The sheet is the clearest picture of what is off, so it starts open.
@@ -266,8 +268,6 @@ export default function SculptPanel({ run, reference, onReference, onStart, onCa
 	const stageIndex = STAGES.findIndex(([id]) => id === stage);
 	const iou = Number.isFinite(run?.iou) ? run.iou : null;
 	const target = Number.isFinite(run?.targetIou) ? run.targetIou : null;
-	const showProgress = stage !== "idle";
-	const startDisabled = !canStart || Boolean(startRefusal);
 	const hasLog = Boolean(run?.activity?.length);
 	useTicking((running && Boolean(run?.waiting)) || blueprint?.state === "generating");
 
@@ -327,14 +327,15 @@ export default function SculptPanel({ run, reference, onReference, onStart, onCa
 						{ko("Cancel", "취소")}
 					</button>
 				) : (
-					<button type="button" className="btn primary full" data-testid="sculpt-start" disabled={startDisabled}
+					<button type="button" className="btn primary full" data-testid="sculpt-start" disabled={!canStart || Boolean(startRefusal)}
 						aria-describedby={startRefusal ? "sculpt-start-refusal" : undefined} onClick={() => onStart?.()}>
 						{ko("Start (fast draft)", "시작 (빠른 초안)")}
 					</button>
 				)}
 				{!running && startRefusal && <p className="inspector-hint sculpt-refusal" id="sculpt-start-refusal" role="status" data-testid="sculpt-start-refusal">{startRefusal}</p>}
+				{sculptName && <SculptPartTree {...parts} />}
 
-				{showProgress && (
+				{stage !== "idle" && (
 					<div className="sculpt-progress" data-testid="sculpt-progress">
 						<ol className="sculpt-stepper" aria-label={ko("Sculpt stages", "조형 단계")}>
 							{STAGES.map(([id, label], index) => {
@@ -392,9 +393,8 @@ export default function SculptPanel({ run, reference, onReference, onStart, onCa
 
 				<button type="button" className="btn full" data-testid="sculpt-place" disabled={!sculptName || running}
 					aria-label={sculptName ? ko(`Place ${sculptName} in scene`, `${sculptName} 장면에 배치`, `将 ${sculptName} 放入场景`) : ko("Place in scene", "장면에 배치")}
-					onClick={() => onPlaceInScene?.()}>
-					{ko("Place in scene", "장면에 배치")}
-				</button>
+					onClick={() => onPlaceInScene?.()}>{ko("Place in scene", "장면에 배치")}</button>
+				<button type="button" className="btn ghost full" data-testid="sculpt-save-shelf" disabled={!sculptName || running} title={ko("Keep a copy on the asset shelf (Content › Sculpts), for any scene or project", "에셋 선반(콘텐츠 › 조형물)에 사본을 보관해 어느 씬·프로젝트에서나 씁니다")} onClick={() => onSaveToShelf?.()}>{ko("Save to shelf", "선반에 저장", "保存到架子")}</button>
 
 				<p className="inspector-hint sculpt-hint" data-testid="sculpt-hint">
 					{ko("Fix details by chatting with the Agent (⌘B) while the sculpt is selected.", "조형물을 선택한 채 에이전트(⌘B)와 대화해 디테일을 고치세요.")}

package/src/panels/SculptPartTree.jsx

@@ -0,0 +1,46 @@
+import { useEffect, useRef } from "react";
+import { ko } from "../locale.js";
+
+// The sculpt's parts as an indented tree (#740 S7). Pure view: Sculpt mode
+// owns the selection; a row press selects that part, the same state a click
+// on the turntable sets. A mirrored part is listed once, as the recipe has it.
+// `notice` is the part gizmo's last refusal (#740 S8), shown under the list.
+export default function SculptPartTree({ tree, selected, onSelect, notice = null }) {
+	const listRef = useRef(null);
+	const selectedId = selected?.partId ?? null;
+	// A pick on the turntable brings its row into view.
+	useEffect(() => {
+		if (selectedId) listRef.current?.querySelector("[aria-pressed='true']")?.scrollIntoView?.({ block: "nearest" });
+	}, [selectedId]);
+	if (!tree?.length) return null;
+	return (
+		<div className="sculpt-parts" data-testid="sculpt-part-tree">
+			<div className="sculpt-label">
+				<span>{ko("Parts", "부품", "部件")}</span>
+				<small title={selectedId ? ko("W move · E rotate · R scale (Shift: uniform) · Esc to deselect", "W 이동 · E 회전 · R 크기 (Shift: 균등) · Esc로 선택 해제", "W 移动 · E 旋转 · R 缩放（Shift：等比）· 按 Esc 取消选择") : undefined}>
+					{selectedId ? ko("W move · E rotate · R scale", "W 이동 · E 회전 · R 크기", "W 移动 · E 旋转 · R 缩放") : ko(`${tree.length} parts`, `부품 ${tree.length}개`, `${tree.length} 个部件`)}
+				</small>
+			</div>
+			<ul className="sculpt-part-list" ref={listRef} aria-label={ko("Sculpt parts", "조형 부품", "雕塑部件")}>
+				{tree.map((row) => {
+					const on = row.id === selectedId;
+					return (
+						<li key={row.id}>
+							<button type="button" className="sculpt-part-row" data-testid="sculpt-part-row" data-part={row.id} aria-pressed={on}
+								data-mirrored={on && selected.mirrored ? "true" : undefined} style={{ "--sculpt-part-depth": row.depth }}
+								// A cutter is never drawn (it cuts its parent): nothing on the turntable to pick or move.
+								disabled={row.cutter} data-cutter={row.cutter || undefined}
+								title={row.cutter ? ko("A cutter is not drawn: it cuts its parent. Ask the agent to change it.", "커터는 그려지지 않아요. 부모 부품을 깎아요. 바꾸려면 에이전트에게 요청하세요.", "切割体不会被绘制，它用于切削父部件。如需修改，请让智能体处理。") : undefined}
+								onClick={() => onSelect?.({ partId: row.id, mirrored: false })}>
+								<span className="sculpt-part-id">{row.id}</span>
+								{on && selected.mirrored && <span className="sculpt-part-tag">{ko("mirror copy", "미러 사본", "镜像副本")}</span>}
+								<span className="sculpt-part-shape">{row.mirror ? `${row.shape} ×2` : row.shape}</span>
+							</button>
+						</li>
+					);
+				})}
+			</ul>
+			{notice && <p className="inspector-hint sculpt-error" role="alert" data-testid="sculpt-part-notice">{notice}</p>}
+		</div>
+	);
+}

package/src/panels/SubjectsPanel.jsx

@@ -17,7 +17,7 @@ export default function SubjectsPanel({
 									label={ko(`Subject ${index + 1}`, `인물 ${index + 1}`, `角色 ${index + 1}`)}
 									onPose={() => openStudio(entry.id)}
 									posing={posing === entry.id}
-									onRemove={index > 0 ? () => run('character.remove', { characterId: entry.id }) : undefined}
+									onRemove={() => run('character.remove', { characterId: entry.id })}
 									color={entry.tint ?? defaultCharacterTint(entry, index)}
 									/* A colour picker streams values while it is open, so the
 									   whole picking session is one Ctrl+Z entry. */

package/src/panels/sculpt.css

@@ -111,6 +111,17 @@
 .sculpt-race-row[data-leader="true"] .sculpt-race-label::before { content: "\2605  "; color: var(--ok); }
 .sculpt-race-row[data-refused="true"] { opacity: .5; text-decoration: line-through; }
 
+/* Part tree (#740 S7) */
+.sculpt-parts { display: grid; gap: 4px; }
+.sculpt-part-list { display: grid; gap: 1px; max-height: 200px; margin: 0; padding: 2px; list-style: none; overflow-y: auto; overscroll-behavior: contain; border-radius: var(--r-2); border: 1px solid var(--row-divider); background: var(--field); }
+.sculpt-part-row { display: flex; align-items: center; gap: 6px; width: 100%; min-height: 24px; padding: 2px 6px 2px calc(6px + var(--sculpt-part-depth) * 12px); border: 0; border-radius: var(--r-1); background: transparent; color: var(--text-2); font: inherit; font-size: 11px; text-align: left; cursor: pointer; }
+.sculpt-part-row:hover { background: var(--surface-active); color: var(--text-1); }
+.sculpt-part-row:focus-visible { outline: none; box-shadow: inset 0 0 0 2px var(--select-tint); }
+.sculpt-part-row[aria-pressed="true"] { background: var(--select-tint); color: var(--text-1); box-shadow: inset 2px 0 0 var(--select); }
+.sculpt-part-id { min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; font-family: var(--mono); }
+.sculpt-part-tag { flex: none; padding: 0 4px; border-radius: var(--r-1); background: var(--select); color: var(--surface-raised); font-size: 10px; }
+.sculpt-part-shape { flex: none; margin-left: auto; color: var(--text-3); }
+
 /* Activity log */
 .sculpt-log { display: grid; gap: 2px; max-height: 168px; margin: 0; padding: 4px 2px; list-style: none; overflow-y: auto; overscroll-behavior: contain; scroll-behavior: smooth; }
 .sculpt-log-row { display: grid; grid-template-columns: 30px 8px minmax(0, 1fr); align-items: baseline; gap: 6px; font-size: 11px; line-height: 1.4; color: var(--text-2); animation: sculpt-in .35s var(--ease) both; }

package/src/pose-fade.js

@@ -15,6 +15,8 @@ export function writePoseFadeOpacity(value, storage = globalThis.localStorage) {
 // Keyed by material: a material shared by several meshes is recorded once, so the restore is exact.
 const originals = new WeakMap();
 const noRaycast = () => {};
+// Keyed by mesh, not userData: R3F replaces an inline userData prop on re-render (#974).
+const savedRaycasts = new WeakMap();
 
 function materialsOf(mesh) {
 	return Array.isArray(mesh.material) ? mesh.material : mesh.material ? [mesh.material] : [];
@@ -67,11 +69,13 @@ export function applyPoseFade(root, fade, own = 1) {
 			}
 		}
 		if (unpickable && node.raycast !== noRaycast) {
-			node.userData.poseFadeRaycast = node.raycast;
+			if (Object.hasOwn(node, "raycast")) savedRaycasts.set(node, node.raycast);
 			node.raycast = noRaycast;
 		} else if (!unpickable && node.raycast === noRaycast) {
-			node.raycast = node.userData.poseFadeRaycast;
-			delete node.userData.poseFadeRaycast;
+			// Nothing saved means the prototype's method was in use: drop the own property.
+			if (savedRaycasts.has(node)) node.raycast = savedRaycasts.get(node);
+			else delete node.raycast;
+			savedRaycasts.delete(node);
 		}
 	});
 }

package/src/posestudio.jsx

@@ -6,6 +6,7 @@ import { POSE_BONES, normalizeBoneName, primeBindPose } from "./poses.js";
 import { poseThumbnail, warmThumbnailModels } from "./pose-thumbs.js";
 import { IK_TRACKS, MID_TRACKS, ikControlIsExposed } from "./motion/ik.js";
 import { pickIkHit } from "./motion/ik-pick.js";
+import { blockerDistanceTo, exposureProbe } from "./motion/ik-exposure.js";
 import { shouldRefreshIkExposure } from "./use-render-activity.js";
 import { POSER_LAYER } from "./dualview.jsx";
 import { ko } from "./locale.js";
@@ -283,7 +284,7 @@ const FK_ROTATE_SPEED = 5;
  * Every drag move calls `onSolve(kind, trackId, targetWorld)`; the drag end
  * calls `onDragEnd(trackId)` so the caller can key it.
  */
-export function IkHandles({ chains, fkJoints, ikState, enabled, focus, onFocus, onSolve, onDragEnd, selectionOnly = false, onPartPick }) {
+export function IkHandles({ chains, fkJoints, ikState, enabled, focus, onFocus, onSolve, onDragEnd, selectionOnly = false, onPartPick, focusToolsHidden = false, exposureProbeRef }) {
 	const { camera, gl, raycaster, scene } = useThree();
 	const handleRefs = useRef({}); // id -> mesh (all sphere handles)
 	const handleMetaRef = useRef(new Map()); // id -> { track, radius }
@@ -298,6 +299,9 @@ export function IkHandles({ chains, fkJoints, ikState, enabled, focus, onFocus,
 	const blockerRefs = useRef([]);
 	const skinnedBlockerProxiesRef = useRef(new Map());
 	const occlusionRay = useRef(new THREE.Raycaster()).current;
+	// The last pass's blockers, so the fingertip handles can ask the same exposure question (#913).
+	const occludersRef = useRef(null);
+	useEffect(() => { if (exposureProbeRef) exposureProbeRef.current = exposureProbe(camera, occludersRef); }, [exposureProbeRef, camera]);
 	const gizmoRef = useRef(null);
 	const ringRef = useRef(null); // rotation rings around the focused joint
 	const readoutRef = useRef(null);
@@ -679,28 +683,9 @@ export function IkHandles({ chains, fkJoints, ikState, enabled, focus, onFocus,
 				mesh.getWorldPosition(tmp.viewPoint);
 				const targetDistance = tmp.cameraPos.distanceTo(tmp.viewPoint);
 				tmp.rayDirection.copy(tmp.viewPoint).sub(tmp.cameraPos).normalize();
-				occlusionRay.set(tmp.cameraPos, tmp.rayDirection);
-				occlusionRay.near = 0.001;
-				occlusionRay.far = Math.max(0.001, targetDistance - 0.001);
-				let blockerDistance = occlusionRay.intersectObjects(staticBlockers, false)[0]?.distance;
-				// A coarse cloud of baked skin-surface spheres preserves the
-				// actual animated silhouette without asking Three.js to skin
-				// every triangle once per control ray. Camera-only changes now
-				// test a few cached points; pose changes rebuild the cloud once.
-				for (const proxy of skinnedProxies) {
-					const radiusSq = proxy.radius * proxy.radius;
-					for (const point of proxy.points) {
-						const dx = point.x - tmp.cameraPos.x;
-						const dy = point.y - tmp.cameraPos.y;
-						const dz = point.z - tmp.cameraPos.z;
-						const along = dx * tmp.rayDirection.x + dy * tmp.rayDirection.y + dz * tmp.rayDirection.z;
-						if (along < 0 || along > targetDistance + proxy.radius) continue;
-						const perpendicularSq = dx * dx + dy * dy + dz * dz - along * along;
-						if (perpendicularSq > radiusSq) continue;
-						const distance = Math.max(0, along - Math.sqrt(radiusSq - perpendicularSq));
-						if (distance < (blockerDistance ?? Infinity)) blockerDistance = distance;
-					}
-				}
+				// A coarse cloud of baked skin-surface spheres preserves the animated
+				// silhouette; camera-only changes test a few cached points, pose changes rebuild the cloud once.
+				const blockerDistance = blockerDistanceTo(occlusionRay, tmp.cameraPos, tmp.rayDirection, targetDistance, staticBlockers, skinnedProxies);
 				const visibilityDepth = meta?.track.visibilityDepth ?? (meta?.radius ?? JOINT_R) * 2;
 				const isExposed = ikControlIsExposed(targetDistance, blockerDistance, visibilityDepth);
 				visibilityDetailRef.current.set(id, {
@@ -719,6 +704,7 @@ export function IkHandles({ chains, fkJoints, ikState, enabled, focus, onFocus,
 				tmp.viewPoint.applyMatrix4(camera.matrixWorldInverse);
 				exposureDepthRef.current.set(id, -tmp.viewPoint.z);
 			}
+			occludersRef.current = { blockers: [...blockers] };
 			exposurePerfRef.current.passes += 1;
 			exposurePerfRef.current.raycasts += Object.keys(handleRefs.current).length;
 			exposurePerfRef.current.lastPassMs = performance.now() - passStartedAt;
@@ -757,7 +743,8 @@ export function IkHandles({ chains, fkJoints, ikState, enabled, focus, onFocus,
 		}
 		// A focused control keeps its gizmo and rings even when the body hides it:
 		// the user picked it, and while focused nothing else can take a press.
-		const focusExposed = !!focus;
+		// Finger editing hands the focused hand's space to the fingertip handles: no gizmo, rings or readout.
+		const focusExposed = !!focus && !focusToolsHidden;
 		if (gizmoRef.current) gizmoRef.current.visible = focusExposed;
 		if (ringRef.current) ringRef.current.visible = focusExposed;
 
@@ -947,7 +934,7 @@ const CLICK_PX = 4;
 				handleRefs.current[p.track.id]?.visible &&
 				(handleRefs.current[p.track.id]?.userData.ikExposed !== false || !p.part || p.track.id === focused)
 			);
-			if (focused && !selectionOnly) picks = picks.filter((p) => p.track.id === focused);
+			if (focused && !selectionOnly) picks = picks.filter((p) => p.track.id === focused && !(focusToolsHidden && (p.axisDir || p.part)));
 			else picks = picks.filter((p) => !p.axisDir); // spheres only
 			if (!picks.length) {
 				if (focused) beginDrag("empty", { id: "empty" }, null, null, downXY);
@@ -1059,7 +1046,7 @@ const CLICK_PX = 4;
 		<group>
 			{IK_TRACKS.map((track) => (chains.has(track.id) ? sphereFor(track, "chain", sideColor(track.id), HANDLE_R) : null))}
 			{MID_TRACKS.map((track) => (chains.has(track.chain) ? sphereFor(track, "mid", sideColor(track.id), JOINT_R) : null))}
-			{[...(fkJoints ?? [])].map(([id, joint]) => sphereFor(joint.track, id === "hips" ? "body" : "fk", sideColor(id), id === "hips" ? HANDLE_R : JOINT_R))}
+			{[...(fkJoints ?? [])].filter(([, joint]) => !joint.track.finger).map(([id, joint]) => sphereFor(joint.track, id === "hips" ? "body" : "fk", sideColor(id), id === "hips" ? HANDLE_R : JOINT_R))}
 
 			{gizmoTrack && (
 				<group ref={gizmoRef} renderOrder={999}>
@@ -1141,7 +1128,7 @@ const CLICK_PX = 4;
 					})}
 				</group>
 			)}
-			{rotateTrack && rotationDeg && (
+			{rotateTrack && rotationDeg && !focusToolsHidden && (
 				<group ref={readoutRef}>
 					<Html zIndexRange={[20, 0]} style={{ pointerEvents: "none" }}>
 						<RotationReadout readout={rotationReadout(rotationDeg, rotationDrag)} />

package/src/project-browser.css

@@ -215,6 +215,12 @@
 	box-shadow: inset 0 0 0 var(--start-border-width, 1px) var(--row-divider, #1d1d20);
 }
 
+/* Cast style: a three-up switch under the mode switch. */
+.v2-start-screen .v2-start-mode.cast {
+	grid-template-columns: repeat(3, minmax(0, 1fr));
+	margin-top: var(--sp-1, 8px);
+}
+
 .v2-start-screen .v2-start-mode-option {
 	min-width: var(--start-template-min-width, 0);
 	display: flex;

package/src/project-browser.jsx

@@ -13,8 +13,10 @@ import {
 	requestHandlePermission,
 	storeProjectsDirectory,
 	DEFAULT_PREVIS_MODE,
+	DEFAULT_CAST_STYLE,
 } from "./project.js";
 import { BrandMark, TemplateThumb } from "./project-browser-art.jsx";
+import { CAST_OPTIONS, StartChoiceGroup } from "./project-start-choices.jsx";
 import "./project-browser.css";
 
 const APP_VERSION = packageInfo.version;
@@ -105,6 +107,7 @@ export function ProjectNameDialog({ open, initialName = "My Project", onCancel,
 export default function ProjectBrowser({ currentName, onOpen, onOpenFile, onNew, onClose, startup = false, starters = [], onStarter }) {
 	const starterTemplates = useMemo(() => starters.map(sampleTemplate), [starters]);
 	const [previsMode, setPrevisMode] = useState(DEFAULT_PREVIS_MODE);
+	const [castStyle, setCastStyle] = useState(DEFAULT_CAST_STYLE);
 	const templates = previsMode === "storyboard" ? [] : starterTemplates;
 	const defaultTemplate = starterTemplates[0] ?? NEW_PROJECT;
 	const [activeNav, setActiveNav] = useState(startup ? "new" : "recent");
@@ -211,11 +214,11 @@ export default function ProjectBrowser({ currentName, onOpen, onOpenFile, onNew,
 		const projectName = name.trim();
 		if (!projectName) return;
 		if (selectedTemplate?.starterId) {
-			onStarter?.(selectedTemplate.starterId, projectName, { previsMode: "animation" });
+			onStarter?.(selectedTemplate.starterId, projectName, { previsMode: "animation", castStyle });
 			return;
 		}
 		stagePendingProjectName(projectName);
-		onNew(projectName, { previsMode });
+		onNew(projectName, { previsMode, castStyle });
 	};
 
 	const recentEntries = [
@@ -260,22 +263,10 @@ export default function ProjectBrowser({ currentName, onOpen, onOpenFile, onNew,
 							{activeNav !== "new" && <button type="button" className="v2-start-close x" onClick={onClose} aria-label={ko("Close", "닫기")}>×</button>}
 						</div>
 						{activeNav === "new" && (
-							<div className="v2-start-mode" role="radiogroup" aria-label={ko("Project mode", "프로젝트 모드")} data-testid="start-previs-mode">
-								{MODE_OPTIONS.map((option) => (
-									<button
-										type="button"
-										key={option.id}
-										role="radio"
-										aria-checked={previsMode === option.id}
-										className={`v2-start-mode-option${previsMode === option.id ? " active" : ""}`}
-										data-previs-mode={option.id}
-										onClick={() => choosePrevisMode(option.id)}
-									>
-										<strong>{option.label()}</strong>
-										<span>{option.blurb()}</span>
-									</button>
-								))}
-							</div>
+							<>
+								<StartChoiceGroup label={ko("Project mode", "프로젝트 모드")} testId="start-previs-mode" dataKey="previs-mode" options={MODE_OPTIONS} value={previsMode} onChange={choosePrevisMode} />
+								<StartChoiceGroup label={ko("Cast style", "캐스트 방식")} testId="start-cast-style" dataKey="cast-style" options={CAST_OPTIONS} value={castStyle} onChange={setCastStyle} className="cast" />
+							</>
 						)}
 					</div>
 

package/src/project-start-choices.jsx

@@ -0,0 +1,45 @@
+import { ko } from "./locale.js";
+
+// Which bodies a new project is cast with (castStyle in project.js). The rig
+// is the detailed humanoid, the capsule the quick stand-in; hybrid mixes both
+// and is the default. Either body stays reachable from Add in every style.
+export const CAST_OPTIONS = [
+	{
+		id: "rig",
+		label: () => ko("Humanoid", "휴머노이드"),
+		blurb: () => ko("Detailed previs with X/Y Bot: pose, IK and motion.", "X/Y Bot으로 디테일한 프리비즈: 포즈, IK, 모션."),
+	},
+	{
+		id: "capsule",
+		label: () => ko("Capsule", "캡슐"),
+		blurb: () => ko("Simple previs with capsule figures: path and posture.", "캡슐 인물로 간단한 프리비즈: 경로와 자세."),
+	},
+	{
+		id: "hybrid",
+		label: () => ko("Hybrid", "하이브리드"),
+		blurb: () => ko("Mix both; the agent may use capsules for hard shots.", "둘을 섞어 씁니다. 어려운 샷은 에이전트가 캡슐을 쓸 수 있어요."),
+	},
+];
+
+// One segmented single-choice control on the New view. Each option carries
+// `data-<dataKey>` with its id so tests and styles can address it.
+export function StartChoiceGroup({ label, testId, dataKey, options, value, onChange, className = "" }) {
+	return (
+		<div className={`v2-start-mode${className ? ` ${className}` : ""}`} role="radiogroup" aria-label={label} data-testid={testId}>
+			{options.map((option) => (
+				<button
+					type="button"
+					key={option.id}
+					role="radio"
+					aria-checked={value === option.id}
+					className={`v2-start-mode-option${value === option.id ? " active" : ""}`}
+					{...{ [`data-${dataKey}`]: option.id }}
+					onClick={() => onChange(option.id)}
+				>
+					<strong>{option.label()}</strong>
+					<span>{option.blurb()}</span>
+				</button>
+			))}
+		</div>
+	);
+}