cozyclay 3.1.1 → 3.1.3

package/src/export-workspace.js

@@ -0,0 +1,244 @@
+// Optional export folder. When the browser grants a directory, download-type
+// exports are written there; every failure path falls back to the browser's
+// normal download so an export is never lost.
+
+const DB_NAME = "cozyclay-export-workspace";
+const DB_VERSION = 1;
+const STORE = "handles";
+const FOLDER_KEY = "folder";
+const MAX_NAME = 180;
+let writeQueue = Promise.resolve();
+
+function splitExtension(name) {
+	const dot = name.lastIndexOf(".");
+	return dot > 0 ? [name.slice(0, dot), name.slice(dot)] : [name, ""];
+}
+
+/** A file name that cannot leave the chosen directory or break the file system. */
+function safeNameCharacter(character) {
+	const code = character.codePointAt(0);
+	if (code < 0x20 || code === 0x7f || '<>:"/\\|?*'.includes(character)) return "-";
+	return character;
+}
+
+export function sanitizeExportName(name) {
+	const leaf = String(name ?? "").split(/[\\/]/).pop() ?? "";
+	const cleaned = [...leaf]
+		.map(safeNameCharacter)
+		.join("")
+		.replace(/^[.\s]+/, "")
+		.replace(/[.\s]+$/, "")
+		.trim();
+	if (!cleaned) return "cozyclay-export";
+	if (cleaned.length <= MAX_NAME) return cleaned;
+	const [base, extension] = splitExtension(cleaned);
+	return `${base.slice(0, Math.max(1, MAX_NAME - extension.length))}${extension}`;
+}
+
+/** Browser download naming: shot.zip, shot (1).zip, shot (2).zip, ... */
+export function collisionName(name, index) {
+	const [base, extension] = splitExtension(String(name));
+	return `${base} (${index})${extension}`;
+}
+
+async function fileHandleForWrite(directory, name) {
+	const safe = sanitizeExportName(name);
+	for (let index = 0; index < 10_000; index += 1) {
+		const candidate = index === 0 ? safe : collisionName(safe, index);
+		try {
+			await directory.getFileHandle(candidate);
+		} catch (error) {
+			if (error?.name === "NotFoundError") {
+				return { handle: await directory.getFileHandle(candidate, { create: true }), name: candidate };
+			}
+			// A folder with the export's name is a collision, not a reason to fail.
+			if (error?.name === "TypeMismatchError") continue;
+			throw error;
+		}
+	}
+	throw new Error("No free export file name.");
+}
+
+async function writeBlobNow(directory, blob, name) {
+	const target = await fileHandleForWrite(directory, name);
+	let writable = null;
+	try {
+		writable = await target.handle.createWritable();
+		await writable.write(blob);
+		await writable.close();
+		return { name: target.name, bytes: blob.size };
+	} catch (error) {
+		try { await writable?.abort(); } catch { /* the stream may already be closed */ }
+		try { await directory.removeEntry(target.name); } catch { /* best-effort cleanup */ }
+		throw error;
+	}
+}
+
+/** Write one export without overwriting an existing file. Writes are serialized
+ * so two overlapping exports cannot both claim the same free name. */
+export function writeBlobToDirectory(directory, blob, name) {
+	const run = () => writeBlobNow(directory, blob, name);
+	const result = writeQueue.then(run, run);
+	writeQueue = result.then(() => undefined, () => undefined);
+	return result;
+}
+
+function clickDownload(source, name) {
+	if (typeof document === "undefined") throw new Error("A browser download is unavailable here.");
+		if (typeof source === "string" && !/^(?:blob:|data:|https?:\/\/|\/)/i.test(source)) {
+		throw new Error("Unsupported export source.");
+	}
+	const anchor = document.createElement("a");
+	let url = null;
+	if (typeof source === "string") {
+		anchor.href = source;
+	} else {
+		url = URL.createObjectURL(source);
+		anchor.href = url;
+	}
+	anchor.download = sanitizeExportName(name);
+	document.body.appendChild(anchor);
+	anchor.click();
+	anchor.remove();
+	if (url) setTimeout(() => URL.revokeObjectURL(url), 10_000);
+}
+
+async function toBlob(source) {
+	if (source instanceof Blob) return source;
+	if (typeof source === "string") {
+		const response = await fetch(source);
+		if (!response.ok) throw new Error(`Export source could not be read: ${response.status}`);
+		return response.blob();
+	}
+	throw new TypeError("An export must be a Blob or a URL.");
+}
+
+function openDb() {
+	return new Promise((resolve, reject) => {
+		const request = indexedDB.open(DB_NAME, DB_VERSION);
+		request.onupgradeneeded = () => request.result.createObjectStore(STORE);
+		request.onsuccess = () => resolve(request.result);
+		request.onerror = () => reject(request.error);
+		request.onblocked = () => reject(new Error("Export folder storage is blocked."));
+	});
+}
+
+async function storedHandle() {
+	try {
+		const db = await openDb();
+		try {
+			return await new Promise((resolve, reject) => {
+				const request = db.transaction(STORE, "readonly").objectStore(STORE).get(FOLDER_KEY);
+				request.onsuccess = () => resolve(request.result ?? null);
+				request.onerror = () => reject(request.error);
+			});
+		} finally {
+			db.close();
+		}
+	} catch {
+		return null;
+	}
+}
+
+async function storeHandle(handle) {
+	const db = await openDb();
+	try {
+		await new Promise((resolve, reject) => {
+			const transaction = db.transaction(STORE, "readwrite");
+			transaction.objectStore(STORE).put(handle, FOLDER_KEY);
+			transaction.oncomplete = () => resolve();
+			transaction.onerror = () => reject(transaction.error);
+		});
+	} finally {
+		db.close();
+	}
+}
+
+async function permissionOf(handle) {
+	if (!handle) return "denied";
+	if (typeof handle.queryPermission !== "function") return "granted";
+	try {
+		return await handle.queryPermission({ mode: "readwrite" });
+	} catch {
+		return "denied";
+	}
+}
+
+export function canChooseExportWorkspace() {
+	return typeof window !== "undefined" && typeof window.showDirectoryPicker === "function";
+}
+
+/** Ask for the folder; the picker grants read/write for this session. */
+export async function chooseExportWorkspace() {
+	if (!canChooseExportWorkspace()) throw new Error("This browser cannot choose an export folder.");
+	const handle = await window.showDirectoryPicker({ id: "cozyclay-export-folder", mode: "readwrite" });
+	await storeHandle(handle);
+	return handle;
+}
+
+/** The remembered folder and its current permission, if any. */
+export async function loadExportWorkspace() {
+	const handle = await storedHandle();
+	if (!handle) return null;
+	return { handle, permission: await permissionOf(handle) };
+}
+
+export async function requestExportWorkspacePermission(handle) {
+	if (await permissionOf(handle) === "granted") return "granted";
+	if (typeof handle?.requestPermission !== "function") return "granted";
+	try {
+		return await handle.requestPermission({ mode: "readwrite" });
+	} catch {
+		return "denied";
+	}
+}
+
+export async function clearExportWorkspace() {
+	let db = null;
+	try {
+		db = await openDb();
+		await new Promise((resolve, reject) => {
+			const transaction = db.transaction(STORE, "readwrite");
+			transaction.objectStore(STORE).delete(FOLDER_KEY);
+			transaction.oncomplete = () => resolve();
+			transaction.onerror = () => reject(transaction.error);
+		});
+		return true;
+	} catch {
+		return false;
+	} finally {
+		db?.close();
+	}
+}
+
+/** Save an export to the chosen folder, or hand it to the browser on any miss. */
+export async function saveExport(source, name, options = {}) {
+	const injectedDirectory = Object.prototype.hasOwnProperty.call(options, "directory");
+	const download = options.download ?? clickDownload;
+	if (!injectedDirectory && !canChooseExportWorkspace()) {
+		download(source, name);
+		return { method: "download", name: sanitizeExportName(name), reason: "unsupported" };
+	}
+	let directory = options.directory ?? null;
+	let permission = injectedDirectory ? (options.permission ?? "granted") : "denied";
+	if (!injectedDirectory) {
+		const workspace = await loadExportWorkspace();
+		directory = workspace?.handle ?? null;
+		permission = workspace?.permission ?? "denied";
+	}
+	if (!directory) {
+		download(source, name);
+		return { method: "download", name: sanitizeExportName(name), reason: "no-workspace" };
+	}
+	if (permission !== "granted") {
+		download(source, name);
+		return { method: "download", name: sanitizeExportName(name), reason: "workspace-permission" };
+	}
+	try {
+		const written = await writeBlobToDirectory(directory, await toBlob(source), name);
+		return { method: "workspace", ...written, folderName: directory.name ?? "Export folder" };
+	} catch (error) {
+		download(source, name);
+		return { method: "download", name: sanitizeExportName(name), reason: "workspace-write-failed", error };
+	}
+}

package/src/first-success-guide.jsx

@@ -5,26 +5,34 @@ const ANIMATION_STEPS = [
 	{
 		en: "Select a character in the Outliner.",
 		ko: "아웃라이너에서 캐릭터를 선택하세요.",
+		zh: "在大纲视图中选择一个角色。",
 		hintEn: "Click Character 1 (or its row) to make it active.",
 		hintKo: "캐릭터 1(또는 캐릭터 행)을 클릭하면 활성화됩니다.",
+		hintZh: "点击角色 1（或其所在行）使其成为当前角色。",
 	},
 	{
 		en: "Move it in the Scene view.",
 		ko: "장면 보기에서 캐릭터를 움직이세요.",
+		zh: "在场景视图中移动它。",
 		hintEn: "Drag the character marker on the floor to place it.",
 		hintKo: "바닥의 캐릭터 마커를 드래그해 배치하세요.",
+		hintZh: "拖动地面上的角色标记来摆放位置。",
 	},
 	{
 		en: "Ask the Agent for a motion.",
 		ko: "에이전트에게 동작을 요청하세요.",
+		zh: "让智能体生成一个动作。",
 		hintEn: "Open it with Cmd/Ctrl+B and say what the character does; the take lands on the Body lane.",
 		hintKo: "Cmd/Ctrl+B로 열고 캐릭터가 할 동작을 말하면 테이크가 바디 레인에 올라갑니다.",
+		hintZh: "按 Cmd/Ctrl+B 打开，说出角色要做的动作；动作片段会落在身体轨道上。",
 	},
 	{
 		en: "Scrub the timeline or press Space to play.",
 		ko: "타임라인을 문지르거나 Space를 눌러 재생하세요.",
+		zh: "拖动时间线或按空格播放。",
 		hintEn: "Seeing the playhead move is your first visible result.",
 		hintKo: "재생 헤드가 움직이면 첫 결과를 확인한 것입니다.",
+		hintZh: "看到播放头移动，就是你的第一个可见结果。",
 	},
 ];
 
@@ -32,26 +40,34 @@ const STORYBOARD_STEPS = [
 	{
 		en: "Open the Agent panel (Cmd/Ctrl+B).",
 		ko: "에이전트 패널을 여세요 (Cmd/Ctrl+B).",
+		zh: "打开智能体面板（Cmd/Ctrl+B）。",
 		hintEn: "The Agent panel is where you describe each panel.",
 		hintKo: "에이전트 패널에서 각 패널을 설명합니다.",
+		hintZh: "在智能体面板中逐个描述每个面板。",
 	},
 	{
 		en: "Describe one scene in a sentence.",
 		ko: "장면 하나를 한 문장으로 설명하세요.",
+		zh: "用一句话描述一个场景。",
 		hintEn: "One sentence per turn is enough for one panel.",
 		hintKo: "패널 하나에는 한 문장이면 충분합니다.",
+		hintZh: "每个面板一轮只说一句话就够了。",
 	},
 	{
 		en: "Your panel appears on the Board.",
 		ko: "패널이 보드에 나타납니다.",
+		zh: "你的面板会出现在看板上。",
 		hintEn: "Open the Board tab to see the new panel card.",
 		hintKo: "보드 탭에서 새 패널 카드를 확인하세요.",
+		hintZh: "打开看板标签页查看新的面板卡片。",
 	},
 	{
 		en: "Stylize it, or export the panel pack.",
 		ko: "스타일을 입히거나 패널 팩으로 내보내세요.",
+		zh: "对它进行风格化，或导出面板包。",
 		hintEn: "Use Stylize on the card, or export the panel pack.",
 		hintKo: "카드에서 스타일을 입히거나 패널 팩으로 내보내세요.",
+		hintZh: "在卡片上使用风格化，或导出面板包。",
 	},
 ];
 
@@ -73,7 +89,7 @@ export default function FirstSuccessGuide({ open, onDismiss, previsMode = "anima
 			<div className="v2-first-success-guide-head first-success-guide-head">
 				<div>
 					<strong id="first-success-guide-title">{ko("Your first 60 seconds", "첫 60초")}</strong>
-					<span>{complete ? ko("Core loop complete", "핵심 흐름 완료") : ko(`Step ${step + 1} of ${STEPS.length}`, `${step + 1} / ${STEPS.length} 단계`)}</span>
+					<span>{complete ? ko("Core loop complete", "핵심 흐름 완료", "核心流程完成") : ko(`Step ${step + 1} of ${STEPS.length}`, `${step + 1} / ${STEPS.length} 단계`, `第 ${step + 1} / ${STEPS.length} 步`)}</span>
 				</div>
 				<button type="button" className="v2-first-success-guide-close first-success-guide-close" onClick={onDismiss} aria-label={ko("Dismiss guide", "가이드 닫기")}>×</button>
 			</div>
@@ -91,12 +107,12 @@ export default function FirstSuccessGuide({ open, onDismiss, previsMode = "anima
 						{STEPS.map((item, index) => (
 							<li key={item.en} className={index < step ? "done" : index === step ? "current" : ""}>
 								<span className="v2-first-success-guide-step-mark first-success-guide-step-mark">{index < step ? "✓" : index + 1}</span>
-								<div><strong>{ko(item.en, item.ko)}</strong>{index === step && <span>{ko(item.hintEn, item.hintKo)}</span>}</div>
+								<div><strong>{ko(item.en, item.ko, item.zh)}</strong>{index === step && <span>{ko(item.hintEn, item.hintKo, item.hintZh)}</span>}</div>
 							</li>
 						))}
 					</ol>
 					<button type="button" className="v2-first-success-guide-next first-success-guide-next btn primary" onClick={() => setStep((value) => value + 1)}>
-						{ko(step === STEPS.length - 1 ? "Mark complete" : "I did this", step === STEPS.length - 1 ? "완료로 표시" : "했어요")}
+						{ko(step === STEPS.length - 1 ? "Mark complete" : "I did this", step === STEPS.length - 1 ? "완료로 표시" : "했어요", step === STEPS.length - 1 ? "标记完成" : "我做了这一步")}
 					</button>
 				</>
 			)}

package/src/hierarchy-panel.jsx

@@ -1,6 +1,6 @@
 import { useEffect, useMemo, useRef, useState } from "react";
 import { createPortal } from "react-dom";
-import { ko, isKo } from "./locale.js";
+import { ko } from "./locale.js";
 import { buildHierarchyNodes } from "./hierarchy-model.js";
 import { sceneObjectIdFromHierarchy } from "./scene-objects.js";
 import { CatalogueEntries, displayObjectLabel } from "./object-catalog.jsx";
@@ -62,9 +62,8 @@ export const HIERARCHY_DRAG_MIME = "application/x-cclay-hierarchy";
 const carriesHierarchyRow = (event) => !!event.dataTransfer?.types?.includes?.(HIERARCHY_DRAG_MIME);
 
 function displaySceneName(name) {
-	if (!isKo) return name;
 	const generatedName = /^SCENE\s+(\d+)$/i.exec(name);
-	return generatedName ? ko(`Scene ${generatedName[1]}`, `장면 ${generatedName[1]}`) : name;
+	return generatedName ? ko(name, `장면 ${generatedName[1]}`, `场景 ${generatedName[1]}`) : name;
 }
 
 /**
@@ -112,7 +111,7 @@ function ScenePill({ scenes, activeSceneId, onSceneSelect, onSceneCreate, onRena
 function displayHierarchyLabel(node) {
 	if (node.kind === "object") return displayObjectLabel(node.label);
 	if (node.kind === "scene") return displaySceneName(node.label);
-	return isKo ? (HIERARCHY_LABELS_KO[node.label] ?? node.label) : node.label;
+	return HIERARCHY_LABELS_KO[node.label] ? ko(node.label, HIERARCHY_LABELS_KO[node.label]) : node.label;
 }
 
 const OUTLINER_TYPES = {
@@ -466,7 +465,7 @@ function TreeRow({
 				<button
 					type="button"
 					className="hierarchy-toggle"
-					aria-label={isKo ? `${label} ${expanded ? "접기" : "펼치기"}` : `${expanded ? "Collapse" : "Expand"} ${label}`}
+					aria-label={ko(`${expanded ? "Collapse" : "Expand"} ${label}`, `${label} ${expanded ? "접기" : "펼치기"}`, `${expanded ? "折叠" : "展开"} ${label}`)}
 					onClick={() => onToggle(node.id)}
 				>
 					{expanded ? "▾" : "▸"}
@@ -486,7 +485,7 @@ function TreeRow({
 						ref={inputRef}
 						className="hierarchy-rename-input"
 						defaultValue={node.label}
-						aria-label={isKo ? `${label} 이름 바꾸기` : `Rename ${label}`}
+						aria-label={ko(`Rename ${label}`, `${label} 이름 바꾸기`, `重命名 ${label}`)}
 						autoFocus
 						onFocus={(event) => event.currentTarget.select()}
 						onKeyDown={(event) => {
@@ -523,7 +522,7 @@ function TreeRow({
 					className="hierarchy-eye"
 					data-hidden={node.hidden ? "true" : undefined}
 					aria-pressed={node.hidden === true}
-					aria-label={node.hidden ? (isKo ? `${label} 표시` : `Show ${label}`) : (isKo ? `${label} 숨기기` : `Hide ${label}`)}
+					aria-label={node.hidden ? ko(`Show ${label}`, `${label} 표시`, `显示 ${label}`) : ko(`Hide ${label}`, `${label} 숨기기`, `隐藏 ${label}`)}
 					onClick={(event) => {
 						event.preventDefault();
 						event.stopPropagation();

package/src/keyframe-pack.js

@@ -55,10 +55,14 @@ function readmeText({ shot, fps, hasLast, hasClip, ext, hasStylized }) {
 	lines.push(
 		"- camera.json: camera reference. The recorded camera move, fps, and",
 		"  frame range to reproduce the framing over time.",
-		"- blocking-depth.mp4: shot-wide normalised depth video; lighter pixels are closer.",
 		"- prompt.txt: the text prompt describing the intended action.",
 	);
 	if (hasStylized) lines.push("- stylized.png: the stylized picture of this panel; first.png is its greybox.");
+	lines.push(
+		"",
+		"Not in this pack: the shot-wide depth video (blocking-depth.mp4) is a",
+		"separate export - use Depth (mp4) in the export menu.",
+	);
 	return lines.join("\n") + "\n";
 }
 

package/src/live-control.js

@@ -11,8 +11,11 @@ const MOTION_TELEMETRY_EVENTS = new Set([
 const LIVE_TELEMETRY_EVENTS = new Set([...MOTION_TELEMETRY_EVENTS, ...EXECUTION_TELEMETRY_EVENTS.filter((event) => event.startsWith("mcp:"))]);
 
 const LIVE_CONTROL_PORT = import.meta.env?.VITE_COZYCLAY_LIVE_PORT ?? "5184";
-export const liveControlUrl = (port = LIVE_CONTROL_PORT) => `ws://127.0.0.1:${port}/live`;
-const LIVE_CONTROL_URL = liveControlUrl();
+// The npm launcher serves a prebuilt bundle, so the build-time port above is
+// fixed; it injects the hub port it actually started as __COZYCLAY_LIVE_PORT__
+// (#862). A valid runtime value wins over the build-time default.
+export const resolveLiveControlPort = (runtime = globalThis.__COZYCLAY_LIVE_PORT__) => (/^[1-9]\d{0,4}$/.test(String(runtime)) && Number(runtime) < 65536 ? String(runtime) : LIVE_CONTROL_PORT);
+export const liveControlUrl = (port = resolveLiveControlPort()) => `ws://127.0.0.1:${port}/live`;
 // Reconnect schedule: 1 s doubling to a 15 s cap with +-25 % jitter, so a hub
 // that comes back does not take every editor's retry in the same millisecond.
 const LIVE_RECONNECT_BASE_MS = 1_000;
@@ -147,10 +150,8 @@ export async function dispatchLiveFrame(data, handlers = {}) {
 	}
 }
 
-/**
- * Open the editor's one-way client connection. Failures are intentionally
- * silent: a studio remains a fully local editor when the MCP server is absent.
- */
+// Open the editor's one-way client connection. Failures are intentionally
+// silent: a studio remains a fully local editor when the MCP server is absent.
 export function createLiveControl({
 	handlers = {},
 	onWorkspace = () => {},
@@ -164,7 +165,7 @@ export function createLiveControl({
 	// Optional identity for the hub's live_status listing (scene/project names).
 	meta = null,
 	WebSocketImpl = globalThis.WebSocket,
-	url = LIVE_CONTROL_URL,
+	url = liveControlUrl(),
 	timers = defaultTimers,
 	random = Math.random,
 	// Aliased on purpose: an unqualified call to a binding named `listen` reads
@@ -377,6 +378,12 @@ export function createLiveControl({
 		setHandlers(nextHandlers) {
 			currentHandlers = nextHandlers && typeof nextHandlers === "object" ? nextHandlers : {};
 		},
+		// Opening another project renames the tab; the next hello carries the new
+		// label and an open socket tells the hub now, so status stays truthful.
+		setMeta(nextMeta) {
+			meta = nextMeta && typeof nextMeta === "object" ? nextMeta : null;
+			if (meta) send({ type: "meta", meta });
+		},
 		close() {
 			stopped = true;
 			clearRetry();

package/src/locale-zh/app.js

@@ -0,0 +1,124 @@
+// Chinese UI copy for App-level toasts, export status, error boundary and first-run guide.
+export const ZH_APP = {
+	"Load a character to pose it — Pose mode edits its rig with IK": "加载角色后才能摆姿势 — 姿势模式用 IK 编辑其骨骼",
+	"That picture format is not supported — use PNG, JPG, WebP or GIF": "不支持该图片格式 — 请使用 PNG、JPG、WebP 或 GIF",
+	"A newer edit comes after this deletion. Use Undo history instead.": "此删除之后还有更新的编辑。请改用撤销历史。",
+	"Double-click the line to add a dot": "双击线条添加一个点",
+	"That image is no longer in storage": "该图片已不在存储中",
+	"This image's usage changed, so it was not deleted. Please review it again.": "该图片的使用情况已变化，因此未删除。请重新检查。",
+	"This image's scene references changed, so it was not deleted. Please review it again.": "该图片的场景引用已变化，因此未删除。请重新检查。",
+	"That image is used by a scene and was not deleted": "该图片正被场景使用，未删除",
+	"That image is now used by a scene and was not deleted": "该图片现在正被场景使用，未删除",
+	"The scene changed while deleting, so the image was kept. Please review storage again.": "删除期间场景发生变化，图片已保留。请重新检查存储。",
+	"The live editor is disconnected. Reconnect before sending.": "实时编辑器已断开。请重新连接后再发送。",
+	"MP4 encoding is unavailable. Use a current browser with H.264 WebCodecs support (such as Chrome or Edge), enable hardware acceleration, then retry.": "MP4 编码不可用。请使用支持 H.264 WebCodecs 的最新浏览器（如 Chrome 或 Edge），开启硬件加速后重试。",
+	"Video encoding failed. Retry the same request. If resources are tight, shorten the shot range or lower output resolution before starting a new export.": "视频编码失败。请重试相同请求。若资源紧张，请缩短镜头范围或降低输出分辨率后重新导出。",
+	"Frame rendering failed. Let the scene finish loading, then retry. If it repeats, shorten the range or reduce output resolution for a new export.": "帧渲染失败。请等场景加载完成后再试。若反复出现，请缩短范围或降低输出分辨率后重新导出。",
+	"Export cancelled. No further files will be handed off.": "导出已取消。不会再交付其他文件。",
+	"Export could not finish. Retry the same request. For memory or resource problems, close other heavy tabs or use a shorter range / lower output resolution in a new export.": "导出未能完成。请重试相同请求。若为内存或资源问题，请关闭其他占用较大的标签页，或在新的导出中使用更短的范围/更低的分辨率。",
+	"An export is already running": "已有导出正在进行",
+	"Export completed. Check your export folder or browser downloads; the OS save is not confirmed.": "导出已完成。请查看导出文件夹或浏览器下载；系统保存未确认。",
+	"Export pipeline completed. The requesting tool handles the file handoff.": "导出流程已完成。文件交付由发起请求的工具处理。",
+	"Cancelling at the current work boundary…": "正在当前工作边界处取消…",
+	"Preparing": "准备中",
+	"Encoding": "编码中",
+	"Finalizing": "收尾中",
+	"Completed": "已完成",
+	"Failed": "失败",
+	"Cancelled": "已取消",
+	"Depth range sampled": "已采样深度范围",
+	"Frames submitted to encoder": "已提交给编码器的帧",
+	"Finalizing MP4. Progress is indeterminate; this stage cannot be interrupted.": "正在完成 MP4。进度不确定；此阶段无法中断。",
+	"Finishing encoder output. Progress is indeterminate.": "正在完成编码器输出。进度不确定。",
+	"Handing off existing PNGs. The file handoff cannot be cancelled.": "正在交付现有 PNG。文件交付无法取消。",
+	"Building the ZIP. Cancel takes effect after the current work unit, before the file handoff.": "正在构建 ZIP。取消将在当前工作单元结束后、文件交付前生效。",
+	"Cancel stops at the next frame boundary, before the file handoff.": "取消将在下一个帧边界停止，届时尚未交付文件。",
+	"Preparing the renderer and checking MP4 support…": "正在准备渲染器并检查 MP4 支持…",
+	"Encoding the requested frames, not yet a completed file.": "正在编码所请求的帧，尚未生成完整文件。",
+	"Retry keeps the original shot, camera, range and settings; it does not change your edits.": "重试会沿用原镜头、摄影机、范围与设置，不会改变你的编辑。",
+	"Cancel export": "取消导出",
+	"Retry same export": "重试相同导出",
+	"Add at least one Shot before exporting OTIO": "导出 OTIO 前请至少添加一个镜头",
+	"The shot renderer is not ready": "镜头渲染器尚未就绪",
+	"Add at least one Shot before exporting a keyframe pack": "导出关键帧包前请至少添加一个镜头",
+	"Depth and normal passes exported": "深度和法线通道已导出",
+	"Add at least one Shot before exporting a storyboard": "导出故事板前请至少添加一个镜头",
+	"Composing the storyboard…": "正在编排故事板…",
+	"Add a panel first — storyboard exports describe panels": "请先添加面板 — 故事板导出需要面板",
+	"ROOT PATH": "根路径",
+	"Prompt copied to clipboard": "提示词已复制到剪贴板",
+	"Frame export finished. Check your export folder or browser downloads.": "帧导出完成。请查看导出文件夹或浏览器下载。",
+	"Redone": "已重做",
+	"Undone": "已撤销",
+	"Saving…": "保存中…",
+	"Save failed": "保存失败",
+	"Not saved": "未保存",
+	"Unsaved changes": "未保存的更改",
+	"Saved": "已保存",
+	"Sign in with ChatGPT in the Agent panel to generate a blueprint.": "请在智能体面板中登录 ChatGPT 以生成蓝图。",
+	"Sign in to the Agent (⌘B) to sculpt from an image.": "请登录智能体（⌘B）以从图像雕塑。",
+	"The live editor is disconnected — reconnect to sculpt.": "实时编辑器已断开 — 请重新连接后再雕塑。",
+	"No model is available — add a provider key in the Agent panel.": "没有可用模型 — 请在智能体面板中添加服务商密钥。",
+	"New sculpt": "新建雕塑",
+	"Add a reference image in the Sculpt panel and press Start — or select a sculpt and press 5.": "在雕塑面板中添加参考图并按开始 — 或选中雕塑并按 5。",
+	"The graphics context was lost — restoring the stage. If it stays black, reload the page; your work is autosaved.": "图形上下文已丢失 — 正在恢复舞台。若持续黑屏，请刷新页面；你的工作已自动保存。",
+	"Graphics restored.": "图形已恢复。",
+	"Dot added — drag it to bend the route": "已添加点 — 拖动它使路径弯曲",
+	"3D graphics (WebGL) is turned off in this browser": "此浏览器的 3D 图形（WebGL）已关闭",
+	"Quit the browser completely (Cmd+Q) and reopen it, or turn on \"Use graphics acceleration when available\" in its settings. chrome://gpu shows the WebGL status.": "请完全退出浏览器（Cmd+Q）后重新打开，或在设置中开启“尽可能使用图形加速”。chrome://gpu 可查看 WebGL 状态。",
+	"The 3D view lost its graphics context": "3D 视图丢失了图形上下文",
+	"Waiting for the browser to restore it. If this stays, reload the studio — scenes autosave.": "正在等待浏览器恢复。若持续如此，请刷新工作室 — 场景会自动保存。",
+	"Reload": "刷新",
+	"Click or ▸ to expand · drag to move": "点击或 ▸ 展开 · 拖动移动",
+	"Click or ▾ to fold · drag to move": "点击或 ▾ 折叠 · 拖动移动",
+	"Expand inset view": "展开小窗视图",
+	"Collapse inset view": "折叠小窗视图",
+	"Shot view": "镜头视图",
+	"Top-View": "顶视图",
+	"Resize inset view": "调整小窗大小",
+	"Shot": "镜头",
+	"Look through the shot camera": "通过镜头摄影机观察",
+	"Look through the shot camera — right-drag, WASD and orbit set the recording lens (Esc returns)": "通过镜头摄影机观察 — 右键拖动、WASD 和环绕设置录制镜头（Esc 返回）",
+	"Look through": "镜头视角",
+	"Return to the editor view (Esc)": "返回编辑器视图 (Esc)",
+	"Shot camera": "镜头摄影机",
+	"Esc · exit": "Esc · 退出",
+	"SUBJECT OUT OF FRAME": "角色不在画面内",
+	"A new version of CozyClay is ready.": "CozyClay 新版本已就绪。",
+	"Reload to update": "刷新以更新",
+	"Later": "稍后",
+	"Object deleted.": "物体已删除。",
+	"Undo object deletion": "撤销物体删除",
+	"Undo": "撤销",
+	"Project access was not granted.": "未获得项目访问权限。",
+	"Restore": "恢复",
+	"Dismiss": "关闭",
+	"Image deleted. This session can undo it.": "图片已删除。本次会话内可撤销。",
+	"This account cannot generate images.": "此账号无法生成图像。",
+	"Sign in with ChatGPT in the Agent panel first.": "请先在智能体面板中登录 ChatGPT。",
+	"unknown error": "未知错误",
+	"The image route did not return a PNG.": "图像接口未返回 PNG。",
+	"Draft": "草稿",
+	"The studio hit a render error": "工作室遇到渲染错误",
+	"Scenes autosave as you work, so reloading resumes from the last saved state.": "场景会随工作自动保存，刷新后会从上次保存的状态继续。",
+	"Reload the studio": "刷新工作室",
+	"Your first 60 seconds": "你的最初 60 秒",
+	"Core loop complete": "核心流程完成",
+	"Dismiss guide": "关闭指南",
+	"You made your first panel.": "你做出了第一个面板。",
+	"You made your first shot.": "你做出了第一个镜头。",
+	"Describe, review on the Board, then stylize or export. You can close this guide and keep adding panels.": "描述、在看板上检查，然后风格化或导出。你可以关闭本指南并继续添加面板。",
+	"Select, move, ask, and play are the core CozyClay loop. You can close this guide and keep blocking.": "选择、移动、提问和播放是 CozyClay 的核心流程。你可以关闭本指南并继续摆位。",
+	"Continue editing": "继续编辑",
+	"Follow these four actions to see a result quickly.": "跟随这四个步骤，快速看到结果。",
+	"Skip guide": "跳过指南",
+	"QA clean": "QA 通过",
+	"Settings": "设置",
+	"Language and analytics": "语言与统计",
+	"Medium": "中景",
+	"Wide": "广角",
+	"Close-Up": "特写",
+	"Low Angle": "低角度",
+	"High Angle": "高角度",
+	"Saved scenes were written by a newer CozyClay — they have been left untouched and this session will not save": "已保存的场景由更新版本的 CozyClay 创建 — 已保持原样，本次会话也不会保存",
+};

package/src/locale-zh/domains.js

@@ -0,0 +1,36 @@
+// Chinese UI copy for domain refusals, notifications and project actions.
+// Keyed by the English default in ko(en, ko) so those call sites stay untouched.
+export const ZH_DOMAINS = {
+	"Character added to the scene": "角色已添加到场景",
+	"The active character's rig is not loaded": "当前角色的骨骼尚未加载",
+	"The path already fills the clip — extend the duration or clear a waypoint": "路径已填满整个片段 — 请延长时长或清除一个路径点",
+	"Root path constraints off": "根路径约束已关闭",
+	"Root path on — click the set floor in the Shot view to drop waypoints; Subject 1 is the frame 0 start": "根路径已开启 — 在镜头视图中点击布景地面放置路径点；角色 1 是第 0 帧的起点",
+	"Edited pose": "已编辑的姿势",
+	"Pose saved": "姿势已保存",
+	"Nothing to undo": "没有可撤销的操作",
+	"Nothing to redo": "没有可重做的操作",
+	"Confirm Replace existing keys before applying this pin.": "应用此固定前请确认替换现有键。",
+	"Pose mode — preview the correction, then apply it to the selected motion block": "姿势模式 — 先预览修正，再应用到所选动作片段",
+	"Pose mode — drag handles in the main view; the shot camera stays frozen in the inset": "姿势模式 — 在主视图中拖动手柄；镜头摄影机在小窗中保持冻结",
+	"Pose mode off — keyed poses keep playing": "姿势模式已关闭 — 已打关键帧的姿势会继续播放",
+	"Nothing to drop": "没有可放置的对象",
+	"Cutout": "抠图",
+	"its picture is missing from the store": "其图片不在存储中",
+	"Grouped under a new Empty": "已归入新的空物体",
+	"Could not group this object": "无法编组此物体",
+	"Missing character": "角色不存在",
+	"Character 1": "角色 1",
+	"Character 2": "角色 2",
+	"Root": "根",
+	"Could not save the project": "无法保存项目",
+	"Could not export the animation project": "无法导出动画项目",
+	"Discard unsaved changes and start a new project?": "放弃未保存的更改并新建项目？",
+	"That starter scene is not in this build": "此版本中没有该起始场景",
+	"Could not open the project": "无法打开项目",
+	"This browser would not read that file. Open it once more.": "此浏览器未能读取该文件，请再打开一次。",
+	"Project access was not granted — allow access and try again.": "未获得项目访问权限 — 请允许访问后重试。",
+	"SCENE 01": "场景 01",
+	"Draw the selected Shot's rail in the Top-View": "在顶视图中绘制所选镜头的轨道",
+	"Camera rail deleted — Follow keeps the current distance": "摄影机轨道已删除 — 跟随模式保持当前距离",
+};