cozyclay 3.1.6 → 3.2.1

package/src/sculpt-views.js

@@ -0,0 +1,75 @@
+// Multi-view sculpt comparison (#970): one sculpt scored against several views
+// of its subject (the blueprint's front, side and back crops), each by
+// compareSculptToReference, then blended by weight into one IoU.
+import { compareSculptToReference } from "./sculpt-compare.js";
+import { patchSculptRecipe } from "./sculpt-recipe.js";
+
+/** The default weight of each view: the front carries the likeness, the side the depth, the back the rest. */
+export const VIEW_WEIGHTS = Object.freeze({ front: 0.6, side: 0.25, back: 0.15 });
+/** A view whose subject's height:width differs from the front's by more than this is drawn at another scale or pose: weight 0. */
+export const VIEW_RATIO_TOLERANCE = 0.35;
+
+/** front (|yaw| <= 45), back (|yaw| >= 135) or side, from the camera yaw in degrees. */
+export function viewOfYaw(yaw) {
+	const turn = Math.abs(((Number(yaw) % 360) + 540) % 360 - 180);
+	return turn <= 45 ? "front" : turn >= 135 ? "back" : "side";
+}
+
+/**
+ * The weight each view gets. `views` are [{ yaw, weight?, heightToWidth }]:
+ * an explicit weight replaces the table's; then any view whose height:width
+ * differs from the front's by more than VIEW_RATIO_TOLERANCE gets weight 0 with
+ * the reason. The front is the front view nearest yaw 0; without one the ratio
+ * rule is skipped. Returns [{ weight, excluded? }] in the views' order.
+ */
+export function viewWeights(views) {
+	const fronts = views.map((view, index) => ({ index, yaw: Math.abs(Number(view.yaw)) })).filter(({ index }) => viewOfYaw(views[index].yaw) === "front");
+	const front = fronts.sort((a, b) => a.yaw - b.yaw)[0];
+	const frontRatio = front ? views[front.index].heightToWidth : null;
+	return views.map((view, index) => {
+		const weight = view.weight ?? VIEW_WEIGHTS[viewOfYaw(view.yaw)];
+		if (!front || index === front.index || !(frontRatio > 0)) return { weight };
+		const difference = Math.abs(view.heightToWidth / frontRatio - 1);
+		if (difference <= VIEW_RATIO_TOLERANCE) return { weight };
+		return { weight: 0, excluded: `height:width ${view.heightToWidth.toFixed(2)} differs from the front's ${frontRatio.toFixed(2)} by ${Math.round(difference * 100)}% (over ${VIEW_RATIO_TOLERANCE * 100}%)` };
+	});
+}
+
+const round = value => Number(value.toFixed(3));
+
+/**
+ * Score `recipe` against every view ([{ yaw, image, weight? }], images RGBA) and
+ * blend the IoUs by weight. The report is the heaviest view's (its sheet too),
+ * with `iou` the weighted one and `views` one row per view.
+ */
+function scoreViews(recipe, views, elevation, weights) {
+	const results = views.map(view => compareSculptToReference(recipe, view.image, { yaw: view.yaw, elevation }));
+	const used = weights ?? viewWeights(views.map((view, index) => ({ yaw: view.yaw, weight: view.weight, heightToWidth: 1 / results[index].report.widthToHeight.reference })));
+	const total = used.reduce((sum, row) => sum + row.weight, 0);
+	if (!(total > 0)) throw new Error("No view carries any weight: every view was excluded or given weight 0.");
+	const primary = used.reduce((best, row, index) => (row.weight > used[best].weight ? index : best), 0);
+	const iou = results.reduce((sum, result, index) => sum + result.report.iou * used[index].weight, 0) / total;
+	const rows = results.map(({ report }, index) => ({ view: viewOfYaw(views[index].yaw), yaw: views[index].yaw, weight: round(used[index].weight / total), iou: report.iou,
+		widthToHeight: report.widthToHeight, missingByBand: report.missingByBand, extraByPart: report.extraByPart.slice(0, 3), ...(used[index].excluded ? { excluded: used[index].excluded } : {}) }));
+	return { result: { report: { ...results[primary].report, iou: round(iou), views: rows }, sheet: results[primary].sheet }, weights: used };
+}
+
+/**
+ * The multi-view twin of scoreSculptAgainstReference: same return shape
+ * ({ result, ranked?, refused? }), so sculpt.compare and compare_sculpt answer
+ * one way. Candidates are scored on the same views with the same weights.
+ */
+export function scoreSculptAgainstViews(recipe, views, { elevation = 0, candidates } = {}) {
+	if (!Array.isArray(views) || !views.length) throw new Error("views needs at least one { yaw, reference }.");
+	const { result, weights } = scoreViews(recipe, views, elevation);
+	if (!candidates) return { result };
+	const ranked = [{ label: "current", result }];
+	const refused = [];
+	for (const candidate of candidates) {
+		const patched = patchSculptRecipe(recipe, candidate.edits);
+		if (!patched.ok) refused.push({ label: candidate.label, error: patched.error });
+		else ranked.push({ label: candidate.label, result: scoreViews(patched.recipe, views, elevation, weights).result });
+	}
+	ranked.sort((a, b) => b.result.report.iou - a.result.report.iou);
+	return { result, ranked, refused };
+}

package/src/semantic-edit.js

@@ -1,6 +1,3 @@
-import { createCameraBlock } from "./camera-block.js";
-import { isBusRunActive } from "./command-bus.js";
-
 // 2: counted from the user's own command-bus receipts (#922); 1 diffed domain values and
 // missed shot, camera and object edits in the real Studio.
 export const FIRST_EDIT_VERSION = 2;
@@ -10,62 +7,6 @@ export const FIRST_EDIT_KINDS = Object.freeze([
 	"prompt_block_add", "prompt_block_edit",
 ]);
 
-// Compare authored values, not object identities. Solvers and pointer callbacks
-// can reconstruct the same pose with floating-point roundoff. Values stay local;
-// only the closed edit-kind vocabulary ever crosses the analytics boundary.
-function equal(a, b) {
-	if (a === b) return true;
-	if (typeof a === "number" && typeof b === "number") return Math.abs(a - b) < 1e-8;
-	if (!a || !b || typeof a !== "object" || typeof b !== "object") return false;
-	if (a instanceof Map || b instanceof Map) {
-		return a instanceof Map && b instanceof Map && a.size === b.size
-			&& [...a].every(([key, value]) => b.has(key) && equal(value, b.get(key)));
-	}
-	const keys = Object.keys(a);
-	return keys.length === Object.keys(b).length && keys.every((key) => Object.hasOwn(b, key) && equal(a[key], b[key]));
-}
-const poseValue = (pose) => ({ bones: pose?.bones ?? {}, rootY: pose?.rootY ?? 0 });
-
-const keyValues = (keys = []) => keys.map(({ frame, framing }) => ({ frame, framing }));
-const shotValue = (shot) => ({ ...shot, camera: createCameraBlock(shot.camera), cameraKeys: keyValues(shot.cameraKeys) });
-
-export function semanticEditKind(domain, before, after) {
-	if (before === after) return null;
-	if (domain === "pose") return equal(before, after) ? null : "pose_edit";
-	
-	if (domain === "objects") {
-		const added = after.find((item) => !before.some((previous) => previous.id === item.id));
-		if (added) return added.renderer === "cutout" ? "cutout_insert" : "object_insert";
-		return equal(before, after) ? null : "object_transform";
-	}
-	if (domain === "characters") {
-		if (after.some((item) => !before.some((previous) => previous.id === item.id))) return "object_insert";
-		for (const item of after) {
-			const previous = before.find((entry) => entry.id === item.id);
-			if (previous && !equal(poseValue(previous.pose), poseValue(item.pose))) return "pose_edit";
-		}
-		// Motion buffers/layer synchronization are passive, not cast transforms.
-		const placement = (items) => items.map(({ id, x, y = 0, z, rot, scale = 1, hidden = false, model, tint, subject, identityImage }) => ({ id, x, y, z, rot, scale, hidden, model, tint, subject, identityImage }));
-		return equal(placement(before), placement(after)) ? null : "object_transform";
-	}
-	if (domain === "shots") {
-		if (after.some((item) => !before.some((previous) => previous.id === item.id))) return "shot_add";
-		for (const item of after) {
-			const previous = before.find((entry) => entry.id === item.id);
-			if (!previous) continue;
-			const camera = createCameraBlock(item.camera), oldCamera = createCameraBlock(previous.camera);
-			if (["cameraRail", "craneHeight", "railFollow", "dollyTiming"].some((key) => !equal(camera[key], oldCamera[key]))) return "rail_edit";
-			const keys = item.cameraKeys ?? [], oldKeys = previous.cameraKeys ?? [];
-			if (keys.length > oldKeys.length || keys.some((key) => {
-				const old = oldKeys.find((entry) => entry.frame === key.frame);
-				return old && !equal(old.framing, key.framing);
-			})) return "camera_key_record";
-		}
-		return equal(before.map(shotValue), after.map(shotValue)) ? null : "shot_edit";
-	}
-	return null;
-}
-
 /** (surface, kind) -> the surface's first edit, once: `${surface}:first_edit` with a closed kind. */
 export function createFirstEditRecorder(emit) {
 	// Dedupe once per editor App mount, independently for Studio and Playground.
@@ -80,31 +21,3 @@ export function createFirstEditRecorder(emit) {
 	record.seen = surface => seen.has(surface);
 	return record;
 }
-
-/** The same dedupe over a domain diff (semanticEditKind), for callers that hold before/after values. */
-export function createFirstEditTracker(emit) {
-	const record = createFirstEditRecorder(emit);
-	return (surface, domain, before, after) => {
-		if (record.seen(surface)) return false;
-		const kind = semanticEditKind(domain, before, after);
-		return kind ? record(surface, kind) : false;
-	};
-}
-
-// Synchronous mutation owner shared by UI and live commands. Keeping the before
-// value here avoids stale React closures and analytics inside replayable updater
-// functions. Passive writes (load, history, navigation) advance the same value
-// without reporting; a rejected reducer never publishes or reports anything.
-export function createSemanticState(initial, publish, observe, domain) {
-	let current = initial;
-	const apply = (update, authored) => {
-		const before = current;
-		const after = typeof update === "function" ? update(before) : update;
-		current = after;
-		if (authored && !isBusRunActive()) console.warn(`[bus] semantic edit for ${domain} called outside a bus run`);
-		publish(after);
-		if (authored) observe(domain, before, after);
-		return after;
-	};
-	return { set: (update) => apply(update, false), edit: (update) => apply(update, true) };
-}

package/src/settings-menu.jsx

@@ -2,7 +2,7 @@ import { useCallback, useRef, useState } from "react";
 import { ko, localeChosen } from "./locale.js";
 import PreferencesDialog from "./shell/PreferencesDialog.jsx";
 
-// App settings — language and analytics — behind one labelled topbar trigger
+// App settings — language — behind one labelled topbar trigger
 // (#193, docs/studio-ui-ia.md R4). Neither item edits the document, so they do
 // not belong on the Save/Export row as bare toggles.
 //
@@ -38,7 +38,7 @@ export default function SettingsMenu() {
 				data-testid="settings-menu-trigger"
 				aria-expanded={open}
 				aria-haspopup="dialog"
-				title={ko("Language and analytics", "언어 및 사용 통계")}
+				title={ko("Language settings", "언어 설정", "语言设置")}
 				ref={triggerRef}
 				onClick={() => (open ? close() : setOpen(true))}
 			>

package/src/shell/DetailsSlot.jsx

@@ -15,7 +15,7 @@ import PropsPanel from "../panels/PropsPanel.jsx";
 import ObjectTransformPanel from "../panels/ObjectTransformPanel.jsx";
 import ObjectLookPanel from "../panels/ObjectLookPanel.jsx";
 import { PoseStudioPanel } from "../posestudio.jsx";
-import { DEFAULT_POSE } from "../poses.js";
+import { posePanelControls } from "./pose-controls.js";
 import "../panels/details.css";
 
 export default function DetailsSlot() {
@@ -50,6 +50,7 @@ export default function DetailsSlot() {
 		savePose, beginWorkspaceResize,
 	} = useStudioShell();
 	const selection = detailsSelection({ selectedHierarchyId, selectedSceneObject, rigSelection, characters, shot, inspectorHasContent });
+	const { resetPose, fingerPanel } = posePanelControls(useStudioShell());
 	return (
 		<aside className="panel hierarchy-sidebar inspector-sidebar" data-inspector={selectedHierarchyId}>
 			{/* Save failures live above the tab content, not inside the Props
@@ -194,6 +195,8 @@ export default function DetailsSlot() {
 				pendingIkEdit={pendingIkEdit}
 				applyPendingIkEdit={applyPendingIkEdit}
 				cancelPendingIkEdit={cancelPendingIkEdit}
+				onResetPose={() => resetPose(activeChar.id)}
+				fingerPanel={fingerPanel}
 				rangePins={rangePins}
 				rangePinResiduals={rangePinResiduals}
 				rangePinSelection={rangePinSelection}
@@ -334,11 +337,7 @@ export default function DetailsSlot() {
 							setToast(ko("Couldn't find the selected pose — pick again", "선택한 포즈를 찾지 못했어요. 다시 골라 주세요"));
 						}
 					}}
-					onReset={() => {
-						if (posingChar) castDomain.run('character.setPose', { characterId: posingChar.id, pose: DEFAULT_POSE.id, clearMotion: Boolean(motion) });
-						setStudioPick(DEFAULT_POSE.id);
-						setToast(ko("Back to the default pose", "기본 포즈로 돌아왔어요"));
-					}}
+					onReset={() => { if (posingChar) resetPose(posingChar.id); }}
 					onSave={savePose}
 					onDelete={removePose}
 					onClose={closeStudio}

package/src/shell/LibrarySlot.jsx

@@ -2,6 +2,7 @@ import { useEffect, useState } from "react";
 import { useStudioShell } from "./studio-shell-context.js";
 import { ko } from "../locale.js";
 import AssetPane from "../asset-pane.jsx";
+import { dropAssetAt } from "../asset-drop.js";
 
 const CONTENT_COLLAPSED_KEY = "cozyclay.dock.content-collapsed.v1";
 
@@ -29,7 +30,7 @@ export default function LibrarySlot({ active = true }) {
 		manageAssetStorage, setManageAssetStorage, unusedAssetIds, usedAssetIds, usageCounts,
 		projectAssetGraphSignature, assetTrash, deleteUnusedAsset, undoDeletedAsset, deletingAssetId,
 		projectManifest, shots, selectTimelineShot, allPoses,
-		spawnCharacter, addSceneObject, runStudioAction,
+		spawnCharacter, addSceneObject, runStudioAction, setSelectedHierarchyId,
 	} = useStudioShell();
 	const [collapsed, setCollapsed] = useState(readContentCollapsed);
 	const [shelfShown, setShelfShown] = useState(false);
@@ -41,15 +42,12 @@ export default function LibrarySlot({ active = true }) {
 	}, [active, shelfShown, setBottomTab]);
 
 	// Double-click in Content: the same payloads the drag carries, placed at
-	// the origin through the named domain actions.
-	function placeAssetAtOrigin(payload) {
-		const origin = { x: 0, z: 0 };
-		if (payload.kind === "character") spawnCharacter(payload.id, origin.x, origin.z);
-		else if (payload.kind === "object") addSceneObject(payload.objectKind, origin);
-		else if (payload.kind === "image" || payload.kind === "mesh") {
-			runStudioAction("asset.import", { assetId: payload.assetId, placeAs: payload.kind === "mesh" ? "mesh" : "cutout", placement: origin });
-		}
-	}
+	// the origin through the same drop table (asset-drop.js).
+	const placeAssetAtOrigin = (payload) => dropAssetAt(payload, { x: 0, z: 0 }, {
+		spawnCharacter, addSceneObject, runStudioAction, select: setSelectedHierarchyId,
+		spawnCutoutAt: (assetId, placement) => runStudioAction("asset.import", { assetId, placeAs: "cutout", placement }),
+		spawnMeshAt: (assetId, placement) => runStudioAction("asset.import", { assetId, placeAs: "mesh", placement }),
+	});
 
 	return (
 		<section className="assets-pane studio-library" aria-label={ko("Library", "라이브러리")} data-content-collapsed={collapsed || undefined} hidden={!active}>

package/src/shell/MenuBar.jsx

@@ -4,6 +4,8 @@ import { useStudioShell } from "./studio-shell-context.js";
 import SourceOffer from "../source-offer.jsx";
 import { ko } from "../locale.js";
 import { noteShortcutsOpened } from "../shortcut-friction.js";
+import { appVersion } from "../app-version.js";
+import { useExportMenuTelemetry } from "../export-menu-telemetry.js";
 
 const MAC = typeof navigator !== "undefined" && /Mac|iPhone|iPad/.test(navigator.platform ?? "");
 const MOD = MAC ? "⌘" : "Ctrl+";
@@ -197,10 +199,9 @@ export default function MenuBar({ preferences }) {
 		? panelCount ? "" : noPanels
 		: shots.length ? "" : ko("Add a shot first — a pack describes one cut", "샷을 먼저 추가하세요 — 팩은 컷 하나를 설명합니다");
 
-	// Export's flyout lives in File, so an open Export menu opens File.
-	useEffect(() => {
-		if (exportMenuOpen) setOpen("file");
-	}, [exportMenuOpen]);
+	// Export's flyout lives in File, so an open Export menu opens File; each open is counted.
+	useEffect(() => { if (exportMenuOpen) setOpen("file"); }, [exportMenuOpen]);
+	useExportMenuTelemetry(exportMenuOpen, shell);
 
 	const closeMenus = (focusTrigger) => {
 		const was = open;
@@ -632,7 +633,6 @@ function MenuDialog({ kind, onClose }) {
 		document.addEventListener("keydown", onKey);
 		return () => document.removeEventListener("keydown", onKey);
 	}, [onClose]);
-	const version = import.meta.env.VITE_APP_VERSION;
 	return createPortal(
 		<div className="menubar-dialog-backdrop" onPointerDown={(event) => { if (event.target === event.currentTarget) onClose(); }}>
 			<div className="menubar-dialog" role="dialog" aria-modal="true" aria-labelledby={titleId} data-dialog={kind}>
@@ -645,7 +645,7 @@ function MenuDialog({ kind, onClose }) {
 				{kind === "about" ? (
 					<div className="menubar-dialog-body">
 						<p>{ko("Previs studio: stage, pose, camera and motion.", "프리비즈 스튜디오: 배치, 포즈, 카메라, 모션.")}</p>
-						{version && <p className="menubar-dialog-meta">{ko("Version", "버전")} {version}</p>}
+						<p className="menubar-dialog-meta">{ko("Version", "버전")} {appVersion()}</p>
 						<SourceOffer />
 					</div>
 				) : (

package/src/shell/PreferencesDialog.jsx

@@ -1,7 +1,7 @@
 import { useEffect, useMemo, useRef, useState } from "react";
 import { createPortal } from "react-dom";
 import { ko } from "../locale.js";
-import { getAnalyticsOptOut, loadAutoColor, preferenceSection, readStoredGridView } from "./preference-pages.jsx";
+import { loadAutoColor, preferenceSection, readStoredGridView } from "./preference-pages.jsx";
 import "./preferences.css";
 
 const NAV_GROUPS = [
@@ -24,7 +24,6 @@ export default function PreferencesDialog({ open, onClose, initialSection = "App
 	closeRef.current = onClose;
 	const [activeSection, setActiveSection] = useState(initialSection);
 	const [query, setQuery] = useState("");
-	const [analyticsOptOut, setAnalyticsOptOutState] = useState(getAnalyticsOptOut);
 	const [autoColor, setAutoColor] = useState(() => loadAutoColor());
 	const [gridView, setGridView] = useState(() => readStoredGridView(globalThis.localStorage));
 
@@ -69,7 +68,7 @@ export default function PreferencesDialog({ open, onClose, initialSection = "App
 	}, [open, initialSection]);
 
 	if (!open || typeof document === "undefined") return null;
-	const currentProps = { autoColor, setAutoColor, analyticsOptOut, setAnalyticsOptOutState, gridView, setGridView };
+	const currentProps = { autoColor, setAutoColor, gridView, setGridView };
 
 	return createPortal(
 		<div className="v2-preferences" data-testid="preferences-dialog-backdrop" onPointerDown={(event) => { if (event.target === event.currentTarget) closeRef.current?.(); }}>

package/src/shell/ViewportToolbar.jsx

@@ -6,12 +6,11 @@ import { PRESETS, SHOT_ASPECT_PRESETS } from "../app-stage.jsx";
 import { CAMERA_PRESETS } from "../camera-move.js";
 import { PRIME_SET } from "../shot.js";
 import { CatalogueEntries } from "../object-catalog.jsx";
-import { CHARACTER_MODEL_IDS } from "../scenes.js";
 import { elementByPath } from "../studio-elements.js";
 import { saveAutoColor } from "../auto-color.js";
 import { trackFeature } from "../analytics.js";
 import { GUIDE_LABELS, nextGuideMode } from "../shot-guides.js";
-import GhostsMenuGroup from "./GhostsMenuGroup.jsx"; import { addCameraShot } from "./add-camera-shot.js";
+import GhostsMenuGroup from "./GhostsMenuGroup.jsx"; import { addCameraShot } from "./add-camera-shot.js"; import { addCharacterEntries } from "./add-character-entries.js";
 import "./viewport.css";
 
 // G1: the single mode+tool pill. Keys 1-5 and W/E/R are bound in App's
@@ -122,7 +121,7 @@ export default function ViewportToolbar() {
 		autoColor, setAutoColor, isCharacterSelection, partColoursChoice, embedMode,
 		agentCollapsed, addSceneObject, spawnCharacter, characters, flySpeed,
 		ikEditTool, setIkEditTool, motion, setRangePinPartPick,
-		previsMode, sculptView, requestSculptView, appContext, setToast,
+		previsMode, castStyle, sculptView, requestSculptView, sculptParts, appContext, setToast,
 	} = useStudioShell();
 	const menu = useOverlayMenu();
 
@@ -154,11 +153,11 @@ export default function ViewportToolbar() {
 		],
 		// Motion is compiled by the agent (motion.compile); the department has no tools of its own.
 		motion: [],
-		// Sculpt mode's W/E/R swing the turntable camera to a reference view.
-		sculpt: [
-			{ key: "W", id: "front", name: ko("Front view", "정면 보기"), active: sculptView?.view === "front", pick: () => requestSculptView("front") },
-			{ key: "E", id: "side", name: ko("Side view", "측면 보기"), active: sculptView?.view === "side", pick: () => requestSculptView("side") },
-			{ key: "R", id: "back", name: ko("Back view", "뒷면 보기"), active: sculptView?.view === "back", pick: () => requestSculptView("back") },
+		// Sculpt mode's W/E/R swing the turntable camera to a reference view; with a part selected they drive its gizmo.
+		sculpt: sculptParts?.selected ? sculptParts.tools : [
+			{ key: "W", id: "front", name: ko("Front view (with a part selected, W moves it)", "정면 보기 (부품을 선택하면 W는 이동)"), active: sculptView?.view === "front", pick: () => requestSculptView("front") },
+			{ key: "E", id: "side", name: ko("Side view (with a part selected, E rotates it)", "측면 보기 (부품을 선택하면 E는 회전)"), active: sculptView?.view === "side", pick: () => requestSculptView("side") },
+			{ key: "R", id: "back", name: ko("Back view (with a part selected, R scales it)", "뒷면 보기 (부품을 선택하면 R은 크기)"), active: sculptView?.view === "back", pick: () => requestSculptView("back") },
 		],
 	}[workflowMode] ?? [];
 
@@ -277,16 +276,14 @@ export default function ViewportToolbar() {
 							<CatalogueEntries onPick={(kind) => { addSceneObject(kind); menu.close(); }} />
 							<div className="add-object-group">
 								<span className="add-object-heading">{ko("Scene", "장면")}</span>
-								<button
-									type="button"
-									role="menuitem"
-									className="add-object-item"
-									data-add="character"
-									onClick={() => { spawnCharacter(CHARACTER_MODEL_IDS[0], characterSpawnX(characters.length), 0); menu.close(); }}
-								>
-									<span className="add-object-swatch vp-add-swatch-cast" aria-hidden="true" />
-									<span>{ko("Character", "캐릭터")}</span>
-								</button>
+								{addCharacterEntries(castStyle).map((entry) => (
+									<button key={entry.add} type="button" role="menuitem" className="add-object-item" data-add={entry.add}
+										onClick={() => { spawnCharacter(entry.model, characterSpawnX(characters.length), 0); menu.close(); }}
+									>
+										<span className="add-object-swatch vp-add-swatch-cast" aria-hidden="true" />
+										<span>{entry.label()}</span>
+									</button>
+								))}
 								<button
 									type="button"
 									role="menuitem"

package/src/shell/add-character-entries.js

@@ -0,0 +1,13 @@
+// Add > Character offers both bodies in every project (ViewportToolbar). The
+// project's cast style only decides which one comes first: never hide either.
+import { ko } from "../locale.js";
+import { CHARACTER_MODEL_IDS, PROXY_FIGURE_MODEL } from "../scenes.js";
+
+const ENTRIES = Object.freeze([
+	Object.freeze({ add: "character", model: CHARACTER_MODEL_IDS[0], label: () => "Y Bot" }),
+	Object.freeze({ add: "capsule", model: PROXY_FIGURE_MODEL, label: () => ko("Capsule figure", "캡슐 인물") }),
+]);
+
+export function addCharacterEntries(castStyle) {
+	return castStyle === "capsule" ? [ENTRIES[1], ENTRIES[0]] : ENTRIES;
+}

package/src/shell/pose-controls.js

@@ -0,0 +1,32 @@
+import { ko } from "../locale.js";
+import { DEFAULT_POSE } from "../poses.js";
+import { FINGER_PRESETS } from "../motion/fingers.js";
+
+// The Pose panel's reset and the focused hand's finger controls, read off the studio shell.
+export function posePanelControls(shell) {
+	const { motion, characters, runStudioAction, castDomain, setStudioPick, setToast, cancelPendingIkEdit } = shell;
+	// Over a take the default is the take itself: drop the IK edits and keep the motion.
+	// Without one, back to the default pose; clearMotion also drops the IK keys (one undo step).
+	const resetPose = (characterId) => {
+		cancelPendingIkEdit?.();
+		const current = characters.find((entry) => entry.id === characterId)?.pose;
+		// Already on the default pose: only the IK edits go. A pose write would re-apply the
+		// bare pose on Undo over the restored IK keys.
+		if (motion || !current || current.id === DEFAULT_POSE.id) {
+			runStudioAction("character.clearIkKeys", { characterId });
+			if (motion) {
+				setToast(ko("Pose edits cleared — the motion stays", "포즈 수정을 지웠어요 — 모션은 그대로예요"));
+				return;
+			}
+		} else castDomain.run('character.setPose', { characterId, pose: DEFAULT_POSE.id, clearMotion: true });
+		setStudioPick(DEFAULT_POSE.id);
+		setToast(ko("Back to the default pose", "기본 포즈로 돌아왔어요"));
+	};
+	const { handFingers: fingers, ikTick, ikSolve, ikDragEnd, fingerEditing, setFingerEdit } = shell;
+	const fingerPanel = {
+		fingers, tick: ikTick, editing: fingerEditing, onToggleEdit: () => setFingerEdit(!fingerEditing),
+		onCurl: (id, curl) => ikSolve("finger", id, { curl }), onCommit: ikDragEnd,
+		onPreset: (name) => { for (const finger of fingers) ikSolve("finger", finger.id, { curl: FINGER_PRESETS[name][finger.name] }); ikDragEnd(); },
+	};
+	return { resetPose, fingerPanel };
+}

package/src/shell/preference-pages.jsx

@@ -1,4 +1,3 @@
-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";
@@ -13,7 +12,7 @@ import {
 } from "./preference-controls.jsx";
 
 export function preferenceSection(section, props) {
-	const { autoColor, setAutoColor, analyticsOptOut, setAnalyticsOptOutState, gridView, setGridView } = props;
+	const { autoColor, setAutoColor, gridView, setGridView } = props;
 
 	switch (section) {
 		case "Appearance":
@@ -31,14 +30,6 @@ export function preferenceSection(section, props) {
 						<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>
 				</>
 			);
@@ -69,4 +60,4 @@ export function preferenceSection(section, props) {
 }
 
 // Kept here so the dialog can load a new setting's initial value lazily.
-export { getAnalyticsOptOut, loadAutoColor, readStoredGridView };
+export { loadAutoColor, readStoredGridView };

package/src/shell/storyboard-caption.js

@@ -0,0 +1,21 @@
+// The storyboard contact sheet is drawn on a bare 2d canvas, which has no
+// stylesheet to inherit from: it gets the studio's own type stack explicitly
+// so the sheet reads like the app it came out of.
+export const STORYBOARD_FONT = '12px Inter, "Pretendard", "Noto Sans KR", system-ui, -apple-system, "Segoe UI", Helvetica, Arial, sans-serif';
+// One unwrapped caption line at 12px inside a 480px cell holds about 64
+// characters before it runs into the next column.
+const STORYBOARD_CAPTION_CHARS = 64;
+
+/** Cut a caption to what one unwrapped cell line holds. */
+export function storyboardLine(text) {
+	return text.length > STORYBOARD_CAPTION_CHARS ? `${text.slice(0, STORYBOARD_CAPTION_CHARS - 1)}\u2026` : text;
+}
+
+/** Fold a labelled shot prompt into the one line a board cell can hold. */
+export function storyboardCaption(prompt) {
+	return storyboardLine(prompt
+		.split("\n")
+		.filter((line) => line.startsWith("SHOT:") || line.startsWith("LENS:"))
+		.map((line) => line.slice(line.indexOf(":") + 1).trim())
+		.join(" · "));
+}

package/src/shell/studio-shell-context.js

@@ -13,6 +13,7 @@ import { playbackFrame, usePlaybackSnapshot } from "../motion/playback-frame-sto
 // - agentOpen/toggleAgent, preferencesOpen/setPreferencesOpen;
 // - statusText/setStatusText, previewRanges/setPreviewRanges, liveHubStatus,
 //   flySpeed (the navigation multiplier, not metres per second);
+// - castStyle ("rig" | "capsule" | "hybrid"), which orders Add > Character;
 // - previsMode ("storyboard" | "animation"), sceneRevision (bumps on every
 //   authored edit) and capturePanelThumbnail(shot) (the shot's first frame as
 //   a PNG data URL, or null) for the Board dock tab.

package/src/shortcut-friction.js

@@ -6,6 +6,7 @@
 import { track } from "./analytics.js";
 import { admit, bump } from "./analytics-friction.js";
 import { isImeComposing } from "./ime.js";
+import { hintNoSelection } from "./friction-hint.js";
 
 const IGNORED_PER_CLASS = 5, UNBOUND_PER_COMBO = 3, HELP_PER_SESSION = 3;
 let send = track, defer = (run) => setTimeout(run, 0), listening = false;
@@ -52,7 +53,7 @@ export function noteUnselectedKey(event) {
 		: event.code === "KeyD" && mod && !event.altKey && !event.shiftKey ? "duplicate"
 			: (event.key === "Delete" || event.key === "Backspace") && !mod ? "delete" : null;
 	if (!keyClass) return;
-	defer(() => { if (!event.defaultPrevented) noteShortcutIgnored(keyClass, "no_selection"); });
+	defer(() => { if (!event.defaultPrevented) { noteShortcutIgnored(keyClass, "no_selection"); hintNoSelection(); } });
 }
 
 const modOnly = (event) => (event.ctrlKey || event.metaKey) && !event.altKey && !event.shiftKey;

package/src/site/landing-analytics.js

@@ -0,0 +1,28 @@
+// Landing page (index.html) analytics: one $pageview and landing:cta_clicked.
+// Same hosted consent rules as /app/ (no cookies, DNT respected, no autocapture);
+// the lite init skips session, error, long-task and device signals.
+import { initAnalytics, track } from "../analytics.js";
+import { LANDING_CTA_TARGETS } from "../analytics-strict.js";
+
+const COPY_TARGETS = [["--via site", "copy_npx"], ["git clone", "copy_clone"], ["mcpServers", "copy_mcp"], ["cclay live", "copy_terminal"]];
+
+/** The landing:cta_clicked target for a clicked element, or null when it is not a call to action. */
+function ctaTarget(element) {
+	const copy = element.closest?.("button.copy[data-copy]");
+	if (copy) return COPY_TARGETS.find(([needle]) => copy.dataset.copy.includes(needle))?.[1] ?? null;
+	const href = element.closest?.("a[href]")?.getAttribute("href") ?? "";
+	if (href === "/app/" || href.startsWith("/app/?")) return "app";
+	if (href.includes("INSTALL_FOR_AGENTS")) return "agent_install_doc";
+	if (href.startsWith("https://github.com/NomaDamas/CozyClay")) return "github";
+	if (href.startsWith("https://discord.gg/")) return "discord";
+	if (href.startsWith("https://www.npmjs.com/package/cozyclay")) return "npm";
+	return null;
+}
+
+if (typeof document !== "undefined") {
+	void initAnalytics({ lite: true });
+	document.addEventListener("click", (event) => {
+		const target = event.target instanceof Element ? ctaTarget(event.target) : null;
+		if (target && LANDING_CTA_TARGETS.includes(target)) track("landing:cta_clicked", { target });
+	}, { capture: true });
+}

package/src/studio-actions.js

@@ -41,7 +41,8 @@ const waypointFrame = { ...frame, minimum: 1 };
 /** The tracks an IK key stores (src/motion/ik.js IK_TRACKS and FK_TRACKS). A
  * chain track keys its three bones (upper, lower, end); a joint track one. */
 export const STUDIO_IK_CHAIN_TRACKS = freezeStudioData(["leftHand", "rightHand", "leftFoot", "rightFoot"]);
-export const STUDIO_IK_JOINT_TRACKS = freezeStudioData(["hips", "spine", "chest", "neck", "head", "leftShoulder", "rightShoulder"]);
+export const STUDIO_IK_JOINT_TRACKS = freezeStudioData(["hips", "spine", "chest", "neck", "head", "leftShoulder", "rightShoulder",
+	...["left", "right"].flatMap(side => ["Thumb", "Index", "Middle", "Ring", "Pinky"].flatMap(finger => [1, 2, 3].map(joint => `${side}${finger}${joint}`)))]);
 const num = { type: "number" };
 const perBone = items => ({ type: "array", items, minItems: 1, maxItems: 3 });
 const quaternion = input({ x: num, y: num, z: num, w: num });
@@ -102,7 +103,7 @@ export const STUDIO_ACTIONS = freezeStudioData([
 	{ id: "character.clearWaypoints", label: "Clear root path", kind: "mutation", undoDomain: "cast", input: input(characterId),
 		description: "Remove every root waypoint of the character, leaving its motion unconstrained by a path." },
 	{ id: "character.setIkKey", label: "Set IK key", kind: "mutation", undoDomain: "motion", input: input({ ...characterId, frame, tracks: ikTracks }),
-		description: "Key a character's IK correction layer at frame, the same key a pose drag bakes. tracks maps a track id to its key: q is the bones' LOCAL rotations as unit quaternions {x,y,z,w}, three for a chain track (leftHand, rightHand, leftFoot, rightFoot: upper, lower and end bone) and one for a joint track (hips, spine, chest, neck, head, leftShoulder, rightShoulder); p is a joint's local position {x,y,z} (the hips' height and lean). Optional baseQ/basePos give the take's own pose the key was made over, so it applies as a delta on the take; chainP gives a chain's three local bone positions; keepTranslations keeps them over the take's; blend (frames, 1-240) is how far this key's correction eases into the take around it, 6 when omitted; pin (1-64 characters) tags the key as baked by that range pin. A key needs q or p. Each named track replaces its key at frame and starts evaluating; other tracks at that frame stay. Keyed frames are in inspect_studio { scope: \"motion\" } ikKeyFrames." },
+		description: "Key a character's IK correction layer at frame, the same key a pose drag bakes. tracks maps a track id to its key: q is the bones' LOCAL rotations as unit quaternions {x,y,z,w}, three for a chain track (leftHand, rightHand, leftFoot, rightFoot: upper, lower and end bone) and one for a joint track (hips, spine, chest, neck, head, leftShoulder, rightShoulder, and the finger bones <side><Thumb|Index|Middle|Ring|Pinky><1-3>, e.g. leftIndex2); p is a joint's local position {x,y,z} (the hips' height and lean). Optional baseQ/basePos give the take's own pose the key was made over, so it applies as a delta on the take; chainP gives a chain's three local bone positions; keepTranslations keeps them over the take's; blend (frames, 1-240) is how far this key's correction eases into the take around it, 6 when omitted; pin (1-64 characters) tags the key as baked by that range pin. A key needs q or p. Each named track replaces its key at frame and starts evaluating; other tracks at that frame stay. Keyed frames are in inspect_studio { scope: \"motion\" } ikKeyFrames." },
 	{ id: "character.removeIkKey", label: "Delete IK key", kind: "mutation", undoDomain: "motion", input: input({ ...characterId, frame }),
 		description: "Delete the character's whole IK key at frame (every track keyed there), like the Full-Body lane's delete." },
 	{ id: "character.clearIkKeys", label: "Clear IK keys", kind: "mutation", undoDomain: "motion", input: input(characterId),

package/src/studio-agent-protocol.js

@@ -4,9 +4,9 @@ import { STUDIO_ERROR_CODES, refusalCode } from "./studio-error-codes.js";
 import { EFFECT_VALUE_SCHEMA } from "./effects/effect-record.js";
 import { TEXT_VALUE_SCHEMA } from "./text/text-record.js";
 import { wrongType, unknownField, missingField, arrayRefusal, duplicateItem, stringRefusal, enumRefusal, numberRefusal, unionRefusal } from "./studio-schema-errors.js";
-// Mirrors PREVIS_MODES (project.js) and POSTURES (scenes.js). Neither is imported:
-// both pull in three.js, which the agent sidecar must not load. The protocol test pins the lists to their owners.
-const PREVIS_MODES = ["storyboard", "animation"], POSTURES = ["stand", "sit", "lie"];
+// Mirrors PREVIS_MODES and CAST_STYLES (project.js) and POSTURES (scenes.js). Neither is imported:
+// both pull in three.js, which the agent sidecar must not load. The protocol tests pin the lists to their owners.
+const PREVIS_MODES = ["storyboard", "animation"], CAST_STYLES = ["rig", "capsule", "hybrid"], POSTURES = ["stand", "sit", "lie"];
 
 // Sized for the compact index of up to 400 entities (~100 bytes each) beside
 // 24 detailed rows; a small scene stays far below it.
@@ -232,7 +232,7 @@ const jobSummary = object({ id, characterId: id, state: choices(STUDIO_VARIANTS.
 const contextSchema = object({
 	schema: literal("studio-context-v1"), host, revision,
 	units: object({ distance: literal("m"), angle: literal("deg"), up: literal("+Y"), yawZero: literal("+Z"), yawPositiveToward: literal("+X"), pivot: literal("base"), fps: literal(24), rangeEnd: literal("exclusive") }),
-	scene: object({ name, aspect: text(40), floorY: number(), frameCount: integer(), objectCount: integer(), characterCount: integer() }, { previsMode: choices(PREVIS_MODES) }),
+	scene: object({ name, aspect: text(40), floorY: number(), frameCount: integer(), objectCount: integer(), characterCount: integer() }, { previsMode: choices(PREVIS_MODES), castStyle: choices(CAST_STYLES) }),
 	selection, activeCharacterId: nullable(id), view, shot: nullable(currentShot), camera: nullable(camera),
 	entities: array(entity, 24), entityPage: object({ returned: integer(0, 24), total: integer(), truncated: bool, nextCursor: nullable(text(512)) }),
 	shots: array(shotSummary, 8), shotsTruncated: bool, assets: array(assetSummary, STUDIO_CONTEXT_LIMITS.assets),