cozyclay 3.1.1 → 3.1.3

package/src/shell/PreferencesDialog.jsx

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

package/src/shell/StatusBar.jsx

@@ -47,7 +47,7 @@ function ExportStatus({ status, label, recording }) {
 	const detail = [
 		message,
 		retryable && ko("Retry keeps the original shot, camera, range and settings; it does not change your edits.", "다시 시도하면 원래 샷·카메라·범위·설정을 사용하며 편집 내용은 바꾸지 않아요."),
-		handedOff > 0 && ko(`${handedOff} file(s) already handed off. Retry skips those downloads.`, `파일 ${handedOff}개는 이미 전달했어요. 다시 시도할 때 해당 다운로드는 건너뛰어요.`),
+		handedOff > 0 && ko(`${handedOff} file(s) already handed off. Retry skips those files.`, `파일 ${handedOff}개는 이미 전달했어요. 다시 시도할 때 해당 파일은 건너뛰어요.`, `已交付 ${handedOff} 个文件。重试时会跳过这些文件。`),
 		busy && stage === "mux" && ko("Finalizing MP4; this stage cannot be interrupted.", "MP4 마무리 중이에요. 이 단계는 중단할 수 없어요."),
 	].filter(Boolean).join(" ");
 	return (
@@ -86,9 +86,9 @@ function ExportStatus({ status, label, recording }) {
 function relativeTime(ms) {
 	const minutes = Math.floor(ms / 60000);
 	if (minutes < 1) return ko("just now", "방금");
-	if (minutes < 60) return ko(`${minutes} min ago`, `${minutes}분 전`);
+	if (minutes < 60) return ko(`${minutes} min ago`, `${minutes}분 전`, `${minutes} 分钟前`);
 	const hours = Math.floor(minutes / 60);
-	return ko(`${hours} h ago`, `${hours}시간 전`);
+	return ko(`${hours} h ago`, `${hours}시간 전`, `${hours} 小时前`);
 }
 
 // "Saved 2 min ago" once a save completes in this session; otherwise the
@@ -109,7 +109,7 @@ export function SaveState({ status }) {
 		return () => clearInterval(timer);
 	}, [savedAt]);
 	const text = savedAt !== null && status.state === "saved" && !status.dirty
-		? ko(`Saved ${relativeTime(now - savedAt)}`, `저장됨 · ${relativeTime(now - savedAt)}`)
+		? ko(`Saved ${relativeTime(now - savedAt)}`, `저장됨 · ${relativeTime(now - savedAt)}`, `已保存 · ${relativeTime(now - savedAt)}`)
 		: status.text;
 	return (
 		<span

package/src/shell/ViewportToolbar.jsx

@@ -177,7 +177,7 @@ export default function ViewportToolbar() {
 			aria-pressed={snapEnabled}
 			title={ko(
 				`Grid snapping ${snapEnabled ? "on" : "off"} (${SNAP_MOVE} · ${SNAP_TURN}) — click to toggle, hold Ctrl during a drag to invert`,
-				`그리드 스냅 ${snapEnabled ? "켜짐" : "꺼짐"} (${SNAP_MOVE} · ${SNAP_TURN}) — 클릭해 전환, 드래그 중 Ctrl을 누르면 반대로 작동`,
+				`그리드 스냅 ${snapEnabled ? "켜짐" : "꺼짐"} (${SNAP_MOVE} · ${SNAP_TURN}) — 클릭해 전환, 드래그 중 Ctrl을 누르면 반대로 작동`, `网格吸附 ${snapEnabled ? "开" : "关"}（${SNAP_MOVE} · ${SNAP_TURN}）— 点击切换，拖动时按住 Ctrl 反向`,
 			)}
 			onClick={() => setSnapEnabled((value) => !value)}
 		>
@@ -524,12 +524,12 @@ export default function ViewportToolbar() {
 									className={"view-menu-item vp-guide-cycle" + (guideMode === "off" ? "" : " active")}
 									aria-checked={guideMode !== "off"}
 									aria-pressed={guideMode !== "off"}
-									title={ko(GUIDE_LABELS[guideMode].en, GUIDE_LABELS[guideMode].ko) + ko(" · click to cycle", " · 클릭으로 전환")}
+									title={ko(GUIDE_LABELS[guideMode].en, GUIDE_LABELS[guideMode].ko, GUIDE_LABELS[guideMode].zh) + ko(" · click to cycle", " · 클릭으로 전환")}
 									onClick={() => runStudioAction("view.setGuideMode", { mode: nextGuideMode(guideMode) })}
 								>
 									<span className="view-menu-mark" aria-hidden="true">{guideMode !== "off" ? "✓" : ""}</span>
 									{ko("Composition guides", "구도 가이드")}
-									<small>{ko(GUIDE_LABELS[guideMode].en, GUIDE_LABELS[guideMode].ko)}</small>
+									<small>{ko(GUIDE_LABELS[guideMode].en, GUIDE_LABELS[guideMode].ko, GUIDE_LABELS[guideMode].zh)}</small>
 								</button>
 								<GhostsMenuGroup />
 								{/* Part colours repaint a BODY, so the section only exists

package/src/shell/add-camera-shot.js

@@ -6,6 +6,6 @@ export function addCameraShot({ appContext, runStudioAction, setToast }) {
 	const made = shots.read().find((row) => row.id === receipt?.affectedIds.find((id) => !before.some((old) => old.id === id)));
 	if (!made) return;
 	setToast(made.kind === "still"
-		? ko(`${made.name} added — a storyboard panel at frame ${made.startFrame}`, `${made.name} 추가됨 — ${made.startFrame}프레임의 스토리보드 패널`)
-		: ko(`${made.name} added — a camera cut at frame ${made.startFrame}`, `${made.name} 추가됨 — ${made.startFrame}프레임에서 카메라 컷`));
+		? ko(`${made.name} added — a storyboard panel at frame ${made.startFrame}`, `${made.name} 추가됨 — ${made.startFrame}프레임의 스토리보드 패널`, `${made.name} 已添加 — 第 ${made.startFrame} 帧的故事板面板`)
+		: ko(`${made.name} added — a camera cut at frame ${made.startFrame}`, `${made.name} 추가됨 — ${made.startFrame}프레임에서 카메라 컷`, `${made.name} 已添加 — 第 ${made.startFrame} 帧的摄影机剪辑`));
 }

package/src/shell/details-selection.js

@@ -9,7 +9,7 @@ import { LIGHT_KIND } from "../object-look.js";
 const characterIndexForRow = (rowId, characters) => rowId === "characterA" ? 0
 	: rowId === "characterB" ? 1
 		: characters.findIndex((entry) => `character:${entry.id}` === rowId);
-const characterTitle = (index) => ko(`Character ${index + 1}`, `인물 ${index + 1}`);
+const characterTitle = (index) => ko(`Character ${index + 1}`, `인물 ${index + 1}`, `角色 ${index + 1}`);
 
 /** The 2a selection header: the selected item's name and a "Kind · detail"
  * type line. Null when nothing that owns settings is selected. */

package/src/shell/preference-controls.jsx

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

package/src/shell/preference-pages.jsx

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

package/src/shell/preferences.css

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

package/src/shot-guides.js

@@ -9,11 +9,11 @@ export const GUIDE_STORAGE_KEY = "cozyclay.shot-guides.v1";
 export const GUIDE_MODES = Object.freeze(["off", "thirds", "golden", "center", "safe"]);
 
 export const GUIDE_LABELS = Object.freeze({
-	off: Object.freeze({ en: "Guides off", ko: "가이드 끔" }),
-	thirds: Object.freeze({ en: "Thirds", ko: "삼분할" }),
-	golden: Object.freeze({ en: "Golden ratio", ko: "골든 레이쇼" }),
-	center: Object.freeze({ en: "Center + diagonals", ko: "센터·대각선" }),
-	safe: Object.freeze({ en: "Safe areas", ko: "세이프 에어리어" }),
+	off: Object.freeze({ en: "Guides off", ko: "가이드 끔", zh: "参考线关闭" }),
+	thirds: Object.freeze({ en: "Thirds", ko: "삼분할", zh: "三分法" }),
+	golden: Object.freeze({ en: "Golden ratio", ko: "골든 레이쇼", zh: "黄金比例" }),
+	center: Object.freeze({ en: "Center + diagonals", ko: "센터·대각선", zh: "中心 + 对角线" }),
+	safe: Object.freeze({ en: "Safe areas", ko: "세이프 에어리어", zh: "安全框" }),
 });
 
 export function nextGuideMode(mode) {

package/src/shot-prompt.js

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

package/src/stage-hdr.js

@@ -23,11 +23,11 @@ const HDR_TYPES = Object.freeze(["image/vnd.radiance", "image/x-exr", "image/png
  * default camera); hdrRotation turns it about +y.
  */
 export const HDR_BUILTINS = Object.freeze([
-	{ id: "builtin:night-street", name: "Night street", ko: "밤거리", brightest: [0.72, 0.2, 0.66],
+	{ id: "builtin:night-street", name: "Night street", ko: "밤거리", zh: "夜晚街道", brightest: [0.72, 0.2, 0.66],
 		note: "dark blue night sky, a building skyline with lit windows, two warm sodium street lamps (front right and back left) pooling light on wet asphalt, a dim moon" },
-	{ id: "builtin:overcast-field", name: "Overcast field", ko: "흐린 들판", brightest: [-0.35, 0.66, -0.67],
+	{ id: "builtin:overcast-field", name: "Overcast field", ko: "흐린 들판", zh: "阴天田野", brightest: [-0.35, 0.66, -0.67],
 		note: "bright soft grey overcast sky (brighter overhead), a faint sun glow behind the clouds back left, a distant tree line and a green field" },
-	{ id: "builtin:studio-softbox", name: "Studio softbox", ko: "스튜디오 소프트박스", brightest: [-0.6, 0.4, 0.7],
+	{ id: "builtin:studio-softbox", name: "Studio softbox", ko: "스튜디오 소프트박스", zh: "影棚柔光箱", brightest: [-0.6, 0.4, 0.7],
 		note: "dark grey photo studio: a large white softbox front left, a tall strip light right, a soft overhead panel and a rim panel behind" },
 ].map((entry) => Object.freeze({ ...entry, brightest: Object.freeze(entry.brightest) })));
 const BUILTIN_IDS = new Set(HDR_BUILTINS.map((entry) => entry.id));

package/src/stage-labels-ko.js

@@ -76,7 +76,7 @@ export const CAMERA_MOVE_LABELS_KO = new Map([
 	["Dolly-zoom (vertigo)", ko("Dolly-zoom (vertigo)", "돌리 줌(버티고)")],
 	["Whip pan", ko("Whip pan", "휩 팬")],
 	["Aerial / drone", ko("Aerial / drone", "공중 / 드론")],
-	[CUSTOM_MOVE, ko(CUSTOM_MOVE, "직접 입력…")],
+	[CUSTOM_MOVE, ko(CUSTOM_MOVE, "직접 입력…", "自定义…")],
 ]);
 
 export const POSE_LABELS_KO = new Map([
@@ -120,7 +120,7 @@ export const SCENE_RENDERER_LABELS_KO = new Map([
 	["cone", ko("cone", "원뿔")],
 	["plane", ko("plane", "평면")],
 	[CUTOUT_KIND, ko("cutout", "컷아웃")],
-	[MESH_KIND, ko("Mesh", "모델")],
+	[MESH_KIND, ko("Mesh", "모델", "模型")],
 	["sculpt", ko("Sculpt", "조형")],
 ]);
 

package/src/stage-startup-defaults.js

@@ -1,5 +1,5 @@
 import * as THREE from "three";
-import { ko, isKo } from "./locale.js";
+import { ko } from "./locale.js";
 import { SHOT_ASPECT_RATIOS } from "./shot.js";
 import {
 	SCENES_QUARANTINE_KEY,
@@ -159,9 +159,9 @@ export function loadSceneStartup() {
 			// funnel's "scene created" step never fires for a brand-new room.
 			startupCreatedScene: result.status === "absent" || result.status === "corrupt",
 			toast: result.status === "corrupt"
-				? ko(`Saved scenes were unreadable — starting fresh; the old data is kept under ${SCENES_QUARANTINE_KEY}`, `저장된 장면을 읽을 수 없어 새로 시작합니다. 기존 데이터는 ${SCENES_QUARANTINE_KEY}에 보관했어요.`)
+				? ko(`Saved scenes were unreadable — starting fresh; the old data is kept under ${SCENES_QUARANTINE_KEY}`, `저장된 장면을 읽을 수 없어 새로 시작합니다. 기존 데이터는 ${SCENES_QUARANTINE_KEY}에 보관했어요.`, `无法读取已保存的场景 — 将重新开始；旧数据保留在 ${SCENES_QUARANTINE_KEY} 下。`)
 				: result.dropped > 0
-					? (isKo ? `저장된 장면 ${result.dropped}개를 복원하지 못했어요` : `${result.dropped} saved scene(s) could not be restored`)
+					? ko(`${result.dropped} saved scene(s) could not be restored`, `저장된 장면 ${result.dropped}개를 복원하지 못했어요`, `${result.dropped} 个已保存的场景无法恢复`)
 					: null,
 		};
 	} catch {