@uzuhq/code-sdk 0.8.8 → 0.8.10

package/dist/index.js

@@ -153,19 +153,19 @@ var GameClock = class {
 * IMPORTANT: `fn` の中で [GameClock.now] を呼ばないこと。差し替えた `Date.now` を
 * 実時刻として引き算してしまう。ハンドラへ渡す ctx は呼び出す前に組み立てる。
 */
-function withGameClock(time, fn) {
+const withGameClock = (time, fn) => {
 	const realNow = Date.now;
-	const RealDate = Date;
+	const realDate = Date;
 	const ms = toMs(time);
 	Date.now = () => ms;
-	globalThis.Date = new Proxy(RealDate, { construct: (target, args) => Reflect.construct(target, args.length === 0 ? [ms] : args) });
+	globalThis.Date = new Proxy(realDate, { construct: (target, args) => Reflect.construct(target, args.length === 0 ? [ms] : args) });
 	try {
 		return fn();
 	} finally {
-		globalThis.Date = RealDate;
+		globalThis.Date = realDate;
 		Date.now = realNow;
 	}
-}
+};
 /**
 * `deadlines[].at()` が返した値を締切として使えるかに正規化する。使えなければ null。
 *
@@ -180,45 +180,41 @@ function withGameClock(time, fn) {
 *
 * @param warned 既に警告した key。呼び出し側がインスタンスごとに持つ。
 */
-function resolveDeadline(at, key, warned, report) {
+const resolveDeadline = (at, key, warned, report) => {
 	if (at === null || at === void 0) return null;
 	if (typeof at === "number" && Number.isFinite(at)) return asGameTime(at);
 	if (!warned.has(key)) {
 		warned.add(key);
-		report(`deadline "${key}" の at() が締切に使えない値を返した: ${String(at)}。この締切は二度と発火しない。廃止された ctx.now を読んでいないか確認すること`);
+		report(`deadline "${key}" の at() が締切に使えない値を返した: ${typeof at === "number" ? String(at) : JSON.stringify(at)}。この締切は二度と発火しない。廃止された ctx.now を読んでいないか確認すること`);
 	}
 	return null;
-}
+};
 //#endregion
 //#region ../engine-core/src/json-patch.ts
-function unescapePointer(token) {
-	return token.replace(/~1/g, "/").replace(/~0/g, "~");
-}
-function applyPatch(doc, ops) {
+const isIndexable = (value) => typeof value === "object" && value !== null;
+const unescapePointer = (token) => token.replace(/~1/g, "/").replace(/~0/g, "~");
+/** `op.path` の親までを辿る。途中で潜れなくなったら null。 */
+const resolveParent$1 = (doc, tokens) => {
+	let target = doc;
+	for (let i = 0; i < tokens.length - 1; i++) {
+		if (!isIndexable(target)) return null;
+		target = target[tokens[i]];
+	}
+	return isIndexable(target) ? target : null;
+};
+const applyPatch = (doc, ops) => {
 	for (const op of ops) {
 		const tokens = op.path.split("/").slice(1).map(unescapePointer);
 		if (tokens.length === 0) return false;
-		if (op.op === "replace" || op.op === "add") {
-			let target = doc;
-			for (let i = 0; i < tokens.length - 1; i++) {
-				target = target?.[tokens[i]];
-				if (target === void 0 || target === null) return false;
-			}
-			const lastKey = tokens[tokens.length - 1];
-			target[lastKey] = op.value;
-		} else if (op.op === "remove") {
-			let target = doc;
-			for (let i = 0; i < tokens.length - 1; i++) {
-				target = target?.[tokens[i]];
-				if (target === void 0 || target === null) return false;
-			}
-			const lastKey = tokens[tokens.length - 1];
-			if (Array.isArray(target)) target.splice(Number(lastKey), 1);
-			else delete target[lastKey];
-		}
+		const target = resolveParent$1(doc, tokens);
+		if (target === null) return false;
+		const lastKey = tokens[tokens.length - 1];
+		if (op.op === "replace" || op.op === "add") target[lastKey] = op.value;
+		else if (Array.isArray(target)) target.splice(Number(lastKey), 1);
+		else Reflect.deleteProperty(target, lastKey);
 	}
 	return true;
-}
+};
 //#endregion
 //#region ../engine-core/src/random.ts
 var SeededRandomImpl = class SeededRandomImpl {
@@ -267,17 +263,13 @@ var SeededRandomImpl = class SeededRandomImpl {
 * serverActions: { notifyExternal: async (state) => { ... } }
 * ```
 */
-function serverOnly(handler) {
-	return Object.assign(handler, { __serverOnly: true });
-}
+const serverOnly = (handler) => Object.assign(handler, { __serverOnly: true });
 /**
 * handler が `serverOnly()` で wrap されているか判定する。
 *
 * 移行期の互換用。`serverActions` へ移行済みの logic では常に false になる。
 */
-function isServerOnlyAction(handler) {
-	return typeof handler === "function" && "__serverOnly" in handler && handler.__serverOnly === true;
-}
+const isServerOnlyAction = (handler) => typeof handler === "function" && "__serverOnly" in handler && handler.__serverOnly === true;
 //#endregion
 //#region src/server-clock.ts
 /**
@@ -310,19 +302,19 @@ let frozenAt = null;
 * 下り片道遅延を無視するので推定は実サーバー時刻より僅かに遅れる。
 * 表示用途では無視できる誤差なので、精度より単純さを取る。
 */
-function observeGameTime(t) {
+const observeGameTime = (t) => {
 	if (typeof t !== "number" || !Number.isFinite(t)) return;
 	offset = t - performance.now();
-}
+};
 /**
 * ゲーム内時刻の推定値。停止中は凍る。
 *
 * カウントダウン描画のように毎秒/毎フレーム呼ぶ用途を想定しているので、
 * state の到着とは無関係にいつでも呼べる。
 */
-function gameTime() {
+const gameTime = () => {
 	return frozenAt ?? asGameTime(performance.now() + offset);
-}
+};
 /**
 * 時計を凍らせる。
 *
@@ -330,12 +322,12 @@ function gameTime() {
 * 時点の値で明示的に止める。解除後は通常の打刻でオフセットが入れ替わるため、
 * 特別な補正は要らない。
 */
-function freezeGameTime() {
+const freezeGameTime = () => {
 	frozenAt = gameTime();
-}
-function unfreezeGameTime() {
+};
+const unfreezeGameTime = () => {
 	frozenAt = null;
-}
+};
 //#endregion
 //#region src/pause-state.ts
 /**
@@ -355,7 +347,7 @@ let paused = false;
 let pausedBy = null;
 const listeners$1 = /* @__PURE__ */ new Set();
 /** transport から呼ぶ内部関数。停止状態が変わったときだけ通知する。 */
-function setPauseState(next, by) {
+const setPauseState = (next, by) => {
 	pausedBy = next ? by : null;
 	if (next === paused) return;
 	paused = next;
@@ -366,37 +358,37 @@ function setPauseState(next, by) {
 	} catch (err) {
 		console.warn("[uzu] onPauseChange listener threw:", err);
 	}
-}
+};
 /** 緊急停止中か。 */
-function isPaused() {
+const isPaused = () => {
 	return paused;
-}
+};
 /** 停止を要求した playerId。停止していなければ null。 */
-function getPausedBy() {
+const getPausedBy = () => {
 	return pausedBy;
-}
+};
 /** 停止状態の変化を購読する。 */
-function onPauseChange(cb) {
+const onPauseChange = (cb) => {
 	listeners$1.add(cb);
-}
+};
 let requester = null;
-function setPauseRequester(fn) {
+const setPauseRequester = (fn) => {
 	requester = fn;
-}
-function requestPause() {
+};
+const requestPause = () => {
 	if (!requester) {
 		console.warn("[uzu] requestPause: サーバーへ接続していないので停止できません");
 		return;
 	}
 	requester(true);
-}
-function requestResume() {
+};
+const requestResume = () => {
 	if (!requester) {
 		console.warn("[uzu] requestResume: サーバーへ接続していないので解除できません");
 		return;
 	}
 	requester(false);
-}
+};
 //#endregion
 //#region src/reconnectable-ws.ts
 const DEFAULTS = {
@@ -447,14 +439,12 @@ var ReconnectableWebSocket = class {
 			if (this.messageBuffer.length < this.opts.maxBufferSize) this.messageBuffer.push(data);
 		}
 	}
-	addEventListener(type, handler) {
-		if (type === "message") this.messageHandlers.push(handler);
+	addEventListener(_type, handler) {
+		this.messageHandlers.push(handler);
 	}
-	removeEventListener(type, handler) {
-		if (type === "message") {
-			const index = this.messageHandlers.indexOf(handler);
-			if (index !== -1) this.messageHandlers.splice(index, 1);
-		}
+	removeEventListener(_type, handler) {
+		const index = this.messageHandlers.indexOf(handler);
+		if (index !== -1) this.messageHandlers.splice(index, 1);
 	}
 	/** バッファをクリア（権威的 state 受信時に呼ぶ） */
 	clearBuffer() {
@@ -545,7 +535,7 @@ var ReconnectableWebSocket = class {
 		return Math.max(0, exponentialDelay + jitter);
 	}
 	flushBuffer() {
-		if (!this.ws || this.ws.readyState !== WebSocket.OPEN) return;
+		if (this.ws?.readyState !== WebSocket.OPEN) return;
 		const buffer = this.messageBuffer;
 		this.messageBuffer = [];
 		for (const data of buffer) try {
@@ -600,7 +590,7 @@ var ReconnectableWebSocket = class {
 *
 * 型 mismatch (例: object → primitive) は overwrite で許可する。
 */
-function applyJsonMergePatch(target, patch) {
+const applyJsonMergePatch = (target, patch) => {
 	if (Array.isArray(target)) throw new TypeError("[uzu_dev] mergeRawState: cannot deep-merge into an array field. Use patchRawState ({ op: \"replace\", path: \"/.../<index>\" }) for element-level writes, or pass a full array to atomic-replace it.");
 	for (const key of Object.keys(patch)) {
 		const value = patch[key];
@@ -615,7 +605,7 @@ function applyJsonMergePatch(target, patch) {
 			applyJsonMergePatch(current, value);
 		} else target[key] = value;
 	}
-}
+};
 /**
 * JSON Pointer (RFC 6901) を tokens に分解する。
 * `/board/1/~04` → `['board', '1', '~4']`
@@ -626,16 +616,16 @@ function applyJsonMergePatch(target, patch) {
 *
 * 復号順は ~1 → ~0。逆順で解くと `~01` が `/` に化けるので注意。
 */
-function parseJsonPointer(pointer) {
+const parseJsonPointer = (pointer) => {
 	if (pointer === "") return [];
 	if (!pointer.startsWith("/")) throw new TypeError(`[uzu_dev] invalid JSON Pointer: ${pointer} (must start with "/")`);
 	return pointer.slice(1).split("/").map((token) => token.replace(/~1/g, "/").replace(/~0/g, "~"));
-}
+};
 /**
 * JSON Pointer の **親 container** と **末端 key** に解決する。
 * root pointer (`''`) は対応外: 呼び出し側で別途扱う。
 */
-function resolveParent(doc, tokens) {
+const resolveParent = (doc, tokens) => {
 	if (tokens.length === 0) throw new TypeError("[uzu_dev] root pointer (\"\") is not addressable by this helper");
 	let current = doc;
 	for (let i = 0; i < tokens.length - 1; i++) {
@@ -651,12 +641,12 @@ function resolveParent(doc, tokens) {
 		parent: current,
 		key: tokens[tokens.length - 1]
 	};
-}
+};
 /**
 * JSON Pointer から値を取得する。root pointer は doc 自体。
 * 存在しない path は throw する。
 */
-function getByPointer(doc, pointer) {
+const getByPointer = (doc, pointer) => {
 	const tokens = parseJsonPointer(pointer);
 	let current = doc;
 	for (const token of tokens) {
@@ -671,12 +661,12 @@ function getByPointer(doc, pointer) {
 		}
 	}
 	return current;
-}
+};
 /**
 * Array index token を numeric index に解決する。
 * `'-'` は append (RFC 6902 仕様、`add` 操作のみ許可) で `length` を返す。
 */
-function parseArrayIndex(token, length, allowAppend) {
+const parseArrayIndex = (token, length, allowAppend) => {
 	if (token === "-") {
 		if (!allowAppend) throw new TypeError("[uzu_dev] array append (\"-\") is only valid for `add` operations");
 		return length;
@@ -685,19 +675,19 @@ function parseArrayIndex(token, length, allowAppend) {
 	const idx = Number(token);
 	if (idx < 0 || idx > length) throw new RangeError(`[uzu_dev] array index ${idx} out of range (length=${length})`);
 	return idx;
-}
+};
 /**
 * 値の深い等価判定 (RFC 6902 `test` 用)。`JSON.stringify` ベース。
 * `undefined` を含む値や key 順序差まで真面目に見るほどには使わないので十分。
 */
-function deepEqual(a, b) {
+const deepEqual = (a, b) => {
 	if (a === b) return true;
 	try {
 		return JSON.stringify(a) === JSON.stringify(b);
 	} catch {
 		return false;
 	}
-}
+};
 /**
 * RFC 6902 (JSON Patch) operations を target に in-place 適用する。
 *
@@ -709,10 +699,10 @@ function deepEqual(a, b) {
 * doc のフィールドを丸ごと差し替える形で動く (= 結局 `setRawState` で十分な
 * ケースなので、わざわざ `patchRawState` で使うことはほぼない)。
 */
-function applyJsonPatch(target, ops) {
+const applyJsonPatch = (target, ops) => {
 	for (const op of ops) applyOne(target, op);
-}
-function applyOne(doc, op) {
+};
+const applyOne = (doc, op) => {
 	switch (op.op) {
 		case "add": {
 			const tokens = parseJsonPointer(op.path);
@@ -736,7 +726,7 @@ function applyOne(doc, op) {
 				parent.splice(idx, 1);
 			} else {
 				if (!(key in parent)) throw new TypeError(`[uzu_dev] cannot remove non-existent path "${op.path}"`);
-				delete parent[key];
+				Reflect.deleteProperty(parent, key);
 			}
 			return;
 		}
@@ -781,36 +771,38 @@ function applyOne(doc, op) {
 			});
 			return;
 		}
-		case "test":
-			if (!deepEqual(getByPointer(doc, op.path), op.value)) throw new Error(`[uzu_dev] test failed at "${op.path}"`);
+		case "test": {
+			const value = getByPointer(doc, op.path);
+			if (!deepEqual(value, op.value)) throw new Error(`[uzu_dev] test failed at "${op.path}"`);
 			return;
+		}
 		default: throw new TypeError(`[uzu_dev] unknown JSON Patch op: ${JSON.stringify(op)}`);
 	}
-}
-function isProperPrefixPointer(prefix, path) {
+};
+const isProperPrefixPointer = (prefix, path) => {
 	if (prefix === "") return path !== "";
 	return path === prefix || path.startsWith(`${prefix}/`);
-}
+};
 /**
 * root pointer (`''`) への add / replace 用。doc を in-place で空にして
 * value の中身を流し込む。value が object でない場合は Record の形に
 * 入らないので throw する (root を primitive / array に置換はサポート対象外、
 * setRawState を使うべき)。
 */
-function replaceRoot(doc, value) {
+const replaceRoot = (doc, value) => {
 	if (value === null || typeof value !== "object" || Array.isArray(value)) throw new TypeError("[uzu_dev] root replace requires a plain object value; use setRawState for full state replacement");
-	for (const key of Object.keys(doc)) delete doc[key];
+	for (const key of Object.keys(doc)) Reflect.deleteProperty(doc, key);
 	Object.assign(doc, value);
-}
+};
 //#endregion
 //#region src/dev-prediction-traps.ts
 /** 描画経路の警告に使う擬似 action 名。 */
 const RENDER_CONTEXT = "(render)";
 /** 実時刻。先読みでも描画でもサーバーとズレる。 */
 const WALL_CLOCK_TRAPS = [{ install: (report) => {
-	const RealDate = Date;
+	const realDate = Date;
 	const realNow = Date.now;
-	globalThis.Date = new Proxy(RealDate, { construct: (target, args) => {
+	globalThis.Date = new Proxy(realDate, { construct: (target, args) => {
 		if (args.length === 0) report("new Date()");
 		return Reflect.construct(target, args);
 	} });
@@ -820,7 +812,7 @@ const WALL_CLOCK_TRAPS = [{ install: (report) => {
 	};
 	return () => {
 		Date.now = realNow;
-		globalThis.Date = RealDate;
+		globalThis.Date = realDate;
 	};
 } }];
 /**
@@ -838,8 +830,8 @@ const WALL_CLOCK_TRAPS = [{ install: (report) => {
 * これは正しい検出になる。
 */
 const MONOTONIC_TRAPS = [{ install: (report) => {
-	const real = globalThis.performance?.now;
-	if (!real) return () => {};
+	const real = globalThis.performance.now;
+	if (typeof real !== "function") return () => {};
 	const bound = real.bind(globalThis.performance);
 	globalThis.performance.now = () => {
 		report("performance.now()");
@@ -860,8 +852,8 @@ const RANDOM_TRAPS = [{ install: (report) => {
 		Math.random = real;
 	};
 } }, { install: (report) => {
-	const real = globalThis.crypto?.randomUUID;
-	if (!real) return () => {};
+	const real = globalThis.crypto.randomUUID;
+	if (typeof real !== "function") return () => {};
 	const bound = real.bind(globalThis.crypto);
 	globalThis.crypto.randomUUID = () => {
 		report("crypto.randomUUID()");
@@ -970,7 +962,7 @@ const runInstrumented = (action, run) => {
 const getPredictionWarnings = () => warnings;
 //#endregion
 //#region src/dev-hooks.ts
-function createDevHooks(ctx) {
+const createDevHooks = (ctx) => {
 	const getRawState = () => ctx.getRawState ? ctx.getRawState() : null;
 	const waitForSnapshot = (predicate, options) => {
 		const timeoutMs = options?.timeoutMs ?? 1e4;
@@ -981,7 +973,7 @@ function createDevHooks(ctx) {
 				try {
 					ok = predicate(current);
 				} catch (err) {
-					reject(err);
+					reject(err instanceof Error ? err : new Error(String(err)));
 					return;
 				}
 				if (ok) {
@@ -1000,7 +992,7 @@ function createDevHooks(ctx) {
 				} catch (err) {
 					clearTimeout(timer);
 					unsubscribe();
-					reject(err);
+					reject(err instanceof Error ? err : new Error(String(err)));
 					return;
 				}
 				if (ok) {
@@ -1068,10 +1060,10 @@ function createDevHooks(ctx) {
 		hooks.subscribeEvents = (cb) => subscribeEvents(cb);
 	}
 	return hooks;
-}
-function attachDevHooks(ctx) {
+};
+const attachDevHooks = (ctx) => {
 	window.__uzu_dev = createDevHooks(ctx);
-}
+};
 //#endregion
 //#region src/insets.ts
 const SIDES = [
@@ -1118,7 +1110,7 @@ const toFinite = (value) => {
 * `env()` は JS から直接読めず、CSS 変数へ入れても `getComputedStyle` は代入前の
 * トークン列を返す。padding に置いて算出値を読むのが唯一の手。
 */
-function measureEnvInsets() {
+const measureEnvInsets = () => {
 	if (typeof document === "undefined") return zero();
 	if (!envProbe?.isConnected) {
 		const el = document.createElement("div");
@@ -1138,18 +1130,18 @@ function measureEnvInsets() {
 		bottom: toFinite(style.paddingBottom) ?? 0,
 		left: toFinite(style.paddingLeft) ?? 0
 	};
-}
-function setVar(name, value) {
+};
+const setVar = (name, value) => {
 	if (typeof document === "undefined") return;
 	document.documentElement.style.setProperty(name, value);
-}
-function writeSafeAreaVars() {
+};
+const writeSafeAreaVars = () => {
 	for (const side of SIDES) setVar(`--uzu-safe-area-inset-${side}`, hostSafeArea ? `${hostSafeArea[side]}px` : envExpr(side));
-}
-function writeHudVars() {
+};
+const writeHudVars = () => {
 	setVar("--uzu-hud-inset-x", `${hud.x}px`);
 	setVar("--uzu-hud-inset-y", `${hud.y}px`);
-}
+};
 /**
 * 合成済みの層。下 2 層を参照する式で書くので、safe area が実数でも `env()` でも
 * 同じ 1 本で成立する。
@@ -1158,13 +1150,13 @@ function writeHudVars() {
 * HUD の高さ分だけ空ければその下は全域が安全で、`left` にも足すと L 字全体を避ける
 * ことになり過剰に削れる。精密に避けたいシナリオは下 2 層を自分で合成する。
 */
-function writeContentVars() {
+const writeContentVars = () => {
 	setVar("--uzu-content-inset-top", "calc(var(--uzu-safe-area-inset-top, 0px) + var(--uzu-hud-inset-y, 0px))");
 	setVar("--uzu-content-inset-right", "var(--uzu-safe-area-inset-right, 0px)");
 	setVar("--uzu-content-inset-bottom", "var(--uzu-safe-area-inset-bottom, 0px)");
 	setVar("--uzu-content-inset-left", "var(--uzu-safe-area-inset-left, 0px)");
-}
-function compute() {
+};
+const compute = () => {
 	const safeArea = hostSafeArea ?? measureEnvInsets();
 	return {
 		safeArea,
@@ -1176,11 +1168,11 @@ function compute() {
 		},
 		hud: { ...hud }
 	};
-}
+};
 const sameInsets = (a, b) => SIDES.every((side) => a[side] === b[side]);
 const same = (a, b) => sameInsets(a.safeArea, b.safeArea) && a.hud.x === b.hud.x && a.hud.y === b.hud.y;
 /** 値が動いたときだけ購読者へ流す。 */
-function refresh() {
+const refresh = () => {
 	const next = compute();
 	if (current && same(current, next)) return;
 	current = next;
@@ -1189,7 +1181,7 @@ function refresh() {
 	} catch (err) {
 		console.warn("[UZU SDK] onInsetsChange listener threw:", err);
 	}
-}
+};
 /**
 * HUD 回避領域の右下座標を算出する。
 * クエリパラメータに uzuHudInsetX/Y がない場合のフォールバック値として使用。
@@ -1201,7 +1193,7 @@ function refresh() {
 * - players が取得できる場合: 2人以上→アクション数2、1人→アクション数0
 * - players が取得できない場合: アクション数2 (安全側に倒す)
 */
-function fallbackHudInsets(params) {
+const fallbackHudInsets = (params) => {
 	let actionCount = 2;
 	const json = params.get("players");
 	if (json) try {
@@ -1213,8 +1205,8 @@ function fallbackHudInsets(params) {
 		x,
 		y: 52
 	};
-}
-function readSafeAreaParams(params) {
+};
+const readSafeAreaParams = (params) => {
 	const values = zero();
 	let supplied = false;
 	for (const side of SIDES) {
@@ -1226,7 +1218,7 @@ function readSafeAreaParams(params) {
 		supplied = true;
 	}
 	return supplied ? values : null;
-}
+};
 /**
 * URL パラメータから初期値を確定させる。`init()` が 1 度だけ呼ぶ。
 *
@@ -1236,7 +1228,7 @@ function readSafeAreaParams(params) {
 *
 * [discord/embedded-app-sdk#304]: https://github.com/discord/embedded-app-sdk/issues/304
 */
-function applyInsets(params) {
+const applyInsets = (params) => {
 	const hudX = toFinite(params.get("uzuHudInsetX"));
 	const hudY = toFinite(params.get("uzuHudInsetY"));
 	const fallback = fallbackHudInsets(params);
@@ -1253,12 +1245,12 @@ function applyInsets(params) {
 		window.addEventListener("resize", refresh);
 		window.addEventListener("orientationchange", refresh);
 	}
-}
+};
 /**
 * ホストからの `insetsChanged` を反映する。回転 / PiP で値が変わったときに届く。
 * 内部用 (bridge の受信口から呼ばれる)。
 */
-function handleInsetsChanged(payload) {
+const handleInsetsChanged = (payload) => {
 	const safeArea = payload.safeArea;
 	if (safeArea) {
 		const next = zero();
@@ -1275,17 +1267,17 @@ function handleInsetsChanged(payload) {
 		writeHudVars();
 	}
 	refresh();
-}
+};
 /**
 * 現在の inset を返す。
 *
 * canvas / WebGL は CSS 変数で避けられないので、そこから読む口。値は初回ペイント前に
 * 確定しているので、setup の中で読んでよい。
 */
-function getInsets() {
+const getInsets = () => {
 	if (!current) refresh();
 	return current ?? compute();
-}
+};
 /**
 * inset の変化を購読する。戻り値を呼ぶと解除できる。
 *
@@ -1294,12 +1286,12 @@ function getInsets() {
 *
 * 登録時に即時呼び出しはしない。初期値は [getInsets] で読むこと。
 */
-function onInsetsChange(cb) {
+const onInsetsChange = (cb) => {
 	listeners.add(cb);
 	return () => {
 		listeners.delete(cb);
 	};
-}
+};
 //#endregion
 //#region src/scenario-callback.ts
 /**
@@ -1331,44 +1323,97 @@ const callScenario = (label, fn) => {
 	}
 };
 //#endregion
-//#region src/run/optimistic-action-client.ts
-function createOptimisticActionClient(config) {
-	const { logic, playerId, events, sendAction } = config;
-	/** 呼び出し箇所ごとに守らず、シナリオの描画へ出る唯一の口をここで塞ぐ。 */
-	const onState = (state, id) => {
-		callScenario("描画 (onState)", () => config.onState(state, id));
+//#region src/run/local-server-action.ts
+const runLocalServerAction = (config) => {
+	const { logic, inputs, events } = config;
+	const onState = (next, id) => {
+		observeGameTime(gameTime());
+		callScenario("描画 (onState)", () => config.onState(next, id, "player"));
+	};
+	const tickRate = logic.tickRate ?? 0;
+	const clock = new GameClock();
+	const gameTime = () => clock.now();
+	const frozen = () => clock.frozen;
+	/** ハンドラへ渡す ctx の時刻部分。1 回の呼び出し内で値が動かないよう束ねる。 */
+	const timeCtx = (t) => ({
+		time: t,
+		after: (d) => plus(t, d)
+	});
+	/** at() が壊れた値を返したと既に記録した締切。ログを 1 回に絞るため。 */
+	const warnedDeadlines = /* @__PURE__ */ new Set();
+	const random = new SeededRandomImpl(Math.floor(Math.random() * 4294967295));
+	const players = Array.from({ length: config.playerCount }, (_, i) => ({
+		id: `local_${i}`,
+		nickname: `Player ${i + 1}`,
+		iconUrl: DEFAULT_ICON_URLS[i % DEFAULT_ICON_URLS.length]
+	}));
+	const myId = players[0].id;
+	let wakeupTimer = null;
+	let wakeupAt = null;
+	const nextDeadline = () => {
+		if (!logic.deadlines) return null;
+		let earliest = null;
+		for (const [key, deadline] of Object.entries(logic.deadlines)) {
+			let raw;
+			try {
+				raw = deadline.at({ state });
+			} catch (err) {
+				console.error(`[Deadline] ❌ ${key}.at() で例外`, err);
+				continue;
+			}
+			const at = resolveDeadline(raw, key, warnedDeadlines, (m) => console.error(`[Deadline] ❌ ${m}`));
+			if (at === null) continue;
+			if (earliest === null || at < earliest) earliest = at;
+		}
+		return earliest;
+	};
+	const fireDue = () => {
+		wakeupTimer = null;
+		wakeupAt = null;
+		if (!logic.deadlines || frozen()) return;
+		const time = gameTime();
+		const evts = [];
+		const firedKeys = [];
+		for (const [key, deadline] of Object.entries(logic.deadlines)) {
+			const pending = [];
+			let snapshot = null;
+			try {
+				const at = resolveDeadline(deadline.at({ state }), key, warnedDeadlines, (m) => console.error(`[Deadline] ❌ ${m}`));
+				if (at === null || at > time) continue;
+				snapshot = structuredClone(state);
+				withGameClock(time, () => deadline.handler({
+					state,
+					ctx: {
+						...timeCtx(time),
+						random,
+						emit: (name, data) => pending.push({
+							name,
+							data: data ?? {}
+						})
+					}
+				}));
+				evts.push(...pending);
+				firedKeys.push(key);
+			} catch (err) {
+				if (snapshot !== null) state = snapshot;
+				console.error(`[Deadline] ❌ ${key} で例外`, err);
+			}
+		}
+		syncWakeup();
+		if (firedKeys.length === 0) return;
+		console.log(`[Deadline] ⏰ ${firedKeys.length} 件発火: ${firedKeys.join(", ")}`);
+		dispatchEvents(evts);
+		onState(state, myId);
+	};
+	const syncWakeup = () => {
+		const next = frozen() ? null : nextDeadline();
+		if (next === wakeupAt) return;
+		if (wakeupTimer) clearTimeout(wakeupTimer);
+		wakeupTimer = null;
+		wakeupAt = next;
+		if (next === null) return;
+		wakeupTimer = setTimeout(fireDue, Math.max(0, clock.toWall(next) - Date.now()));
 	};
-	/** サーバー確定 state (楽観的更新のベース) */
-	let confirmedState = null;
-	/** 表示用 state (pending actions 適用済み) */
-	let displayState = null;
-	/** クライアント側の action 通番 */
-	let actionSeq = 0;
-	/**
-	* 送信済みだがサーバー未確認の action キュー。
-	* `time` は送信時に推定した値。再適用でも同じ値を使う (取り直すと表示がガタつく)。
-	*/
-	const pendingActions = [];
-	/**
-	* 先読みで実行済みの events。
-	*
-	* IMPORTANT: pending action ごとではなくクライアント単位で持つ。二重実行は「自分の
-	* action の ack」だけでなく「他プレイヤーの action のブロードキャスト」でも起きるため
-	* (A と B が同時に同じ行送りを撃つと、B は自分の先読みで実行済みなのに A 由来の
-	* 配信でもう一度実行してしまう)。どの配信が来ても、まずここと突き合わせる。
-	*
-	* 記録には「どの action の先読みで実行したか」(seq) を持たせる。その action が ack
-	* された時点で引き当てられていない記録は「予測したが実際には起きなかった出来事」なので
-	* 捨てる。seq を持たせずに「pending が空になったら捨てる」だけにすると、別の action が
-	* 未確定な間ずっと外れた記録が生き残り、その後に本当に起きた同名イベントを 1 回
-	* 握り潰してしまう。
-	*
-	* サーバーは 1 本の接続へ処理順どおりに送るので、他プレイヤーの配信は自分の ack より
-	* 必ず先に届く = 引き当てのチャンスは記録が生きている間に必ず来る。
-	*/
-	let firedPredictions = [];
-	/** 再適用時はイベントを発火しない (送信時に既に発火済み) */
-	const noopEmit = () => {};
 	const dispatchEvents = (evts) => {
 		for (const e of evts) {
 			const handler = events?.[e.name]?.handler;
@@ -1376,63 +1421,250 @@ function createOptimisticActionClient(config) {
 			callScenario(`event ハンドラ "${e.name}"`, () => handler(e.data));
 		}
 	};
-	/** events の同一性キー。name と data が一致すれば「同じ出来事」とみなす。 */
-	const eventKey = (e) => `${e.name}\u0000${JSON.stringify(e.data ?? {})}`;
-	/**
-	* サーバーの events から、先読みで実行済みのものを差し引く (多重集合の差)。
-	*
-	* - 予測が当たった  → 差が空。二重に実行しない
-	* - 予測が外れた    → サーバー側の正しい event が残り、確定として実行される
-	* - 先読みで実行していない (predict: false / serverActions 由来 / 他プレイヤー由来)
-	*   → そのまま残って実行される
-	*/
-	const subtractFired = (serverEvts) => {
-		if (firedPredictions.length === 0) return serverEvts;
-		const out = [];
-		for (const e of serverEvts) {
-			const k = eventKey(e);
-			const idx = firedPredictions.findIndex((f) => eventKey(f) === k);
-			if (idx >= 0) firedPredictions.splice(idx, 1);
-			else out.push(e);
+	clock.restart();
+	const setupTime = gameTime();
+	const setupArgs = {
+		players,
+		ctx: {
+			random,
+			...timeCtx(setupTime)
 		}
-		return out;
 	};
-	/**
-	* confirmedState をベースに pending actions を再適用して displayState を更新する。
-	* 再適用失敗した action はキューから除去する。
-	*/
-	const reapplyPendingActions = () => {
-		if (confirmedState === null) return;
-		displayState = structuredClone(confirmedState);
-		let i = 0;
-		while (i < pendingActions.length) {
-			const { action, payload, time } = pendingActions[i];
-			const handler = logic.actions[action];
-			if (!handler || isServerOnlyAction(handler)) {
-				pendingActions.splice(i, 1);
-				continue;
-			}
-			const base = structuredClone(displayState);
+	let state = withGameClock(setupTime, () => logic.setup(setupArgs));
+	let tick = 0;
+	const playerInputs = {};
+	const dispatchAction = (type, payload) => {
+		if (frozen()) {
+			console.warn(`[SDK LocalServerAction] 緊急停止中は action を実行しません (action="${type}")`);
+			return;
+		}
+		const plain = type in logic.actions ? logic.actions[type] : void 0;
+		const legacyServerOnly = isServerOnlyAction(plain) ? plain : null;
+		const server = logic.serverActions?.[type] ?? legacyServerOnly;
+		if (!plain && !server) return;
+		const plainEvents = [];
+		const serverEvents = [];
+		const plainEmit = (name, data) => plainEvents.push({
+			name,
+			data: data ?? {}
+		});
+		const serverEmit = (name, data) => serverEvents.push({
+			name,
+			data: data ?? {}
+		});
+		const time = gameTime();
+		if (plain && !legacyServerOnly) {
 			try {
-				runPredicted(action, () => handler({
-					state: displayState,
-					payload,
-					playerId,
+				withGameClock(time, () => plain({
+					state,
+					payload: payload ?? {},
+					playerId: myId,
 					ctx: {
-						time,
-						after: (d) => plus(time, d),
-						emit: noopEmit
+						...timeCtx(time),
+						emit: plainEmit
 					}
 				}));
-				i++;
-			} catch {
-				displayState = base;
-				pendingActions.splice(i, 1);
+			} catch (err) {
+				console.warn("[SDK LocalServerAction] Action error:", err);
+				return;
 			}
+			dispatchEvents(plainEvents);
+			syncWakeup();
+			onState(state, myId);
 		}
-		onState(displayState, playerId);
-	};
-	/**
+		if (!server) return;
+		(async () => {
+			try {
+				await server({
+					state,
+					payload: payload ?? {},
+					playerId: myId,
+					ctx: {
+						tick,
+						random,
+						...timeCtx(time),
+						emit: serverEmit
+					}
+				});
+			} catch (err) {
+				console.warn("[SDK LocalServerAction] Action error:", err);
+				return;
+			}
+			dispatchEvents(serverEvents);
+			syncWakeup();
+			onState(state, myId);
+		})();
+	};
+	/**
+	* ソロの停止 / 解除。サーバーが居ないので自分の時計を直接触る。
+	*
+	* `__uzu_dev.pauseTick()` とは別物。あちらは tick を止めるだけの開発者ツールで、
+	* ゲーム内時計も action ゲートも持たない。流用しない。
+	*/
+	const applyPause = (paused) => {
+		if (!(paused ? clock.freeze("emergency-stop") : clock.unfreeze("emergency-stop"))) return;
+		observeGameTime(gameTime());
+		setPauseState(paused, paused ? myId : null);
+		observeGameTime(gameTime());
+		syncWakeup();
+	};
+	setPauseRequester(applyPause);
+	inputs(dispatchAction);
+	syncWakeup();
+	onState(state, myId);
+	if (tickRate > 0) setInterval(() => {
+		if (frozen()) return;
+		const tickEvents = [];
+		const tickEmit = (name, data) => tickEvents.push({
+			name,
+			data: data ?? {}
+		});
+		const time = gameTime();
+		try {
+			withGameClock(time, () => logic.update({
+				state,
+				ctx: {
+					random,
+					tick,
+					...timeCtx(time),
+					emit: tickEmit,
+					playerInputs
+				}
+			}));
+		} catch (err) {
+			console.error(`[SDK LocalServerAction] tick error at tick=${tick}:`, err);
+			tick++;
+			return;
+		}
+		tick++;
+		dispatchEvents(tickEvents);
+		syncWakeup();
+		onState(state, myId);
+	}, 1e3 / tickRate);
+	return {
+		getRawState: () => state,
+		setRawState: async (next) => {
+			state = next;
+			syncWakeup();
+			onState(state, myId);
+		},
+		mergeRawState: async (patch) => {
+			applyJsonMergePatch(state, patch);
+			onState(state, myId);
+		},
+		patchRawState: async (ops) => {
+			applyJsonPatch(state, ops);
+			onState(state, myId);
+		},
+		sendAction: dispatchAction
+	};
+};
+//#endregion
+//#region src/run/optimistic-action-client.ts
+const createOptimisticActionClient = (config) => {
+	const { logic, playerId, events, sendAction } = config;
+	/** Record の添字は型の上では常に値を返すので、存在確認を通してから引く。 */
+	const actionHandler = (type) => type in logic.actions ? logic.actions[type] : void 0;
+	/** 呼び出し箇所ごとに守らず、シナリオの描画へ出る唯一の口をここで塞ぐ。 */
+	const onState = (state, id) => {
+		callScenario("描画 (onState)", () => config.onState(state, id));
+	};
+	/** サーバー確定 state (楽観的更新のベース) */
+	let confirmedState = null;
+	/** 表示用 state (pending actions 適用済み) */
+	let displayState = null;
+	/** クライアント側の action 通番 */
+	let actionSeq = 0;
+	/**
+	* 送信済みだがサーバー未確認の action キュー。
+	* `time` は送信時に推定した値。再適用でも同じ値を使う (取り直すと表示がガタつく)。
+	*/
+	const pendingActions = [];
+	/**
+	* 先読みで実行済みの events。
+	*
+	* IMPORTANT: pending action ごとではなくクライアント単位で持つ。二重実行は「自分の
+	* action の ack」だけでなく「他プレイヤーの action のブロードキャスト」でも起きるため
+	* (A と B が同時に同じ行送りを撃つと、B は自分の先読みで実行済みなのに A 由来の
+	* 配信でもう一度実行してしまう)。どの配信が来ても、まずここと突き合わせる。
+	*
+	* 記録には「どの action の先読みで実行したか」(seq) を持たせる。その action が ack
+	* された時点で引き当てられていない記録は「予測したが実際には起きなかった出来事」なので
+	* 捨てる。seq を持たせずに「pending が空になったら捨てる」だけにすると、別の action が
+	* 未確定な間ずっと外れた記録が生き残り、その後に本当に起きた同名イベントを 1 回
+	* 握り潰してしまう。
+	*
+	* サーバーは 1 本の接続へ処理順どおりに送るので、他プレイヤーの配信は自分の ack より
+	* 必ず先に届く = 引き当てのチャンスは記録が生きている間に必ず来る。
+	*/
+	let firedPredictions = [];
+	/** 再適用時はイベントを発火しない (送信時に既に発火済み) */
+	const noopEmit = () => {};
+	const dispatchEvents = (evts) => {
+		for (const e of evts) {
+			const handler = events?.[e.name]?.handler;
+			if (!handler) continue;
+			callScenario(`event ハンドラ "${e.name}"`, () => handler(e.data));
+		}
+	};
+	/** events の同一性キー。name と data が一致すれば「同じ出来事」とみなす。 */
+	const eventKey = (e) => `${e.name}\u0000${JSON.stringify(e.data)}`;
+	/**
+	* サーバーの events から、先読みで実行済みのものを差し引く (多重集合の差)。
+	*
+	* - 予測が当たった  → 差が空。二重に実行しない
+	* - 予測が外れた    → サーバー側の正しい event が残り、確定として実行される
+	* - 先読みで実行していない (predict: false / serverActions 由来 / 他プレイヤー由来)
+	*   → そのまま残って実行される
+	*/
+	const subtractFired = (serverEvts) => {
+		if (firedPredictions.length === 0) return serverEvts;
+		const out = [];
+		for (const e of serverEvts) {
+			const k = eventKey(e);
+			const idx = firedPredictions.findIndex((f) => eventKey(f) === k);
+			if (idx >= 0) firedPredictions.splice(idx, 1);
+			else out.push(e);
+		}
+		return out;
+	};
+	/**
+	* confirmedState をベースに pending actions を再適用して displayState を更新する。
+	* 再適用失敗した action はキューから除去する。
+	*/
+	const reapplyPendingActions = () => {
+		if (confirmedState === null) return;
+		let display = structuredClone(confirmedState);
+		let i = 0;
+		while (i < pendingActions.length) {
+			const { action, payload, time } = pendingActions[i];
+			const handler = actionHandler(action);
+			if (!handler || isServerOnlyAction(handler)) {
+				pendingActions.splice(i, 1);
+				continue;
+			}
+			const base = structuredClone(display);
+			try {
+				runPredicted(action, () => handler({
+					state: display,
+					payload,
+					playerId,
+					ctx: {
+						time,
+						after: (d) => plus(time, d),
+						emit: noopEmit
+					}
+				}));
+				i++;
+			} catch {
+				display = base;
+				pendingActions.splice(i, 1);
+			}
+		}
+		displayState = display;
+		onState(display, playerId);
+	};
+	/**
 	* サーバーからの配信を処理する。
 	*
 	* 送信元が誰であれ、まず先読みの実行記録と突き合わせる。自分の ack だけを見ていると、
@@ -1453,7 +1685,8 @@ function createOptimisticActionClient(config) {
 			}
 			actionSeq++;
 			const seq = actionSeq;
-			const handler = logic.actions[type];
+			const actionPayload = payload ?? {};
+			const handler = actionHandler(type);
 			if (!handler && !logic.serverActions?.[type]) console.error(`[uzu] unknown action: "${type}". logic.actions / logic.serverActions のどちらにも登録されていません。`);
 			const target = displayState;
 			const time = gameTime();
@@ -1471,7 +1704,7 @@ function createOptimisticActionClient(config) {
 			if (handler && !isServerOnlyAction(handler) && target !== null) try {
 				runPredicted(type, () => handler({
 					state: target,
-					payload: payload ?? {},
+					payload: actionPayload,
 					playerId,
 					ctx: {
 						time,
@@ -1482,7 +1715,7 @@ function createOptimisticActionClient(config) {
 				pendingActions.push({
 					seq,
 					action: type,
-					payload: payload ?? {},
+					payload: actionPayload,
 					time
 				});
 				onState(target, playerId);
@@ -1491,7 +1724,7 @@ function createOptimisticActionClient(config) {
 			}
 			sendAction({
 				action: type,
-				payload: payload ?? {},
+				payload: actionPayload,
 				seq
 			});
 		},
@@ -1528,10 +1761,10 @@ function createOptimisticActionClient(config) {
 			onState(displayState, playerId);
 		}
 	};
-}
+};
 //#endregion
 //#region src/run/server-action.ts
-function runOnlineServerAction(config, gameEndpoint, roomId, seatId, players, seatKind) {
+const runOnlineServerAction = (config, gameEndpoint, roomId, seatId, players, seatKind) => {
 	const toWire = (p) => ({
 		id: p.id,
 		name: p.nickname,
@@ -1598,12 +1831,12 @@ function runOnlineServerAction(config, gameEndpoint, roomId, seatId, players, se
 		client.observeGameTime(parsed.gameTime);
 		if (msgType === "__pause_state") {
 			const frozen = parsed.frozen === true;
-			console.log(`[SDK ServerAction] ${frozen ? "⏸" : "▶️"} pause_state frozen=${frozen}`);
+			console.log(`[SDK ServerAction] ${frozen ? "⏸" : "▶️"} pause_state frozen=${String(frozen)}`);
 			setPauseState(frozen, parsed.by ?? null);
 			return;
 		}
 		if (msgType === "__room_init") {
-			console.log(`[SDK ServerAction] ✅ Room init myId=${parsed.myId}`);
+			console.log(`[SDK ServerAction] ✅ Room init myId=${String(parsed.myId)}`);
 			return;
 		}
 		if (msgType === "__game_start") {
@@ -1671,7 +1904,7 @@ function runOnlineServerAction(config, gameEndpoint, roomId, seatId, players, se
 		}
 		if (msgType === "__action_error") {
 			const errorSeq = parsed.seq;
-			console.warn(`[SDK ServerAction] ⚠️ Action error: ${parsed.error} (seq=${errorSeq})`);
+			console.warn(`[SDK ServerAction] ⚠️ Action error: ${String(parsed.error)} (seq=${errorSeq ?? "-"})`);
 			if (errorSeq !== void 0) client.rollback(errorSeq);
 			return;
 		}
@@ -1699,244 +1932,7 @@ function runOnlineServerAction(config, gameEndpoint, roomId, seatId, players, se
 			console.error(`[SDK ServerAction] ❌ message 処理で例外 type=${String(msg.type)}`, err);
 		}
 	});
-}
-//#endregion
-//#region src/run/local-server-action.ts
-function runLocalServerAction(config) {
-	const { logic, inputs, events } = config;
-	const onState = (next, id) => {
-		observeGameTime(gameTime());
-		callScenario("描画 (onState)", () => config.onState(next, id, "player"));
-	};
-	const tickRate = logic.tickRate ?? 0;
-	const clock = new GameClock();
-	const gameTime = () => clock.now();
-	const frozen = () => clock.frozen;
-	/** ハンドラへ渡す ctx の時刻部分。1 回の呼び出し内で値が動かないよう束ねる。 */
-	const timeCtx = (t) => ({
-		time: t,
-		after: (d) => plus(t, d)
-	});
-	/** at() が壊れた値を返したと既に記録した締切。ログを 1 回に絞るため。 */
-	const warnedDeadlines = /* @__PURE__ */ new Set();
-	const random = new SeededRandomImpl(Math.floor(Math.random() * 4294967295));
-	const players = Array.from({ length: config.playerCount }, (_, i) => ({
-		id: `local_${i}`,
-		nickname: `Player ${i + 1}`,
-		iconUrl: DEFAULT_ICON_URLS[i % DEFAULT_ICON_URLS.length]
-	}));
-	const myId = players[0].id;
-	let wakeupTimer = null;
-	let wakeupAt = null;
-	const nextDeadline = () => {
-		if (!logic.deadlines) return null;
-		let earliest = null;
-		for (const [key, deadline] of Object.entries(logic.deadlines)) {
-			let raw;
-			try {
-				raw = deadline.at({ state });
-			} catch (err) {
-				console.error(`[Deadline] ❌ ${key}.at() で例外`, err);
-				continue;
-			}
-			const at = resolveDeadline(raw, key, warnedDeadlines, (m) => console.error(`[Deadline] ❌ ${m}`));
-			if (at === null) continue;
-			if (earliest === null || at < earliest) earliest = at;
-		}
-		return earliest;
-	};
-	const fireDue = () => {
-		wakeupTimer = null;
-		wakeupAt = null;
-		if (!logic.deadlines || frozen()) return;
-		const time = gameTime();
-		const evts = [];
-		const firedKeys = [];
-		for (const [key, deadline] of Object.entries(logic.deadlines)) {
-			const pending = [];
-			let snapshot = null;
-			try {
-				const at = resolveDeadline(deadline.at({ state }), key, warnedDeadlines, (m) => console.error(`[Deadline] ❌ ${m}`));
-				if (at === null || at > time) continue;
-				snapshot = structuredClone(state);
-				withGameClock(time, () => deadline.handler({
-					state,
-					ctx: {
-						...timeCtx(time),
-						random,
-						emit: (name, data) => pending.push({
-							name,
-							data: data ?? {}
-						})
-					}
-				}));
-				evts.push(...pending);
-				firedKeys.push(key);
-			} catch (err) {
-				if (snapshot !== null) state = snapshot;
-				console.error(`[Deadline] ❌ ${key} で例外`, err);
-			}
-		}
-		syncWakeup();
-		if (firedKeys.length === 0) return;
-		console.log(`[Deadline] ⏰ ${firedKeys.length} 件発火: ${firedKeys.join(", ")}`);
-		dispatchEvents(evts);
-		onState(state, myId);
-	};
-	const syncWakeup = () => {
-		const next = frozen() ? null : nextDeadline();
-		if (next === wakeupAt) return;
-		if (wakeupTimer) clearTimeout(wakeupTimer);
-		wakeupTimer = null;
-		wakeupAt = next;
-		if (next === null) return;
-		wakeupTimer = setTimeout(fireDue, Math.max(0, clock.toWall(next) - Date.now()));
-	};
-	const dispatchEvents = (evts) => {
-		for (const e of evts) {
-			const handler = events?.[e.name]?.handler;
-			if (!handler) continue;
-			callScenario(`event ハンドラ "${e.name}"`, () => handler(e.data));
-		}
-	};
-	clock.restart();
-	const setupTime = gameTime();
-	const setupArgs = {
-		players,
-		ctx: {
-			random,
-			...timeCtx(setupTime)
-		}
-	};
-	let state = withGameClock(setupTime, () => logic.setup(setupArgs));
-	let tick = 0;
-	const playerInputs = {};
-	const dispatchAction = (type, payload) => {
-		if (frozen()) {
-			console.warn(`[SDK LocalServerAction] 緊急停止中は action を実行しません (action="${type}")`);
-			return;
-		}
-		const plain = logic.actions[type];
-		const legacyServerOnly = isServerOnlyAction(plain) ? plain : null;
-		const server = logic.serverActions?.[type] ?? legacyServerOnly;
-		if (!plain && !server) return;
-		const plainEvents = [];
-		const serverEvents = [];
-		const plainEmit = (name, data) => plainEvents.push({
-			name,
-			data: data ?? {}
-		});
-		const serverEmit = (name, data) => serverEvents.push({
-			name,
-			data: data ?? {}
-		});
-		const time = gameTime();
-		if (plain && !legacyServerOnly) {
-			try {
-				withGameClock(time, () => plain({
-					state,
-					payload: payload ?? {},
-					playerId: myId,
-					ctx: {
-						...timeCtx(time),
-						emit: plainEmit
-					}
-				}));
-			} catch (err) {
-				console.warn("[SDK LocalServerAction] Action error:", err);
-				return;
-			}
-			dispatchEvents(plainEvents);
-			syncWakeup();
-			onState(state, myId);
-		}
-		if (!server) return;
-		(async () => {
-			try {
-				await server({
-					state,
-					payload: payload ?? {},
-					playerId: myId,
-					ctx: {
-						tick,
-						random,
-						...timeCtx(time),
-						emit: serverEmit
-					}
-				});
-			} catch (err) {
-				console.warn("[SDK LocalServerAction] Action error:", err);
-				return;
-			}
-			dispatchEvents(serverEvents);
-			syncWakeup();
-			onState(state, myId);
-		})();
-	};
-	/**
-	* ソロの停止 / 解除。サーバーが居ないので自分の時計を直接触る。
-	*
-	* `__uzu_dev.pauseTick()` とは別物。あちらは tick を止めるだけの開発者ツールで、
-	* ゲーム内時計も action ゲートも持たない。流用しない。
-	*/
-	const applyPause = (paused) => {
-		if (!(paused ? clock.freeze("emergency-stop") : clock.unfreeze("emergency-stop"))) return;
-		observeGameTime(gameTime());
-		setPauseState(paused, paused ? myId : null);
-		observeGameTime(gameTime());
-		syncWakeup();
-	};
-	setPauseRequester(applyPause);
-	inputs(dispatchAction);
-	syncWakeup();
-	onState(state, myId);
-	if (tickRate > 0) setInterval(() => {
-		if (frozen()) return;
-		const tickEvents = [];
-		const tickEmit = (name, data) => tickEvents.push({
-			name,
-			data: data ?? {}
-		});
-		const time = gameTime();
-		try {
-			withGameClock(time, () => logic.update({
-				state,
-				ctx: {
-					random,
-					tick,
-					...timeCtx(time),
-					emit: tickEmit,
-					playerInputs
-				}
-			}));
-		} catch (err) {
-			console.error(`[SDK LocalServerAction] tick error at tick=${tick}:`, err);
-			tick++;
-			return;
-		}
-		tick++;
-		dispatchEvents(tickEvents);
-		syncWakeup();
-		onState(state, myId);
-	}, 1e3 / tickRate);
-	return {
-		getRawState: () => state,
-		setRawState: async (next) => {
-			state = next;
-			syncWakeup();
-			onState(state, myId);
-		},
-		mergeRawState: async (patch) => {
-			applyJsonMergePatch(state, patch);
-			onState(state, myId);
-		},
-		patchRawState: async (ops) => {
-			applyJsonPatch(state, ops);
-			onState(state, myId);
-		},
-		sendAction: dispatchAction
-	};
-}
+};
 //#endregion
 //#region src/index.ts
 const gameHandlers = /* @__PURE__ */ new Map();
@@ -1948,7 +1944,7 @@ let _usesRun = false;
 let _playerId = null;
 let _runHandle = null;
 const _snapshotListeners = /* @__PURE__ */ new Set();
-function notifyDevSnapshot(snap) {
+const notifyDevSnapshot = (snap) => {
 	_snapshotListeners.forEach((cb) => {
 		try {
 			cb(snap);
@@ -1956,10 +1952,10 @@ function notifyDevSnapshot(snap) {
 			console.warn("[uzu_dev] snapshot listener threw:", err);
 		}
 	});
-}
-function attachDevHooksIfNotHosted() {
+};
+const attachDevHooksIfNotHosted = () => {
 	if (window.FlutterHost) return;
-	attachDevHooks({
+	const ctx = {
 		getSnapshot: () => _lastStateSnap?.state ?? null,
 		getRawState: _runHandle?.getRawState,
 		setRawState: _runHandle?.setRawState,
@@ -1972,10 +1968,11 @@ function attachDevHooksIfNotHosted() {
 				_snapshotListeners.delete(cb);
 			};
 		}
-	});
-}
+	};
+	attachDevHooks(ctx);
+};
 const isHosted = typeof window !== "undefined" && (!!window.FlutterHost || window.parent !== window);
-function init(opts) {
+const init = (_opts) => {
 	const params = new URLSearchParams(window.location.search);
 	_playerId = params.get("seatId");
 	if (isHosted && !_playerId) console.warn("[UZU SDK] playerId is missing in the URL. Host-side sender filtering will fall back to legacy behavior.");
@@ -1993,13 +1990,10 @@ function init(opts) {
 			handleMessage(msg);
 		} };
 		window.addEventListener("message", (event) => {
-			try {
-				const data = typeof event.data === "string" ? JSON.parse(event.data) : event.data;
-				if (data && typeof data.channel === "string" && typeof data.type === "string") {
-					console.log(`[SDK] ⬅ recv postMessage channel=${data.channel} type=${data.type}`, JSON.stringify(data));
-					handleMessage(data);
-				}
-			} catch {}
+			const data = parseBridgeEnvelope(event.data);
+			if (data === null) return;
+			console.log(`[SDK] ⬅ recv postMessage channel=${data.channel} type=${data.type}`, JSON.stringify(data));
+			handleMessage(data);
 		});
 		applyInsets(params);
 		onPauseChange((paused) => {
@@ -2012,31 +2006,31 @@ function init(opts) {
 		_initialized = true;
 	}
 	if (!_usesRun) attachDevHooksIfNotHosted();
-}
+};
 /** game channel でカスタムメッセージを送信する。 native コマンドには使用不可。 */
-function send(type, payload) {
+const send = (type, payload) => {
 	sendRaw("game", type, payload ?? {});
-}
+};
 /** game channel のカスタムメッセージを受信する。 */
-function on(type, handler) {
+const on = (type, handler) => {
 	if (!gameHandlers.has(type)) gameHandlers.set(type, []);
 	gameHandlers.get(type).push(handler);
-}
-function playSound(sound) {
+};
+const playSound = (sound) => {
 	sendRaw("sdk", "playSound", { sound });
-}
-function playBgm(sound) {
+};
+const playBgm = (sound) => {
 	sendRaw("sdk", "playBgm", { sound });
-}
-function stopBgm() {
+};
+const stopBgm = () => {
 	sendRaw("sdk", "stopBgm", {});
-}
-function setMicEnabled(enabled) {
+};
+const setMicEnabled = (enabled) => {
 	sendRaw("sdk", "setMicEnabled", { enabled });
-}
-function changeRoom(roomId) {
+};
+const changeRoom = (roomId) => {
 	sendRaw("sdk", "changeRoom", { roomId });
-}
+};
 /**
 * splash 描画完了を Flutter ホストに通知する。
 *
@@ -2053,9 +2047,9 @@ function changeRoom(roomId) {
 * requestAnimationFrame(() => firstFrameReady());
 * ```
 */
-function firstFrameReady() {
+const firstFrameReady = () => {
 	sendRaw("sdk", "firstFrameReady", {});
-}
+};
 /**
 * ユーザー操作受付可能を Flutter ホストに通知する。
 *
@@ -2072,13 +2066,36 @@ function firstFrameReady() {
 * gameReady();
 * ```
 */
-function gameReady() {
+const gameReady = () => {
 	sendRaw("sdk", "gameReady", {});
-}
+};
+/**
+* ゲームを終えてプレイ画面を閉じるよう Flutter ホストに通知する。
+*
+* 閉じるのは**呼んだ端末だけ**。全員を閉じたいときは、終了を表す state を全員へ配り、
+* 各端末の `onState` から呼ぶ。ホストはイベントを終了扱いにし (finishedAt を立てるのは
+* 最初の 1 人だけ)、呼んだプレイヤーを退出させてから画面を閉じる。
+*
+* 呼び出しタイミング: 結果や感想戦を見終えて閉じるときなど、シナリオとしてゲームが完全に
+* 終わった瞬間。勝敗が決まった瞬間 (`gameover` など) に呼ぶと、結果を見る前に画面が閉じる。
+*
+* 対応していない古いアプリや `uzu dev` harness では何も起きない。呼んだあとも画面を
+* 操作不能にしないこと。
+*
+* @example
+* ```ts
+* onState(state) {
+*   if (state.debriefClosed) finishGame();
+* }
+* ```
+*/
+const finishGame = () => {
+	sendRaw("sdk", "finishGame", {});
+};
 /** Flutter からの playersChanged メッセージを受信するハンドラを登録する。 */
-function onPlayersChanged(handler) {
+const onPlayersChanged = (handler) => {
 	_playersChangedHandlers.push(handler);
-}
+};
 /**
 * `A` に既定値が要る。 TypeScript は型引数の部分推論ができないので、 既定が無いと
 * 既存の `run<State>({…})` が「2 つ必要」で落ちる。 既定を置けば型引数を書かない
@@ -2088,7 +2105,7 @@ function onPlayersChanged(handler) {
 * `keyof (A & SA)` が `string` へ潰れ、action 名の検査が丸ごと消える。
 * `serverActions` を持たない logic でもキーが残るよう空 map を既定にする。
 */
-function run(config) {
+const run = (config) => {
 	_usesRun = true;
 	const params = new URLSearchParams(window.location.search);
 	if (!isHosted) return;
@@ -2114,7 +2131,7 @@ function run(config) {
 		runOnlineServerAction(wrappedConfig, _gameEndpoint, roomId, seatId, players, seatKind);
 	} else throw new Error("[UZU SDK] roomId is set but ?server= is missing. Multiplayer requires a WebSocket server URL — pass ?server=ws://host:port in the URL.");
 	attachDevHooksIfNotHosted();
-}
+};
 /**
 * 自分の席種別を URL から取り出す。
 *
@@ -2124,17 +2141,17 @@ function run(config) {
 * この値は iframe URL 限定で、WebSocket には出さない。play-server は roster に居ない接続を
 * 通すだけで、その席が admin か spectator かを知る必要が無い。
 */
-function resolveSeatKind(params) {
+const resolveSeatKind = (params) => {
 	const raw = params.get("seatKind");
 	return raw === "admin" || raw === "spectator" ? raw : "player";
-}
+};
 /**
 * 自席の ID と roster を URL から取り出す。
 *
 * roster (`?players=`) に自席が居ないことは異常ではない。観測者はそもそも roster に
 * 載らないまま接続してくる。
 */
-function resolveSeatParams(params) {
+const resolveSeatParams = (params) => {
 	const seatId = params.get("seatId");
 	if (!seatId) throw new Error("[UZU SDK] seatId is required. Pass ?seatId=xxx in the URL.");
 	const json = params.get("players");
@@ -2148,9 +2165,9 @@ function resolveSeatParams(params) {
 			characterId: p.characterId
 		}))
 	};
-}
+};
 /** 内部送信関数。 channel + type + payload のエンベロープで送信する。 */
-function sendRaw(channel, type, payload) {
+const sendRaw = (channel, type, payload) => {
 	const msg = {
 		channel,
 		type,
@@ -2160,8 +2177,24 @@ function sendRaw(channel, type, payload) {
 	console.log(`[SDK] ➡ send channel=${channel} type=${type}`, JSON.stringify(msg));
 	if (window.FlutterHost) window.FlutterHost.postMessage(JSON.stringify(msg));
 	else if (window.parent !== window) window.parent.postMessage(JSON.stringify(msg), "*");
-}
-function handleMessage(msg) {
+};
+/** 親 frame から届く envelope。string でも object でも来るので、形を確かめてから通す。 */
+const parseBridgeEnvelope = (raw) => {
+	let value = raw;
+	if (typeof value === "string") try {
+		value = JSON.parse(value);
+	} catch {
+		return null;
+	}
+	if (typeof value !== "object" || value === null) return null;
+	const envelope = value;
+	if (typeof envelope.channel !== "string" || typeof envelope.type !== "string") return null;
+	return {
+		channel: envelope.channel,
+		type: envelope.type
+	};
+};
+const handleMessage = (msg) => {
 	const { channel, type, payload } = msg;
 	if (channel === "sdk") {
 		switch (type) {
@@ -2170,7 +2203,7 @@ function handleMessage(msg) {
 				sendRaw("sdk", "stateResponse", { state: _lastStateSnap });
 				return;
 			case "playersChanged": {
-				const players = payload?.players ?? {};
+				const players = payload.players ?? {};
 				for (const fn of _playersChangedHandlers) callScenario("playersChanged ハンドラ", () => fn(players));
 				return;
 			}
@@ -2183,17 +2216,14 @@ function handleMessage(msg) {
 				requestResume();
 				return;
 			case "insetsChanged":
-				handleInsetsChanged(payload ?? {});
+				handleInsetsChanged(payload);
 				return;
 		}
 		return;
 	}
-	if (channel === "game") {
-		const h = gameHandlers.get(type) || [];
-		console.log(`[SDK] 🔧 handleMessage game/${type} handlers=${h.length}`);
-		for (const fn of h) callScenario(`game/${type} ハンドラ`, () => fn(payload ?? {}));
-		return;
-	}
-}
+	const h = gameHandlers.get(type) ?? [];
+	console.log(`[SDK] 🔧 handleMessage game/${type} handlers=${h.length}`);
+	for (const fn of h) callScenario(`game/${type} ハンドラ`, () => fn(payload));
+};
 //#endregion
-export { DEFAULT_ICON_URLS, GAME_START, ReconnectableWebSocket, SeededRandomImpl, applyJsonMergePatch, applyJsonPatch, attachDevHooks, changeRoom, createDevHooks, firstFrameReady, gameReady, gameTime, getInsets, getPredictionWarnings, init, isHosted, isPaused, isServerOnlyAction, minus, on, onInsetsChange, onPauseChange, onPlayersChanged, playBgm, playSound, plus, run, send, serverOnly, setMicEnabled, stopBgm, sub };
+export { DEFAULT_ICON_URLS, GAME_START, ReconnectableWebSocket, SeededRandomImpl, applyJsonMergePatch, applyJsonPatch, attachDevHooks, changeRoom, createDevHooks, finishGame, firstFrameReady, gameReady, gameTime, getInsets, getPredictionWarnings, init, isHosted, isPaused, isServerOnlyAction, minus, on, onInsetsChange, onPauseChange, onPlayersChanged, playBgm, playSound, plus, run, send, serverOnly, setMicEnabled, stopBgm, sub };