@uzuhq/code-sdk 0.8.4 → 0.8.6

package/README.md

@@ -25,24 +25,6 @@ SDK チャネルのメッセージは `playSound()`, `setMicEnabled()` などの
 
 ---
 
-## 3 つのパラダイム
-
-SDK は用途に応じて 3 つの API パターンを提供する。
-
-| パラダイム | API                   | state 管理                         | 向いているゲーム             |
-| ---------- | --------------------- | ---------------------------------- | ---------------------------- |
-| **Relay**  | `init()` + `onRoom()` | ゲーム側の責務                     | 独自プロトコルが必要なゲーム |
-| **sync()** | `sync()`              | SDK + サーバーが JSON Patch で同期 | ターン制・ボードゲーム       |
-| **run()**  | `run()`               | SDK + reducer がサーバーで逐次実行 | リアルタイム・アクション全般 |
-
-### 選択基準
-
-- 同時操作で同じリソースを奪い合う → **`run()`**（reducer が最新 state に対して逐次実行、条件保証あり）
-- 各プレイヤーが自分の領域だけ変更 → **`sync()`** で十分
-- 独自のメッセージプロトコルが必要 → **Relay**
-
----
-
 ## 初期化
 
 ### `init(): void`
@@ -54,132 +36,19 @@ import { init } from '@uzuhq/code-sdk';
 init();
 ```
 
-- `run()` / `sync()` を使う場合は内部で `init()` が呼ばれるため不要
-- Relay パターン (`onRoom()`) のみ、最初に呼び出す
-
----
-
-## パターン 1: Relay
-
-### `onRoom(callback: (room: RoomLike) => void): void`
-
-Room に接続されたときのコールバックを登録する。
-
-```ts
-import { init, onRoom } from '@uzuhq/code-sdk';
-
-init();
-
-onRoom((room) => {
-  console.log('My ID:', room.myId);
-
-  room.on('attack', (msg) => {
-    console.log(`${msg.__from} sent ${msg.lines} lines`);
-  });
-
-  room.broadcast({ type: 'attack', lines: 2 });
-  room.send(targetId, { type: 'whisper', text: 'hello' });
-});
-```
-
-### Room API
-
-| メソッド/プロパティ      | 型                                                     | 説明                                                     |
-| ------------------------ | ------------------------------------------------------ | -------------------------------------------------------- |
-| `room.myId`              | `string` (readonly)                                    | 自分の playerId                                          |
-| `room.broadcast(msg)`    | `(msg: Record<string, unknown>) => void`               | 自分以外の全員に送信                                     |
-| `room.send(id, msg)`     | `(id: string, msg: Record<string, unknown>) => void`   | 特定プレイヤーに送信                                     |
-| `room.on(type, handler)` | `(type: string, handler: (data: any) => void) => void` | メッセージハンドラ登録。受信データに `__from` が含まれる |
-
----
-
-## パターン 2: sync()
-
-### `sync<S>(config: SyncConfig<S>): void`
-
-JSON Patch ベースの状態同期を開始する。
-
-```ts
-import { sync, SERVER_TIME } from '@uzuhq/code-sdk';
-import type { Seat } from '@uzuhq/code-sdk';
-
-sync<GameState>({
-  playerCount: 2,
-
-  initialState(players: Seat[]) {
-    return { board: createBoard(8), currentPlayer: players[0].id };
-  },
-
-  onState(state, myPlayerId, serverTime) {
-    currentState = state;
-    render();
-  },
-
-  inputs(patch, set) {
-    canvas.addEventListener('click', (e) => {
-      const { row, col } = getCellFromClick(e);
-      // 複数操作をまとめて送信
-      patch([
-        { op: 'replace', path: `/board/${row}/${col}`, value: myPlayerId },
-        { op: 'replace', path: '/lastMoveAt', value: SERVER_TIME },
-      ]);
-      // 単一値のショートカット
-      set('/currentPlayer', getNextPlayer());
-    });
-  },
-
-  connection: {
-    onConnectionStateChange(state) {
-      console.log('Connection:', state);
-    },
-    onPatchFailed(error) {
-      console.error('Patch failed:', error);
-    },
-  },
-});
-```
-
-### SyncConfig
-
-| キー           | 型                                                           | 必須 | 説明                         |
-| -------------- | ------------------------------------------------------------ | ---- | ---------------------------- |
-| `playerCount`  | `number`                                                     | Yes  | プレイヤー数                 |
-| `initialState` | `(players: Seat[]) => S`                                     | Yes  | 初期 state を生成            |
-| `onState`      | `(state: S, myPlayerId: string, serverTime: number) => void` | Yes  | state 更新時のコールバック   |
-| `inputs`       | `(patch: PatchFn, set: SetFn) => void`                       | Yes  | 入力ハンドラ登録             |
-| `events`       | `Record<string, (data: Record<string, unknown>) => void>`    | No   | ゲームイベントハンドラ       |
-| `connection`   | `ConnectionCallbacks`                                        | No   | 接続状態・エラーコールバック |
-
-### PatchFn / SetFn
-
-```ts
-type PatchFn = (ops: Operation[]) => void; // 複数操作をまとめて送信
-type SetFn = (path: string, value: unknown) => void; // 単一パスの replace ショートカット
-```
-
-### Operation (JSON Patch)
-
-```ts
-interface Operation {
-  op: 'replace' | 'add' | 'remove';
-  path: string; // JSON Pointer パス (例: '/players/alice/score')
-  value?: unknown; // 値。SERVER_TIME sentinel 使用可
-}
-```
-
-### 楽観的更新
-
-`sync()` は送信した patch をローカルに即座に適用する。サーバーからの権威的な state を受信すると上書きする。
-
-**注意**: `sync()` は patch の条件を検証しない。同時に同じパスを変更すると後勝ちになる。条件付きの状態遷移が必要なら `run()` を使う。
+- `run()` が内部で呼ぶので、通常は直接書かなくてよい
+- マルチプレイの state 同期を使わない 1 人用シナリオ (サウンド・ボイス・safe area だけ使う)
+  では、これだけを最初に呼ぶ
 
 ---
 
-## パターン 3: run()
+## ゲームループ
 
 ### `run<S>(config: GameConfig<S>): void`
 
-Host-authoritative ゲームループを実行する。サーバー (GameRoom DO) が reducer を逐次実行するため、条件保証あり。
+ゲームループを開始する。state はサーバー (GameRoom DO) が持ち、送られた action を
+reducer で 1 件ずつ検証・実行して結果を全員へ配る。reducer は常にその時点の最新 state に
+対して走るので、同時操作で条件が壊れることがない。
 
 ```ts
 import { run } from '@uzuhq/code-sdk';
@@ -206,15 +75,14 @@ run({
 
 ### GameConfig
 
-| キー                      | 型                                                             | 必須 | 説明                                |
-| ------------------------- | -------------------------------------------------------------- | ---- | ----------------------------------- |
-| `logic`                   | `GameLogic<S>`                                                 | Yes  | ゲームロジック定義                  |
-| `onState`                 | `(state: S, myPlayerId: string) => void`                       | Yes  | state 更新時のコールバック          |
-| `inputs`                  | `(sendAction: (action: string, payload: any) => void) => void` | Yes  | 入力ハンドラ登録                    |
-| `events`                  | `Record<string, (data: any) => void>`                          | No   | ゲームイベントハンドラ              |
-| `playerCount`             | `number`                                                       | Yes  | プレイヤー数                        |
-| `onConnectionStateChange` | `(state: ConnectionState) => void`                             | No   | 接続状態変化コールバック            |
-| `onPatchFailed`           | `(reason: string) => void`                                     | No   | サーバー patch 適用失敗コールバック |
+| キー                      | 型                                                             | 必須 | 説明                       |
+| ------------------------- | -------------------------------------------------------------- | ---- | -------------------------- |
+| `logic`                   | `GameLogic<S>`                                                 | Yes  | ゲームロジック定義         |
+| `onState`                 | `(state: S, myPlayerId: string) => void`                       | Yes  | state 更新時のコールバック |
+| `inputs`                  | `(sendAction: (action: string, payload: any) => void) => void` | Yes  | 入力ハンドラ登録           |
+| `events`                  | `Record<string, (data: any) => void>`                          | No   | ゲームイベントハンドラ     |
+| `playerCount`             | `number`                                                       | Yes  | プレイヤー数               |
+| `onConnectionStateChange` | `(state: ConnectionState) => void`                             | No   | 接続状態変化コールバック   |
 
 ### GameLogic
 
@@ -445,6 +313,58 @@ onPlayersChanged((players) => {
 
 ---
 
+## SafeArea / HUD 回避
+
+ゲームは常に全画面へ描かれる。ノッチや UZU の HUD を避けるのはゲーム側の仕事で、避けるべき
+領域はホストが配る。**素の `env(safe-area-inset-*)` は使わない** (iframe / WebView の境界を
+越えないのでホストによっては 0 になる)。
+
+`init()` が以下の CSS カスタムプロパティを起動時に設定する。
+
+| 変数                                            | 意味                                                                      |
+| ----------------------------------------------- | ------------------------------------------------------------------------- |
+| `--uzu-safe-area-inset-{top,right,bottom,left}` | デバイスの safe area                                                      |
+| `--uzu-hud-inset-x` / `--uzu-hud-inset-y`       | HUD 矩形の右下座標（safe area 内側の左上が原点）                          |
+| `--uzu-content-inset-{top,right,bottom,left}`   | 上 2 つを合成済み (`top` にだけ HUD の高さを足す)。**迷ったらこれを使う** |
+
+```css
+.game-ui {
+  padding-top: var(--uzu-content-inset-top, env(safe-area-inset-top, 0px));
+  padding-left: var(--uzu-content-inset-left, env(safe-area-inset-left, 0px));
+}
+```
+
+### `getInsets(): UzuInsets`
+
+canvas / WebGL のように CSS で避けられない描画向けに、同じ値を数値で読む。
+
+```ts
+import { getInsets } from '@uzuhq/code-sdk';
+
+const { safeArea, content, hud } = getInsets();
+// safeArea / content: { top, right, bottom, left } (CSS px)
+// hud: { x, y }
+layout(content);
+```
+
+値は初回ペイント前に確定しているので setup の中で読んでよい。
+
+### `onInsetsChange(cb: (insets: UzuInsets) => void): () => void`
+
+回転 / PiP で値が変わったときに呼ばれる。戻り値を呼ぶと解除できる。
+
+```ts
+import { onInsetsChange } from '@uzuhq/code-sdk';
+
+const off = onInsetsChange((insets) => layout(insets.content));
+```
+
+**CSS 変数の変化は `resize` イベントを発火させない。** `window.addEventListener('resize', …)`
+だけを見ている実装は追従できないので、canvas を持つシナリオは必ずこちらを使う。
+登録時の即時呼び出しはしないので、初期値は `getInsets()` で読む。
+
+---
+
 ## メッセージング
 
 ### `send(type: string, payload?: object): void`
@@ -479,17 +399,6 @@ on('attack', (payload) => {
 
 ---
 
-## SERVER_TIME
-
-サーバー時刻 sentinel 定数。Patch の `value` に指定すると、サーバー側で `Date.now()` に自動置換される。
-
-```ts
-import { SERVER_TIME } from '@uzuhq/code-sdk';
-set('/meta/phaseStartedAt', SERVER_TIME);
-```
-
----
-
 ## 型定義
 
 ### BridgeMessage
@@ -554,7 +463,6 @@ type ConnectionState = 'connecting' | 'connected' | 'reconnecting' | 'disconnect
 ```ts
 interface ConnectionCallbacks {
   onConnectionStateChange?: (state: ConnectionState) => void;
-  onPatchFailed?: (error: string) => void;
 }
 ```
 
@@ -578,15 +486,17 @@ interface PlayerVoiceState {
 
 ## URL パラメータ
 
-`init()` / `run()` / `sync()` は以下の URL パラメータを読み取る。
+`init()` / `run()` は以下の URL パラメータを読み取る。
 
-| パラメータ  | 説明                                          |
-| ----------- | --------------------------------------------- |
-| `?server=`  | WebSocket サーバーの URL                      |
-| `?roomId=`  | ルーム ID。指定するとオンラインモードになる   |
-| `?seatId=`  | 自分の席 ID                                   |
-| `?players=` | JSON エンコードされたプレイヤーリスト         |
-| `?__dev=N`  | Dev ハーネスモード (N 画面の iframe 並列表示) |
+| パラメータ                                  | 説明                                          |
+| ------------------------------------------- | --------------------------------------------- |
+| `?server=`                                  | WebSocket サーバーの URL                      |
+| `?roomId=`                                  | ルーム ID。指定するとオンラインモードになる   |
+| `?seatId=`                                  | 自分の席 ID                                   |
+| `?players=`                                 | JSON エンコードされたプレイヤーリスト         |
+| `?__dev=N`                                  | Dev ハーネスモード (N 画面の iframe 並列表示) |
+| `?uzuSafeAreaInset{Top,Right,Bottom,Left}=` | デバイスの safe area。ホストが配る            |
+| `?uzuHudInsetX=` / `?uzuHudInsetY=`         | HUD 矩形の右下座標。ホストが配る              |
 
 ### モードの自動判定
 
@@ -604,7 +514,6 @@ interface PlayerVoiceState {
 
 - `run()` の devHarness → **親 frame だけ** (`page.mainFrame()`)
 - `runLocalServerAction` (ソロモード) 単独 frame → その frame
-- sync 系単独 frame → その frame
 - devHarness の **子 iframe には attach しない**
 
 ```ts
@@ -653,7 +562,7 @@ await window.__uzu_dev.waitForSnapshot((s) => s.self.isReady === true);
   - 部分更新は `mergeRawState`、array 要素単体の書換は `patchRawState` を使う
   - `mergeRawState` で array field に non-array object patch を当てると **throw** する (array が pure object に化けるのを構造的に防止)
 - online ServerAction では 3 API すべて `undefined`
-- `send` は run devHarness 親 frame のみ。非 parent モード (runLocal / emulator / sync) では scenario 側の `window.__uzu.sendAction` を使う
+- `send` は run devHarness 親 frame のみ。非 parent モード (runLocal / emulator) では scenario 側の `window.__uzu.sendAction` を使う
 - `await d.send(...)` / `await d.*RawState(...)` は **(a) handler 完了 (b) parent state broadcast 投函** までを待つ。**子 iframe canvas の paint 完了は含まない** ので、screenshot / visual e2e test では `await new Promise(r => requestAnimationFrame(r))` を別途挟むこと
 - phase 遷移時の field reset や `markReady` 等の **state shape を仮定する helper は SDK には含めない**。scenario 側で `window.__<scene>_dev` を生やして上記 primitive を組み合わせる
 

package/dist/dev-globals.d.ts

@@ -1,4 +1,4 @@
-import { i as UzuDevHooks } from "./dev-hooks-DOtJHP55.js";
+import { r as UzuDevHooks } from "./dev-hooks-DmOV2p0j.js";
 //#region src/dev-globals.d.ts
 declare global {
   interface Window {
@@ -6,7 +6,7 @@ declare global {
      * dev harness / Playwright / 単独 page で attach される dev hooks。
      * 本番 (Flutter native ホスト) では undefined。
      * - run() devHarness: 親 frame に attach (authoritative state)
-     * - sync() / online: 子 frame で undefined
+     * - online: 子 frame で undefined
      */
     __uzu_dev?: UzuDevHooks<unknown>;
   }

package/dist/{dev-hooks-DOtJHP55.d.ts → dev-hooks-DmOV2p0j.d.ts}

@@ -352,25 +352,9 @@ interface GameLogic<S, A extends ActionMap<S> = ActionMap<S>, SA extends ServerA
   deadlines?: Record<string, Deadline<S>>;
   tickRate?: number;
 }
-/** Sentinel value — patch の value にセットすると、サーバーが Date.now() に置換する */
-declare const SERVER_TIME: "__SERVER_TIME__";
 /** デフォルトのプレイヤーアイコン URL 一覧（dev / local モード用） */
 declare const DEFAULT_ICON_URLS: readonly ["https://imagedelivery.net/htp-D7B2hJT5XtdWYN9e7Q/4d0da24d-bcf2-4f7b-d1a0-f1bb8c747300/original", "https://imagedelivery.net/htp-D7B2hJT5XtdWYN9e7Q/8c75fccb-41d6-429d-e943-06c728a72a00/original", "https://imagedelivery.net/htp-D7B2hJT5XtdWYN9e7Q/43f45d11-da38-4d6e-637d-3df78e583500/original"];
 //#endregion
-//#region ../engine-core/src/json-patch.d.ts
-/**
- * @docs
- * - SyncRoom仕様: docs/docs/uzu_code/sync-room.md
- *
- * state 差分同期用の JSON Patch。RFC 6902 の全 op は実装せず、
- * `compare` が生成する replace / add / remove だけを扱う。
- */
-interface Operation {
-  op: 'replace' | 'add' | 'remove';
-  path: string;
-  value?: unknown;
-}
-//#endregion
 //#region src/types.d.ts
 /** @deprecated 旧フラット形式。新コードでは BridgeMessage を使用 */
 type PlayScreenMessage = {
@@ -474,29 +458,10 @@ interface GameConfig<S, A extends ActionMap<S> = ActionMap<S>, SA extends Server
    */
   devMinIframeShortEdge?: number;
 }
-type PatchFn = (ops: Operation[]) => void;
-type SetFn = (path: string, value: unknown) => void;
-interface SyncConfig<S = any> extends ConnectionCallbacks {
-  initialState: (players: Seat[]) => S;
-  onState: (state: S, myPlayerId: string, serverTime: number) => void;
-  inputs: (patch: PatchFn, set: SetFn) => void;
-  events?: Record<string, (data: Record<string, unknown>) => void>;
-  playerCount: number;
-  /** Dev harness のデフォルト向き。manifest.json の `orientation` を渡す。 */
-  orientation?: 'portrait' | 'landscape';
-  /**
-   * Dev harness で各 iframe inner viewport 短辺の下限 (CSS px)。
-   * default 360。狭い viewport では親 frame に `body { zoom: N }` を当てて
-   * iframe 内部の `window.innerWidth/Height` を保証する。
-   */
-  devMinIframeShortEdge?: number;
-}
 type ConnectionState = 'connecting' | 'connected' | 'reconnecting' | 'disconnected';
 interface ConnectionCallbacks {
   /** WebSocket 接続状態が変化した時に呼ばれる */
   onConnectionStateChange?: (state: ConnectionState) => void;
-  /** サーバーで patch 適用が失敗した時に呼ばれる (sync モード専用) */
-  onPatchFailed?: (reason: string) => void;
 }
 //#endregion
 //#region src/host-globals.d.ts
@@ -671,23 +636,9 @@ interface RunHandle<S = unknown> {
   /** 既存 inputs と同等の action 送信 (dev hooks 用) */
   sendAction(type: string, payload?: Record<string, unknown>): void;
 }
-/**
- * sync/* モジュール (sync/dev / sync/local) が dev hooks に state を expose
- * するための handle。online sync では handle 自体を返さない。
- */
-interface SyncHandle<S = unknown> {
-  /** 内部 state の getter (dev hooks 用) */
-  getRawState?(): S | null;
-  /** 生 state 全置換 */
-  setRawState?(state: S): Promise<void>;
-  /** RFC 7396 風 Merge Patch */
-  mergeRawState?(patch: JsonMergePatch<S>): Promise<void>;
-  /** RFC 6902 JSON Patch */
-  patchRawState?(ops: JsonPatchOp[]): Promise<void>;
-}
 /**
  * dev-hooks.ts から見た「SDK 内部のコンテキスト」。
- * 各 run/* / sync/* モジュールがこの形の handle を組み立てて attachDevHooks に渡す。
+ * 各 run/* モジュールがこの形の handle を組み立てて attachDevHooks に渡す。
  */
 interface DevHooksCtx<S = unknown> {
   /** 最新 snapshot (per-player view)。未初期化なら null。 */
@@ -738,4 +689,4 @@ interface DevHooksCtx<S = unknown> {
 declare function createDevHooks<S>(ctx: DevHooksCtx<S>): UzuDevHooks<S>;
 declare function attachDevHooks<S>(ctx: DevHooksCtx<S>): void;
 //#endregion
-export { GameTime as $, DEFAULT_ICON_URLS as A, ServerActionContext as B, SetFn as C, ActionContext as D, ActionArgs as E, GameLogic as F, ServerOnlyActionContext as G, ServerActionMap as H, SERVER_TIME as I, SetupContext as J, ServerOnlyActionHandlerFn as K, Seat as L, DeadlineArgs as M, DeadlineContext as N, ActionHandler as O, Emit as P, GAME_START as Q, SeededRandom as R, SendAction as S, Operation as T, ServerEvent as U, ServerActionHandler as V, ServerOnlyAction as W, UpdateContext as X, UpdateArgs as Y, Duration as Z, PayloadMap as _, attachDevHooks as a, applyJsonMergePatch as at, PlayersChangedMessage as b, getPredictionWarnings as c, ConnectionCallbacks as d, minus as et, ConnectionState as f, PatchFn as g, GameConfig as h, UzuDevHooks as i, JsonPatchOp as it, Deadline as j, ActionMap as k, BridgeChannel as l, EventSubscription as m, RunHandle as n, sub as nt, createDevHooks as o, applyJsonPatch as ot, EventHandler as p, SetupArgs as q, SyncHandle as r, JsonMergePatch as rt, PredictionWarning as s, DevHooksCtx as t, plus as tt, BridgeMessage as u, PlayScreenMessage as v, SyncConfig as w, SeatKind as x, PlayerVoiceState as y, ServerActionArgs as z };
+export { applyJsonMergePatch as $, GameLogic as A, ServerOnlyActionHandlerFn as B, ActionHandler as C, DeadlineArgs as D, Deadline as E, ServerActionHandler as F, Duration as G, SetupContext as H, ServerActionMap as I, minus as J, GAME_START as K, ServerEvent as L, SeededRandom as M, ServerActionArgs as N, DeadlineContext as O, ServerActionContext as P, JsonPatchOp as Q, ServerOnlyAction as R, ActionContext as S, DEFAULT_ICON_URLS as T, UpdateArgs as U, SetupArgs as V, UpdateContext as W, sub as X, plus as Y, JsonMergePatch as Z, PlayerVoiceState as _, createDevHooks as a, SendAction as b, BridgeChannel as c, ConnectionState as d, applyJsonPatch as et, EventHandler as f, PlayScreenMessage as g, PayloadMap as h, attachDevHooks as i, Seat as j, Emit as k, BridgeMessage as l, GameConfig as m, RunHandle as n, PredictionWarning as o, EventSubscription as p, GameTime as q, UzuDevHooks as r, getPredictionWarnings as s, DevHooksCtx as t, ConnectionCallbacks as u, PlayersChangedMessage as v, ActionMap as w, ActionArgs as x, SeatKind as y, ServerOnlyActionContext as z };

package/dist/index.d.ts

@@ -1,4 +1,18 @@
-import { $ as GameTime, A as DEFAULT_ICON_URLS, B as ServerActionContext, C as SetFn, D as ActionContext, E as ActionArgs, F as GameLogic, G as ServerOnlyActionContext, H as ServerActionMap, I as SERVER_TIME, J as SetupContext, K as ServerOnlyActionHandlerFn, L as Seat, M as DeadlineArgs, N as DeadlineContext, O as ActionHandler, P as Emit, Q as GAME_START, R as SeededRandom, S as SendAction, T as Operation, U as ServerEvent, V as ServerActionHandler, W as ServerOnlyAction, X as UpdateContext, Y as UpdateArgs, Z as Duration, _ as PayloadMap, a as attachDevHooks, at as applyJsonMergePatch, b as PlayersChangedMessage, c as getPredictionWarnings, d as ConnectionCallbacks, et as minus, f as ConnectionState, g as PatchFn, h as GameConfig, i as UzuDevHooks, it as JsonPatchOp, j as Deadline, k as ActionMap, l as BridgeChannel, m as EventSubscription, n as RunHandle, nt as sub, o as createDevHooks, ot as applyJsonPatch, p as EventHandler, q as SetupArgs, r as SyncHandle, rt as JsonMergePatch, s as PredictionWarning, t as DevHooksCtx, tt as plus, u as BridgeMessage, v as PlayScreenMessage, w as SyncConfig, x as SeatKind, y as PlayerVoiceState, z as ServerActionArgs } from "./dev-hooks-DOtJHP55.js";
+import { $ as applyJsonMergePatch, A as GameLogic, B as ServerOnlyActionHandlerFn, C as ActionHandler, D as DeadlineArgs, E as Deadline, F as ServerActionHandler, G as Duration, H as SetupContext, I as ServerActionMap, J as minus, K as GAME_START, L as ServerEvent, M as SeededRandom, N as ServerActionArgs, O as DeadlineContext, P as ServerActionContext, Q as JsonPatchOp, R as ServerOnlyAction, S as ActionContext, T as DEFAULT_ICON_URLS, U as UpdateArgs, V as SetupArgs, W as UpdateContext, X as sub, Y as plus, Z as JsonMergePatch, _ as PlayerVoiceState, a as createDevHooks, b as SendAction, c as BridgeChannel, d as ConnectionState, et as applyJsonPatch, f as EventHandler, g as PlayScreenMessage, h as PayloadMap, i as attachDevHooks, j as Seat, k as Emit, l as BridgeMessage, m as GameConfig, n as RunHandle, o as PredictionWarning, p as EventSubscription, q as GameTime, r as UzuDevHooks, s as getPredictionWarnings, t as DevHooksCtx, u as ConnectionCallbacks, v as PlayersChangedMessage, w as ActionMap, x as ActionArgs, y as SeatKind, z as ServerOnlyActionContext } from "./dev-hooks-DmOV2p0j.js";
+//#region ../engine-core/src/json-patch.d.ts
+/**
+ * @docs
+ * - play-server 仕様: docs/docs/uzu_code/play-server.md
+ *
+ * state 差分同期用の JSON Patch。RFC 6902 の全 op は実装せず、
+ * `compare` が生成する replace / add / remove だけを扱う。
+ */
+interface Operation {
+  op: 'replace' | 'add' | 'remove';
+  path: string;
+  value?: unknown;
+}
+//#endregion
 //#region ../engine-core/src/random.d.ts
 declare class SeededRandomImpl implements SeededRandom {
   private _state;
@@ -45,30 +59,6 @@ declare function isPaused(): boolean;
 /** 停止状態の変化を購読する。 */
 declare function onPauseChange(cb: (paused: boolean) => void): void;
 //#endregion
-//#region src/room.d.ts
-type RoomMessageHandler = (data: Record<string, unknown>) => void;
-/** WebSocket 互換の send/addEventListener インターフェース */
-interface WebSocketLike {
-  send(data: string): void;
-  addEventListener(type: 'message', handler: (ev: MessageEvent) => void): void;
-}
-/** Room の公開インターフェース。WebSocket / BroadcastChannel どちらでも実装可能。 */
-interface RoomLike {
-  readonly myId: string;
-  broadcast(msg: Record<string, unknown>): void;
-  send(id: string, msg: Record<string, unknown>): void;
-  on(type: string, handler: RoomMessageHandler): void;
-}
-declare class Room implements RoomLike {
-  readonly myId: string;
-  private ws;
-  private handlers;
-  constructor(ws: WebSocketLike, myId: string);
-  broadcast(msg: Record<string, unknown>): void;
-  send(id: string, msg: Record<string, unknown>): void;
-  on(type: string, handler: RoomMessageHandler): void;
-}
-//#endregion
 //#region src/reconnectable-ws.d.ts
 /**
  * 自動再接続 WebSocket ラッパー
@@ -131,15 +121,66 @@ declare class ReconnectableWebSocket {
   private handlePong;
 }
 //#endregion
+//#region src/insets.d.ts
+/**
+ * @docs
+ * - SafeArea 対応ガイド: javascript/uzu_code/docs/docs/guides/safe-area.md
+ * - Flutterライブラリ仕様: docs/docs/uzu_code/flutter-host.md
+ *
+ * ホストが配る inset を CSS 変数と JS API の両方へ流し込む層。
+ *
+ * `env(safe-area-inset-*)` は iframe / WebView の境界を越えない。GamePlayScreen を
+ * 開くホスト 4 つのうち 3 つはゲームを iframe に載せるので、デバイスの safe area は
+ * ホストが値として配る以外に伝える手が無い ([csswg-drafts#4670] は未解決のままで、
+ * `env()` は UA 定義なので CSS からも JS からも上書きできない)。Discord Activities /
+ * Telegram Mini Apps / Capacitor も例外なく同じ形を採っている。
+ *
+ * [csswg-drafts#4670]: https://github.com/w3c/csswg-drafts/issues/4670
+ */
+/** 4 辺の inset (CSS px)。 */
+interface Insets {
+  top: number;
+  right: number;
+  bottom: number;
+  left: number;
+}
+/** ホストが配る inset の全層。 */
+interface UzuInsets {
+  /** デバイスの safe area (ノッチ / 角丸 / ホームインジケータ)。 */
+  safeArea: Insets;
+  /**
+   * safeArea と HUD を合成済みの、そのまま避ければ安全な領域。
+   * 迷ったらこれを使う。
+   */
+  content: Insets;
+  /** UZU HUD 矩形の右下座標 (safe area 内側の左上が原点)。 */
+  hud: {
+    x: number;
+    y: number;
+  };
+}
+/**
+ * 現在の inset を返す。
+ *
+ * canvas / WebGL は CSS 変数で避けられないので、そこから読む口。値は初回ペイント前に
+ * 確定しているので、setup の中で読んでよい。
+ */
+declare function getInsets(): UzuInsets;
+/**
+ * inset の変化を購読する。戻り値を呼ぶと解除できる。
+ *
+ * **CSS 変数の変化は `resize` を発火させない**ので、`window.addEventListener('resize')`
+ * だけを見ている実装は回転 / PiP に追従できない。canvas を持つシナリオはこちらを使う。
+ *
+ * 登録時に即時呼び出しはしない。初期値は [getInsets] で読むこと。
+ */
+declare function onInsetsChange(cb: (insets: UzuInsets) => void): () => void;
+//#endregion
 //#region src/index.d.ts
 type GameMessageHandler = (payload: Record<string, unknown>) => void;
 type PlayersChangedHandler = (players: Record<string, PlayerVoiceState>) => void;
 declare const isHosted: boolean;
-declare function getRoom(): RoomLike | null;
-declare function onRoom(callback: (room: RoomLike) => void): void;
 declare function init(opts?: {
-  wsEndpoint?: string;
-  syncEndpoint?: string;
   playerCount?: number;
   orientation?: 'portrait' | 'landscape';
   /**
@@ -203,6 +244,5 @@ declare function onPlayersChanged(handler: PlayersChangedHandler): void;
  * `serverActions` を持たない logic でもキーが残るよう空 map を既定にする。
  */
 declare function run<S, A extends ActionMap<S> = ActionMap<S>, SA extends ServerActionMap<S> = Record<never, never>>(config: GameConfig<S, A, SA>): void;
-declare function sync<S>(config: SyncConfig<S>): void;
 //#endregion
-export { type ActionArgs, type ActionContext, type ActionHandler, type ActionMap, type BridgeChannel, type BridgeMessage, type ConnectionCallbacks, type ConnectionState, DEFAULT_ICON_URLS, type Deadline, type DeadlineArgs, type DeadlineContext, type DevHooksCtx, type Duration, type Emit, type EventHandler, type EventSubscription, GAME_START, type GameConfig, type GameLogic, type GameTime, type JsonMergePatch, type JsonPatchOp, type Operation, type PatchFn, type PayloadMap, type PlayScreenMessage, type PlayerVoiceState, type PlayersChangedMessage, type PredictionWarning, type ReconnectableWSOptions, ReconnectableWebSocket, Room, type RoomLike, type RunHandle, SERVER_TIME, type Seat, type SeatKind, type SeededRandom, SeededRandomImpl, type SendAction, type ServerActionArgs, type ServerActionContext, type ServerActionHandler, type ServerActionMap, type ServerEvent, type ServerOnlyAction, type ServerOnlyActionContext, type ServerOnlyActionHandlerFn, type SetFn, type SetupArgs, type SetupContext, type SyncConfig, type SyncHandle, type UpdateArgs, type UpdateContext, type UzuDevHooks, applyJsonMergePatch, applyJsonPatch, attachDevHooks, changeRoom, createDevHooks, firstFrameReady, gameReady, gameTime, getPredictionWarnings, getRoom, init, isHosted, isPaused, isServerOnlyAction, minus, on, onPauseChange, onPlayersChanged, onRoom, playBgm, playSound, plus, run, send, serverOnly, setMicEnabled, stopBgm, sub, sync };
+export { type ActionArgs, type ActionContext, type ActionHandler, type ActionMap, type BridgeChannel, type BridgeMessage, type ConnectionCallbacks, type ConnectionState, DEFAULT_ICON_URLS, type Deadline, type DeadlineArgs, type DeadlineContext, type DevHooksCtx, type Duration, type Emit, type EventHandler, type EventSubscription, GAME_START, type GameConfig, type GameLogic, type GameTime, type Insets, type JsonMergePatch, type JsonPatchOp, type Operation, type PayloadMap, type PlayScreenMessage, type PlayerVoiceState, type PlayersChangedMessage, type PredictionWarning, type ReconnectableWSOptions, ReconnectableWebSocket, type RunHandle, type Seat, type SeatKind, type SeededRandom, SeededRandomImpl, type SendAction, type ServerActionArgs, type ServerActionContext, type ServerActionHandler, type ServerActionMap, type ServerEvent, type ServerOnlyAction, type ServerOnlyActionContext, type ServerOnlyActionHandlerFn, type SetupArgs, type SetupContext, type UpdateArgs, type UpdateContext, type UzuDevHooks, type UzuInsets, 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 };

package/dist/index.js

@@ -1,6 +1,4 @@
 //#region ../engine-core/src/types.ts
-/** Sentinel value — patch の value にセットすると、サーバーが Date.now() に置換する */
-const SERVER_TIME = "__SERVER_TIME__";
 /** デフォルトのプレイヤーアイコン URL 一覧（dev / local モード用） */
 const DEFAULT_ICON_URLS = [
 	"https://imagedelivery.net/htp-D7B2hJT5XtdWYN9e7Q/4d0da24d-bcf2-4f7b-d1a0-f1bb8c747300/original",
@@ -284,7 +282,7 @@ function isServerOnlyAction(handler) {
 //#region src/server-clock.ts
 /**
 * @docs
-* - ServerAction仕様: docs/docs/uzu_code/connection-method/arch3-authority.md
+* - play-server 仕様: docs/docs/uzu_code/play-server.md
 * - 緊急停止とゲーム内時計: docs/docs/uzu_code/emergency-stop.md
 *
 * サーバーのゲーム内時計の推定値をクライアント全体へ配る。
@@ -355,7 +353,7 @@ function unfreezeGameTime() {
 */
 let paused = false;
 let pausedBy = null;
-const listeners = /* @__PURE__ */ new Set();
+const listeners$1 = /* @__PURE__ */ new Set();
 /** transport から呼ぶ内部関数。停止状態が変わったときだけ通知する。 */
 function setPauseState(next, by) {
 	pausedBy = next ? by : null;
@@ -363,7 +361,7 @@ function setPauseState(next, by) {
 	paused = next;
 	if (paused) freezeGameTime();
 	else unfreezeGameTime();
-	for (const cb of listeners) try {
+	for (const cb of listeners$1) try {
 		cb(paused);
 	} catch (err) {
 		console.warn("[uzu] onPauseChange listener threw:", err);
@@ -379,7 +377,7 @@ function getPausedBy() {
 }
 /** 停止状態の変化を購読する。 */
 function onPauseChange(cb) {
-	listeners.add(cb);
+	listeners$1.add(cb);
 }
 let requester = null;
 function setPauseRequester(fn) {
@@ -400,46 +398,6 @@ function requestResume() {
 	requester(false);
 }
 //#endregion
-//#region src/room.ts
-var Room = class {
-	constructor(ws, myId) {
-		this.handlers = /* @__PURE__ */ new Map();
-		this.ws = ws;
-		this.myId = myId;
-		this.ws.addEventListener("message", (ev) => {
-			let parsed;
-			try {
-				parsed = JSON.parse(ev.data);
-			} catch {
-				return;
-			}
-			const type = parsed.type;
-			if (!type) return;
-			const from = parsed.__from;
-			console.log(`[SDK Room] ⬅ recv type=${type} from=${from}`, JSON.stringify(parsed));
-			(this.handlers.get(type) || []).forEach((h) => h({
-				...parsed,
-				__from: from
-			}));
-		});
-	}
-	broadcast(msg) {
-		console.log(`[SDK Room] ➡ broadcast type=${msg.type}`, JSON.stringify(msg));
-		this.ws.send(JSON.stringify(msg));
-	}
-	send(id, msg) {
-		console.log(`[SDK Room] ➡ send to=${id} type=${msg.type}`, JSON.stringify(msg));
-		this.ws.send(JSON.stringify({
-			...msg,
-			__to: id
-		}));
-	}
-	on(type, handler) {
-		if (!this.handlers.has(type)) this.handlers.set(type, []);
-		this.handlers.get(type).push(handler);
-	}
-};
-//#endregion
 //#region src/reconnectable-ws.ts
 const DEFAULTS = {
 	maxReconnectAttempts: 15,
@@ -1115,6 +1073,234 @@ function attachDevHooks(ctx) {
 	window.__uzu_dev = createDevHooks(ctx);
 }
 //#endregion
+//#region src/insets.ts
+const SIDES = [
+	"top",
+	"right",
+	"bottom",
+	"left"
+];
+const SAFE_AREA_PARAM = {
+	top: "uzuSafeAreaInsetTop",
+	right: "uzuSafeAreaInsetRight",
+	bottom: "uzuSafeAreaInsetBottom",
+	left: "uzuSafeAreaInsetLeft"
+};
+/** ホストが値を配らない経路 (素のブラウザで直接開く等) の逃げ道。 */
+const envExpr = (side) => `env(safe-area-inset-${side}, 0px)`;
+const HUD_GAP = 6;
+const HUD_ACTION_ITEM_WIDTH = 38;
+/**
+* ホストが配った safe area。`null` は「配られていない」で、`env()` に委ねる合図。
+* 値で持っているあいだは計測が要らないので、回転のたびにレイアウトを読み直さずに済む。
+*/
+let hostSafeArea = null;
+let hud = {
+	x: 0,
+	y: 0
+};
+let current = null;
+let envProbe = null;
+const listeners = /* @__PURE__ */ new Set();
+const zero = () => ({
+	top: 0,
+	right: 0,
+	bottom: 0,
+	left: 0
+});
+const toFinite = (value) => {
+	const n = typeof value === "string" ? Number.parseFloat(value) : value;
+	return typeof n === "number" && Number.isFinite(n) ? n : null;
+};
+/**
+* `env()` の実値を読む計測用の要素。
+*
+* `env()` は JS から直接読めず、CSS 変数へ入れても `getComputedStyle` は代入前の
+* トークン列を返す。padding に置いて算出値を読むのが唯一の手。
+*/
+function measureEnvInsets() {
+	if (typeof document === "undefined") return zero();
+	if (!envProbe?.isConnected) {
+		const el = document.createElement("div");
+		el.setAttribute("aria-hidden", "true");
+		el.style.cssText = [
+			"position:fixed;top:0;left:0;width:0;height:0",
+			"visibility:hidden;pointer-events:none",
+			...SIDES.map((side) => `padding-${side}:${envExpr(side)}`)
+		].join(";");
+		(document.body ?? document.documentElement).appendChild(el);
+		envProbe = el;
+	}
+	const style = getComputedStyle(envProbe);
+	return {
+		top: toFinite(style.paddingTop) ?? 0,
+		right: toFinite(style.paddingRight) ?? 0,
+		bottom: toFinite(style.paddingBottom) ?? 0,
+		left: toFinite(style.paddingLeft) ?? 0
+	};
+}
+function setVar(name, value) {
+	if (typeof document === "undefined") return;
+	document.documentElement.style.setProperty(name, value);
+}
+function writeSafeAreaVars() {
+	for (const side of SIDES) setVar(`--uzu-safe-area-inset-${side}`, hostSafeArea ? `${hostSafeArea[side]}px` : envExpr(side));
+}
+function writeHudVars() {
+	setVar("--uzu-hud-inset-x", `${hud.x}px`);
+	setVar("--uzu-hud-inset-y", `${hud.y}px`);
+}
+/**
+* 合成済みの層。下 2 層を参照する式で書くので、safe area が実数でも `env()` でも
+* 同じ 1 本で成立する。
+*
+* `left` に `--uzu-hud-inset-x` を足さないのは、HUD が左上の**矩形**だから。上辺を
+* HUD の高さ分だけ空ければその下は全域が安全で、`left` にも足すと L 字全体を避ける
+* ことになり過剰に削れる。精密に避けたいシナリオは下 2 層を自分で合成する。
+*/
+function 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 safeArea = hostSafeArea ?? measureEnvInsets();
+	return {
+		safeArea,
+		content: {
+			top: safeArea.top + hud.y,
+			right: safeArea.right,
+			bottom: safeArea.bottom,
+			left: safeArea.left
+		},
+		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 next = compute();
+	if (current && same(current, next)) return;
+	current = next;
+	for (const cb of listeners) try {
+		cb(next);
+	} catch (err) {
+		console.warn("[UZU SDK] onInsetsChange listener threw:", err);
+	}
+}
+/**
+* HUD 回避領域の右下座標を算出する。
+* クエリパラメータに uzuHudInsetX/Y がない場合のフォールバック値として使用。
+*
+* 前提: UZU ボタンは常に表示される (onMenuPressed は常に非 null)。
+* Dart 側の HudInsets.x() は hasMenu=false を扱えるが、
+* フォールバック計算では安全側に倒して常に UZU ボタンありで算出する。
+*
+* - players が取得できる場合: 2人以上→アクション数2、1人→アクション数0
+* - players が取得できない場合: アクション数2 (安全側に倒す)
+*/
+function fallbackHudInsets(params) {
+	let actionCount = 2;
+	const json = params.get("players");
+	if (json) try {
+		actionCount = JSON.parse(json).length >= 2 ? 2 : 0;
+	} catch {}
+	let x = 56;
+	if (actionCount > 0) x += HUD_GAP + HUD_ACTION_ITEM_WIDTH * actionCount;
+	return {
+		x,
+		y: 52
+	};
+}
+function readSafeAreaParams(params) {
+	const values = zero();
+	let supplied = false;
+	for (const side of SIDES) {
+		const raw = params.get(SAFE_AREA_PARAM[side]);
+		if (raw === null) continue;
+		const n = toFinite(raw);
+		if (n === null) continue;
+		values[side] = n;
+		supplied = true;
+	}
+	return supplied ? values : null;
+}
+/**
+* URL パラメータから初期値を確定させる。`init()` が 1 度だけ呼ぶ。
+*
+* 初期値を URL で受けるのは、**初回ペイント前に確定させる**ため。起動後に push で
+* 配る形にすると、最初の 1 フレームだけ inset が空のまま描かれる
+* ([discord/embedded-app-sdk#304] と同じ踏み方) 。
+*
+* [discord/embedded-app-sdk#304]: https://github.com/discord/embedded-app-sdk/issues/304
+*/
+function applyInsets(params) {
+	const hudX = toFinite(params.get("uzuHudInsetX"));
+	const hudY = toFinite(params.get("uzuHudInsetY"));
+	const fallback = fallbackHudInsets(params);
+	hud = {
+		x: hudX ?? fallback.x,
+		y: hudY ?? fallback.y
+	};
+	hostSafeArea = readSafeAreaParams(params);
+	writeSafeAreaVars();
+	writeHudVars();
+	writeContentVars();
+	refresh();
+	if (!hostSafeArea && typeof window !== "undefined") {
+		window.addEventListener("resize", refresh);
+		window.addEventListener("orientationchange", refresh);
+	}
+}
+/**
+* ホストからの `insetsChanged` を反映する。回転 / PiP で値が変わったときに届く。
+* 内部用 (bridge の受信口から呼ばれる)。
+*/
+function handleInsetsChanged(payload) {
+	const safeArea = payload.safeArea;
+	if (safeArea) {
+		const next = zero();
+		for (const side of SIDES) next[side] = toFinite(safeArea[side]) ?? 0;
+		hostSafeArea = next;
+		writeSafeAreaVars();
+	}
+	const nextHud = payload.hud;
+	if (nextHud) {
+		hud = {
+			x: toFinite(nextHud.x) ?? hud.x,
+			y: toFinite(nextHud.y) ?? hud.y
+		};
+		writeHudVars();
+	}
+	refresh();
+}
+/**
+* 現在の inset を返す。
+*
+* canvas / WebGL は CSS 変数で避けられないので、そこから読む口。値は初回ペイント前に
+* 確定しているので、setup の中で読んでよい。
+*/
+function getInsets() {
+	if (!current) refresh();
+	return current ?? compute();
+}
+/**
+* inset の変化を購読する。戻り値を呼ぶと解除できる。
+*
+* **CSS 変数の変化は `resize` を発火させない**ので、`window.addEventListener('resize')`
+* だけを見ている実装は回転 / PiP に追従できない。canvas を持つシナリオはこちらを使う。
+*
+* 登録時に即時呼び出しはしない。初期値は [getInsets] で読むこと。
+*/
+function onInsetsChange(cb) {
+	listeners.add(cb);
+	return () => {
+		listeners.delete(cb);
+	};
+}
+//#endregion
 //#region src/run/optimistic-action-client.ts
 function createOptimisticActionClient(config) {
 	const { logic, playerId, onState, events, sendAction } = config;
@@ -1310,15 +1496,12 @@ function runOnlineServerAction(config, gameEndpoint, roomId, seatId, players, se
 		id: p.id,
 		name: p.nickname,
 		iconUrl: p.iconUrl,
-		characterId: p.characterId,
-		kind: "player"
+		characterId: p.characterId
 	});
-	const roster = JSON.stringify(players.map(toWire));
 	const wsUrl = `${gameEndpoint}/${roomId}?${new URLSearchParams({
 		seatId,
 		nickname: "Player",
-		players: roster,
-		seats: roster
+		players: JSON.stringify(players.map(toWire))
 	})}`;
 	console.log(`[SDK ServerAction] 🔗 Connecting wsUrl=${wsUrl}`);
 	const ws = new ReconnectableWebSocket(wsUrl, {
@@ -1567,7 +1750,6 @@ function runLocalServerAction(config) {
 	const setupTime = gameTime();
 	const setupArgs = {
 		players,
-		seats: players,
 		ctx: {
 			random,
 			...timeCtx(setupTime)
@@ -1703,217 +1885,15 @@ function runLocalServerAction(config) {
 	};
 }
 //#endregion
-//#region src/sync/local.ts
-function resolveLocalTime(ops) {
-	const now = Date.now();
-	return ops.map((op) => op.value === "__SERVER_TIME__" ? {
-		...op,
-		value: now
-	} : op);
-}
-function syncLocal(config) {
-	const { initialState, onState, inputs, events: _events } = config;
-	const localCount = config.playerCount;
-	const players = [];
-	for (let i = 0; i < localCount; i++) players.push({
-		id: `local_${i}`,
-		nickname: `Player ${i + 1}`,
-		iconUrl: DEFAULT_ICON_URLS[i % DEFAULT_ICON_URLS.length]
-	});
-	let state = initialState(players);
-	const myId = players[0].id;
-	const patchFn = (ops) => {
-		applyPatch(state, resolveLocalTime(ops));
-		onState(state, myId, Date.now());
-	};
-	const setFn = (path, value) => {
-		patchFn([{
-			op: "replace",
-			path,
-			value
-		}]);
-	};
-	inputs(patchFn, setFn);
-	onState(state, myId, Date.now());
-	setInterval(() => {
-		onState(state, myId, Date.now());
-	}, 100);
-	return {
-		getRawState: () => state,
-		setRawState: async (next) => {
-			state = next;
-			onState(state, myId, Date.now());
-		},
-		mergeRawState: async (patch) => {
-			applyJsonMergePatch(state, patch);
-			onState(state, myId, Date.now());
-		},
-		patchRawState: async (ops) => {
-			applyJsonPatch(state, ops);
-			onState(state, myId, Date.now());
-		}
-	};
-}
-//#endregion
-//#region src/sync/online.ts
-function syncOnline(config, syncEndpoint, roomId, playerId, hostPlayers) {
-	const { initialState, onState, inputs, events: _events } = config;
-	const wsUrl = `${syncEndpoint}/${roomId}?playerId=${encodeURIComponent(playerId)}`;
-	console.log(`[SDK Sync] 🔗 Connecting wsUrl=${wsUrl}`);
-	const ws = new ReconnectableWebSocket(wsUrl, {
-		onConnectionStateChange: (state) => {
-			console.log(`[SDK Sync] 📡 Connection state: ${state}`);
-			config.onConnectionStateChange?.(state);
-		},
-		shouldBuffer: (data) => {
-			try {
-				const parsed = JSON.parse(data);
-				return parsed.type !== "__patch" && parsed.type !== "__patch_ack";
-			} catch {
-				return true;
-			}
-		}
-	});
-	const myId = playerId;
-	const players = hostPlayers;
-	let state = null;
-	let gameInitSent = false;
-	let serverTimeOffset = 0;
-	let localSeq = 0;
-	let requestStatePending = false;
-	const estimateServerTime = () => Date.now() + serverTimeOffset;
-	const resolveToServerTime = (ops) => {
-		const now = estimateServerTime();
-		return ops.map((op) => op.value === "__SERVER_TIME__" ? {
-			...op,
-			value: now
-		} : op);
-	};
-	const sendPatch = (ops) => {
-		if (!ops || ops.length === 0) return;
-		if (state) {
-			applyPatch(state, resolveToServerTime(ops));
-			onState(state, myId, estimateServerTime());
-		}
-		console.log(`[SDK Sync] ➡ send __patch ops=${ops.length}`, JSON.stringify(ops));
-		ws.send(JSON.stringify({
-			type: "__patch",
-			ops
-		}));
-	};
-	const sendSet = (path, value) => {
-		sendPatch([{
-			op: "replace",
-			path,
-			value
-		}]);
-	};
-	inputs(sendPatch, sendSet);
-	setInterval(() => {
-		if (state) onState(state, myId, estimateServerTime());
-	}, 100);
-	const tryInitState = () => {
-		if (gameInitSent) return;
-		gameInitSent = true;
-		const initState = initialState(players);
-		console.log(`[SDK Sync] ➡ send __init_state players=${players.length}`);
-		ws.send(JSON.stringify({
-			type: "__init_state",
-			state: initState
-		}));
-	};
-	ws.addEventListener("message", (ev) => {
-		let parsed;
-		try {
-			parsed = JSON.parse(ev.data);
-		} catch {
-			return;
-		}
-		const msgType = parsed.type;
-		console.log(`[SDK Sync] ⬅ recv type=${msgType}`, JSON.stringify(parsed));
-		if (msgType === "__room_init") {
-			console.log(`[SDK Sync] ✅ Room init myId=${myId} players=${players.length}`);
-			tryInitState();
-			return;
-		}
-		if (msgType === "__reconnected") {
-			console.log(`[SDK Sync] 🔄 Reconnected myId=${myId}`);
-			if (!gameInitSent) tryInitState();
-			return;
-		}
-		if (msgType === "__state_cleared") {
-			console.log(`[SDK Sync] 🗑 State cleared, reinitializing`);
-			state = null;
-			localSeq = 0;
-			requestStatePending = false;
-			gameInitSent = false;
-			tryInitState();
-			return;
-		}
-		if (msgType === "__patch_failed") {
-			console.log(`[SDK Sync] ⚠️ Patch failed: ${parsed.reason}`);
-			config.onPatchFailed?.(parsed.reason);
-			return;
-		}
-		if (msgType === "__patch_ack") {
-			if (!state) return;
-			const ackSeq = parsed.seq ?? 0;
-			const ackSenderId = parsed.senderId;
-			const ackOps = parsed.ops;
-			const serverTime = parsed.serverTime;
-			if (ackSenderId === myId) {
-				localSeq = ackSeq;
-				serverTimeOffset = serverTime - Date.now();
-				return;
-			}
-			if (requestStatePending) return;
-			if (ackSeq === localSeq + 1) {
-				if (!applyPatch(state, ackOps)) {
-					console.log(`[SDK Sync] ⚠️ Local applyPatch failed, requesting full state`);
-					requestStatePending = true;
-					ws.send(JSON.stringify({ type: "__request_state" }));
-					return;
-				}
-				localSeq = ackSeq;
-				serverTimeOffset = serverTime - Date.now();
-				onState(state, myId, serverTime);
-			} else if (ackSeq > localSeq + 1) {
-				console.log(`[SDK Sync] ⚠️ Seq gap detected: expected=${localSeq + 1} received=${ackSeq}, requesting full state`);
-				requestStatePending = true;
-				ws.send(JSON.stringify({ type: "__request_state" }));
-			}
-			return;
-		}
-		if (msgType === "__state") {
-			state = parsed.state;
-			const serverTime = parsed.serverTime;
-			localSeq = parsed.seq ?? 0;
-			requestStatePending = false;
-			serverTimeOffset = serverTime - Date.now();
-			console.log(`[SDK Sync] ✅ State received serverTime=${serverTime} offset=${serverTimeOffset} seq=${localSeq}`);
-			ws.clearBuffer();
-			onState(state, myId, serverTime);
-			return;
-		}
-	});
-	return { ws };
-}
-//#endregion
 //#region src/index.ts
 const gameHandlers = /* @__PURE__ */ new Map();
 const _playersChangedHandlers = [];
-let _room = null;
 let _lastStateSnap = null;
-let _onRoomCallbacks = [];
-let _wsEndpoint = null;
-let _syncEndpoint = null;
 let _gameEndpoint = null;
-let _syncWs = null;
 let _initialized = false;
 let _usesRun = false;
 let _playerId = null;
 let _runHandle = null;
-let _syncHandle = null;
 const _snapshotListeners = /* @__PURE__ */ new Set();
 function notifyDevSnapshot(snap) {
 	_snapshotListeners.forEach((cb) => {
@@ -1928,10 +1908,10 @@ function attachDevHooksIfNotHosted() {
 	if (window.FlutterHost) return;
 	attachDevHooks({
 		getSnapshot: () => _lastStateSnap?.state ?? null,
-		getRawState: _runHandle?.getRawState ?? _syncHandle?.getRawState,
-		setRawState: _runHandle?.setRawState ?? _syncHandle?.setRawState,
-		mergeRawState: _runHandle?.mergeRawState ?? _syncHandle?.mergeRawState,
-		patchRawState: _runHandle?.patchRawState ?? _syncHandle?.patchRawState,
+		getRawState: _runHandle?.getRawState,
+		setRawState: _runHandle?.setRawState,
+		mergeRawState: _runHandle?.mergeRawState,
+		patchRawState: _runHandle?.patchRawState,
 		playerId: () => _lastStateSnap?.myId ?? _playerId,
 		subscribeSnapshot: (cb) => {
 			_snapshotListeners.add(cb);
@@ -1942,13 +1922,6 @@ function attachDevHooksIfNotHosted() {
 	});
 }
 const isHosted = typeof window !== "undefined" && (!!window.FlutterHost || window.parent !== window);
-function getRoom() {
-	return _room;
-}
-function onRoom(callback) {
-	if (_room) callback(_room);
-	else _onRoomCallbacks.push(callback);
-}
 function init(opts) {
 	const params = new URLSearchParams(window.location.search);
 	_playerId = params.get("seatId");
@@ -1956,14 +1929,10 @@ function init(opts) {
 	const serverParam = params.get("server");
 	if (serverParam && serverParam.length > 0) {
 		const base = serverParam.replace(/\/$/, "");
-		_wsEndpoint = `${base}/ws/rooms`;
-		_syncEndpoint = `${base}/ws/sync`;
 		const revisionId = params.get("revisionId");
 		if (!revisionId) throw new Error("[UZU SDK] revisionId is required when server is specified. Pass ?revisionId=xxx in the URL.");
 		_gameEndpoint = `${base}/ws/games/${revisionId}`;
 	}
-	if (opts?.wsEndpoint) _wsEndpoint = opts.wsEndpoint;
-	if (opts?.syncEndpoint) _syncEndpoint = opts.syncEndpoint;
 	if (!isHosted) return;
 	if (!_initialized) {
 		window.__ps = { onMessage: (msg) => {
@@ -1979,11 +1948,7 @@ function init(opts) {
 				}
 			} catch {}
 		});
-		const hudX = params.get("uzuHudInsetX");
-		const hudY = params.get("uzuHudInsetY");
-		const { x: fallbackX, y: fallbackY } = calcHudInsets(params);
-		document.documentElement.style.setProperty("--uzu-hud-inset-x", `${hudX ?? fallbackX}px`);
-		document.documentElement.style.setProperty("--uzu-hud-inset-y", `${hudY ?? fallbackY}px`);
+		applyInsets(params);
 		onPauseChange((paused) => {
 			sendRaw("sdk", "pauseState", {
 				paused,
@@ -1993,13 +1958,6 @@ function init(opts) {
 		sendRaw("sdk", "ready", {});
 		_initialized = true;
 	}
-	if (!_usesRun) {
-		const roomIdParam = params.get("roomId");
-		if (roomIdParam) {
-			if (_wsEndpoint) connectRoom(roomIdParam);
-			else console.warn("[SDK] roomId is present but server is not configured — skipping Relay connection");
-		}
-	}
 	if (!_usesRun) attachDevHooksIfNotHosted();
 }
 /** game channel でカスタムメッセージを送信する。 native コマンドには使用不可。 */
@@ -2104,33 +2062,6 @@ function run(config) {
 	} 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();
 }
-function sync(config) {
-	_usesRun = true;
-	const params = new URLSearchParams(window.location.search);
-	if (!isHosted) return;
-	init();
-	const origOnState = config.onState;
-	const wrappedConfig = {
-		...config,
-		onState(state, myPlayerId, serverTime) {
-			_lastStateSnap = {
-				state,
-				serverTime,
-				myId: myPlayerId
-			};
-			origOnState(state, myPlayerId, serverTime);
-			notifyDevSnapshot(state);
-		}
-	};
-	const roomId = params.get("roomId");
-	if (!roomId) _syncHandle = syncLocal(wrappedConfig);
-	else if (_syncEndpoint) {
-		const { seatId, players } = resolveSeatParams(params);
-		const { ws } = syncOnline(wrappedConfig, _syncEndpoint, roomId, seatId, players);
-		_syncWs = ws;
-	} else throw new Error("[UZU SDK] roomId is set but ?server= is missing. Multiplayer sync requires a WebSocket server URL — pass ?server=ws://host:port in the URL.");
-	attachDevHooksIfNotHosted();
-}
 /**
 * 自分の席種別を URL から取り出す。
 *
@@ -2149,13 +2080,11 @@ function resolveSeatKind(params) {
 *
 * roster (`?players=`) に自席が居ないことは異常ではない。観測者はそもそも roster に
 * 載らないまま接続してくる。
-*
-* 移行期: 旧ホスト (デプロイ前の mobile / uzutokyo / emulator) は `?seats=` で送ってくる。
 */
 function 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") ?? params.get("seats");
+	const json = params.get("players");
 	if (!json) throw new Error("[UZU SDK] players is required. Pass ?players=[...] in the URL.");
 	return {
 		seatId,
@@ -2167,33 +2096,6 @@ function resolveSeatParams(params) {
 		}))
 	};
 }
-function requireEndpoint(endpoint, name) {
-	if (!endpoint) throw new Error(`[UZU SDK] ${name} is not configured. Pass ?server=ws://host:port or call init({ wsEndpoint, syncEndpoint }).`);
-	return endpoint;
-}
-function connectRoom(roomId) {
-	const { seatId } = resolveSeatParams(new URLSearchParams(window.location.search));
-	const wsParams = new URLSearchParams({ playerId: seatId });
-	const wsUrl = `${requireEndpoint(_wsEndpoint, "wsEndpoint")}/${roomId}?${wsParams}`;
-	console.log(`[SDK] 🔗 connectRoom wsUrl=${wsUrl}`);
-	const ws = new ReconnectableWebSocket(wsUrl);
-	ws.addEventListener("message", (ev) => {
-		let parsed;
-		try {
-			parsed = JSON.parse(ev.data);
-		} catch {
-			return;
-		}
-		console.log(`[SDK] ⬅ recv ws type=${parsed.type}`, JSON.stringify(parsed));
-		if (parsed.type === "__room_init") {
-			const myId = parsed.myId;
-			console.log(`[SDK] ✅ Room initialized myId=${myId}`);
-			_room = new Room(ws, myId);
-			_onRoomCallbacks.forEach((cb) => cb(_room));
-			_onRoomCallbacks = [];
-		} else if (parsed.type === "__reconnected") console.log(`[SDK] 🔄 Room reconnected`);
-	});
-}
 /** 内部送信関数。 channel + type + payload のエンベロープで送信する。 */
 function sendRaw(channel, type, payload) {
 	const msg = {
@@ -2214,10 +2116,6 @@ function handleMessage(msg) {
 				console.log(`[SDK] 🔧 handleMessage sdk/getState → responding`);
 				sendRaw("sdk", "stateResponse", { state: _lastStateSnap });
 				return;
-			case "clearState":
-				console.log(`[SDK] 🗑 handleMessage sdk/clearState → forwarding to server`);
-				if (_syncWs && _syncWs.connectionState === "connected") _syncWs.send(JSON.stringify({ type: "__clear_state" }));
-				return;
 			case "playersChanged": {
 				const players = payload?.players ?? {};
 				_playersChangedHandlers.forEach((fn) => fn(players));
@@ -2231,6 +2129,9 @@ function handleMessage(msg) {
 				console.log(`[SDK] ▶️ handleMessage sdk/requestResume`);
 				requestResume();
 				return;
+			case "insetsChanged":
+				handleInsetsChanged(payload ?? {});
+				return;
 		}
 		return;
 	}
@@ -2241,32 +2142,5 @@ function handleMessage(msg) {
 		return;
 	}
 }
-const GAP = 6;
-const ACTION_ITEM_WIDTH = 38;
-/**
-* HUD 回避領域の右下座標を算出する。
-* クエリパラメータに uzuHudInsetX/Y がない場合のフォールバック値として使用。
-*
-* 前提: UZU ボタンは常に表示される (onMenuPressed は常に非 null)。
-* Dart 側の HudInsets.x() は hasMenu=false を扱えるが、
-* フォールバック計算では安全側に倒して常に UZU ボタンありで算出する。
-*
-* - players が取得できる場合: 2人以上→アクション数2、1人→アクション数0
-* - players が取得できない場合: アクション数2 (安全側に倒す)
-*/
-function calcHudInsets(params) {
-	const y = 52;
-	let actionCount = 2;
-	const json = params.get("players") ?? params.get("seats");
-	if (json) try {
-		actionCount = JSON.parse(json).length >= 2 ? 2 : 0;
-	} catch {}
-	let x = 56;
-	if (actionCount > 0) x += GAP + ACTION_ITEM_WIDTH * actionCount;
-	return {
-		x,
-		y
-	};
-}
 //#endregion
-export { DEFAULT_ICON_URLS, GAME_START, ReconnectableWebSocket, Room, SERVER_TIME, SeededRandomImpl, applyJsonMergePatch, applyJsonPatch, attachDevHooks, changeRoom, createDevHooks, firstFrameReady, gameReady, gameTime, getPredictionWarnings, getRoom, init, isHosted, isPaused, isServerOnlyAction, minus, on, onPauseChange, onPlayersChanged, onRoom, playBgm, playSound, plus, run, send, serverOnly, setMicEnabled, stopBgm, sub, sync };
+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 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uzuhq/code-sdk",
-  "version": "0.8.4",
+  "version": "0.8.6",
   "description": "UZU PlayScreen SDK - Flutter ↔ JS ゲーム通信ライブラリ",
   "type": "module",
   "exports": {