@uzuhq/code-sdk 0.8.9 → 0.8.10

package/dist/dev-globals.d.ts

@@ -1,4 +1,4 @@
-import { r as UzuDevHooks } from "./dev-hooks-B9mpXwaP.js";
+import { r as UzuDevHooks } from "./dev-hooks-7UDN8Xac.js";
 //#region src/dev-globals.d.ts
 declare global {
   interface Window {

package/dist/{dev-hooks-B9mpXwaP.d.ts → dev-hooks-7UDN8Xac.d.ts}

@@ -1,81 +1,3 @@
-//#region src/dev-state-patch.d.ts
-/**
- * `__uzu_dev.mergeRawState` / `__uzu_dev.patchRawState` の中身。
- * scenario state を「object 階層の部分更新 (RFC 7396)」と「array 要素単体の書換
- * 含む path-based ops (RFC 6902)」で書き換えるための utility。
- */
-/**
- * RFC 7396 風 Merge Patch。
- *
- * RFC 7396 strict との差分:
- * - `null` は target 側の **削除ではなく** null をセットする (`timerEndsAt: null`
- *   のような nullable field を狙い撃ちするユースケースを優先)
- * - 値を削除したいときは {@link JsonPatchOp} の `remove` を使う
- *
- * Generic は使い手側の type を残すための shape ヒントで、ランタイム上は
- * `Record<string, unknown>` と等価。
- */
-type JsonMergePatch<S = unknown> = Partial<{ [K in keyof S]: S[K] extends unknown[] ? S[K] : S[K] extends object ? JsonMergePatch<S[K]> : S[K] | null; }> & Record<string, unknown>;
-/**
- * RFC 6902 JSON Patch operation。
- *
- * - `add` / `replace` / `test`: `value` 必須
- * - `remove`: `value` / `from` 不要
- * - `move` / `copy`: `from` 必須 (JSON Pointer)
- * - `path` は JSON Pointer (例: `/board/1/4`、root は空文字)
- */
-type JsonPatchOp = {
-  op: 'add';
-  path: string;
-  value: unknown;
-} | {
-  op: 'remove';
-  path: string;
-} | {
-  op: 'replace';
-  path: string;
-  value: unknown;
-} | {
-  op: 'move';
-  path: string;
-  from: string;
-} | {
-  op: 'copy';
-  path: string;
-  from: string;
-} | {
-  op: 'test';
-  path: string;
-  value: unknown;
-};
-/**
- * RFC 7396 (Merge Patch) を target に in-place 適用する。
- *
- * 規則:
- * - `undefined` は no-op (key 自体を patch から落としたのと同じ)
- * - `null` は **null をセット** (RFC 7396 strict と異なる、deletion はしない)
- * - patch が object かつ target も object → 再帰 merge
- * - patch が array → atomic replace (要素単位 merge なし、RFC 7396 spec 通り)
- * - patch が primitive → overwrite
- * - **target が array で patch が non-array object** → throw (silent な
- *   `[..., ...]` → `{ "0": ..., "1": ... }` 化を防ぐ)
- *
- * 型 mismatch (例: object → primitive) は overwrite で許可する。
- */
-declare function applyJsonMergePatch(target: Record<string, unknown>, patch: JsonMergePatch): void;
-/**
- * RFC 6902 (JSON Patch) operations を target に in-place 適用する。
- *
- * 1 op でも失敗したら **その時点で throw** する (RFC 6902 spec: operations は
- * sequentially evaluate、失敗時の rollback は規定なし)。caller が atomic に
- * したいなら state を事前に snapshot しておく。
- *
- * root pointer (`''`) は本実装では `add` / `replace` のみ許可し、
- * doc のフィールドを丸ごと差し替える形で動く (= 結局 `setRawState` で十分な
- * ケースなので、わざわざ `patchRawState` で使うことはほぼない)。
- */
-declare function applyJsonPatch(target: Record<string, unknown>, ops: JsonPatchOp[]): void;
-//#endregion
 //#region ../engine-core/src/game-time.d.ts
 /**
  * @docs
@@ -141,25 +63,25 @@ declare const GAME_START: GameTime;
  * 載らないまま接続してくるので、シナリオは「roster に居ない = 観測者」で判別する。
  * 席種別は roster エントリではなく自分の `SeatKind` として渡る。
  */
-interface Seat {
+type Seat = {
   id: string;
   nickname: string;
   iconUrl: string;
   /** ホスト（mobile / emulator）から渡される、選択済みキャラクターの ID。未選択時は undefined。 */
   characterId?: string;
-}
+};
 type Emit = (eventName: string, data?: Record<string, unknown>) => void;
 /** dev harness で観測される 1 件の emit。`data` は `emit(name)` 省略時に空 object になる。 */
-interface ServerEvent {
+type ServerEvent = {
   name: string;
   data: Record<string, unknown>;
-}
-interface SeededRandom {
+};
+type SeededRandom = {
   float(): number;
   int(max: number): number;
   pick<T>(array: T[]): T;
   shuffle<T>(array: T[]): T[];
-}
+};
 /**
  * 素の action handler の実行文脈。空なのは意図的。
  *
@@ -168,7 +90,7 @@ interface SeededRandom {
  * オンラインの先読みだけ値がズレる、という一番気付きにくい形で壊れる。
  * そういう値が要る処理は `serverActions` 側に書く。
  */
-interface ActionContext {
+type ActionContext = {
   /**
    * 現在のゲーム内時刻。先読みではクロックオフセットからの推定値。
    *
@@ -181,21 +103,21 @@ interface ActionContext {
   /** 今から `d` ms 後のゲーム内時刻。締切を state へ置くときに使う。 */
   after(d: Duration): GameTime;
   emit: Emit;
-}
+};
 /** `deadlines` handler の実行文脈。サーバーでしか走らないので tick 以外を渡せる。 */
-interface DeadlineContext {
+type DeadlineContext = {
   /** 発火時点のゲーム内時刻。サーバー専用なので常に正確。 */
   time: GameTime;
   /** 今から `d` ms 後のゲーム内時刻。次の締切を state へ置き直すときに使う。 */
   after(d: Duration): GameTime;
   random: SeededRandom;
   emit: Emit;
-}
+};
 /** `deadlines` handler の引数。 */
-interface DeadlineArgs<S> {
+type DeadlineArgs<S> = {
   state: S;
   ctx: DeadlineContext;
-}
+};
 /**
  * サーバー権威の締切。
  *
@@ -206,7 +128,7 @@ interface DeadlineArgs<S> {
  * 締切は state から導出するので、予約を張り替える処理を書かなくてよい。action が
  * throw して state が巻き戻れば、締切も一緒に巻き戻る。
  */
-interface Deadline<S> {
+type Deadline<S> = {
   /**
    * 締切のゲーム内時刻。締切が無いときは null / undefined。
    *
@@ -230,9 +152,9 @@ interface Deadline<S> {
    * 呼ぶので、handler 側で二重発火を弾く必要は無い。
    */
   handler(args: DeadlineArgs<S>): void;
-}
+};
 /** `serverActions` handler の実行文脈。サーバーでしか走らないので tick と乱数を渡せる。 */
-interface ServerActionContext {
+type ServerActionContext = {
   tick: number;
   random: SeededRandom;
   /** 現在のゲーム内時刻。同じ dispatch の `actions` に渡る `ctx.time` と同一値。 */
@@ -240,7 +162,7 @@ interface ServerActionContext {
   /** 今から `d` ms 後のゲーム内時刻。 */
   after(d: Duration): GameTime;
   emit: Emit;
-}
+};
 /** @deprecated `ServerActionContext` を使う。 */
 type ServerOnlyActionContext = ServerActionContext;
 /**
@@ -249,12 +171,12 @@ type ServerOnlyActionContext = ServerActionContext;
  * オブジェクトなのは使うものだけ書けるようにするため。`ctx` を入れ子で残しているのは、
  * 実行環境が与えるものをひとまとまりで helper へ渡せるようにするため。
  */
-interface ActionArgs<S, P = any> {
+type ActionArgs<S, P = any> = {
   state: S;
   payload: P;
   playerId: string;
   ctx: ActionContext;
-}
+};
 /**
  * `P` は既定が `any` なので、 注釈のない handler はそのまま動く。 payload の形を
  * 書いた handler だけが検査され、 送信側もその型で縛られる。 全部に注釈しないと
@@ -262,12 +184,12 @@ interface ActionArgs<S, P = any> {
  */
 type ActionHandler<S, P = any> = (args: ActionArgs<S, P>) => void;
 /** `serverActions` handler の引数。`ctx` にサーバー限定の tick / random が入る。 */
-interface ServerActionArgs<S, P = any> {
+type ServerActionArgs<S, P = any> = {
   state: S;
   payload: P;
   playerId: string;
   ctx: ServerActionContext;
-}
+};
 type ServerActionHandler<S, P = any> = (args: ServerActionArgs<S, P>) => Promise<void> | void;
 /** @deprecated `ServerActionHandler` を使う。 */
 type ServerOnlyActionHandlerFn<S> = ServerActionHandler<S>;
@@ -278,8 +200,14 @@ type ServerOnlyActionHandlerFn<S> = ServerActionHandler<S>;
 type ServerOnlyAction<S> = ServerActionHandler<S> & {
   readonly __serverOnly: true;
 };
+/**
+ * プレイヤーごとの、直近に届いた `__input` の中身。値の形はシナリオが決める。
+ *
+ * `update()` の ctx と、それを組み立てる各ランタイムが同じ型を見るために名前を付けてある。
+ */
+type PlayerInputs = Record<string, Record<string, any>>;
 /** `update()` の ctx。サーバーでしか走らないので tick / random / playerInputs を持つ。 */
-interface UpdateContext {
+type UpdateContext = {
   random: SeededRandom;
   tick: number;
   /** 現在のゲーム内時刻。update はサーバーでしか走らないので常に正確。 */
@@ -287,30 +215,30 @@ interface UpdateContext {
   /** 今から `d` ms 後のゲーム内時刻。 */
   after(d: Duration): GameTime;
   emit: Emit;
-  playerInputs: Record<string, Record<string, any>>;
-}
-interface UpdateArgs<S> {
+  playerInputs: PlayerInputs;
+};
+type UpdateArgs<S> = {
   state: S;
   ctx: UpdateContext;
-}
+};
 /**
  * `setup()` の実行文脈。サーバーでしか走らないので実時刻をそのまま渡せる。
  *
  * `emit` は無い。まだ誰も購読していない時点なので、鳴らしても届かない。
  */
-interface SetupContext {
+type SetupContext = {
   random: SeededRandom;
   /** ゲーム内時刻。setup は時計の起点なので必ず `0`。 */
   time: GameTime;
   /** 今から `d` ms 後のゲーム内時刻。setup では `d` そのものになる。 */
   after(d: Duration): GameTime;
-}
+};
 /** `setup()` の引数。 */
-interface SetupArgs {
+type SetupArgs = {
   /** 配役を受け取る参加者。観測者は含まれない。 */
   players: Seat[];
   ctx: SetupContext;
-}
+};
 /**
  * `actions` の形だけを見る緩い制約。
  *
@@ -321,7 +249,7 @@ interface SetupArgs {
 type ActionMap<S> = Record<string, (args: ActionArgs<S, any>) => void>;
 /** `serverActions` 用。 ActionMap と同じ理由で payload は any のままにする。 */
 type ServerActionMap<S> = Record<string, (args: ServerActionArgs<S, any>) => Promise<void> | void>;
-interface GameLogic<S, A extends ActionMap<S> = ActionMap<S>, SA extends ServerActionMap<S> = ServerActionMap<S>> {
+type GameLogic<S, A extends ActionMap<S> = ActionMap<S>, SA extends ServerActionMap<S> = ServerActionMap<S>> = {
   setup(args: SetupArgs): S;
   /**
    * クライアント先読みとサーバーの両方で走る handler。決定的でなければならない。
@@ -348,7 +276,7 @@ interface GameLogic<S, A extends ActionMap<S> = ActionMap<S>, SA extends ServerA
    */
   deadlines?: Record<string, Deadline<S>>;
   tickRate?: number;
-}
+};
 /** デフォルトのプレイヤーアイコン 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
@@ -361,7 +289,7 @@ type PlayScreenMessage = {
 /** ブリッジメッセージのチャンネル */
 type BridgeChannel = 'sdk' | 'game';
 /** ワイヤーフォーマット: { channel, type, payload, playerId? } */
-interface BridgeMessage {
+type BridgeMessage = {
   channel: BridgeChannel;
   type: string;
   payload: Record<string, unknown>;
@@ -377,7 +305,7 @@ interface BridgeMessage {
    * （受信側は playerId 無し = 旧 SDK ビルドとして扱う）。
    */
   playerId?: string;
-}
+};
 /**
  * 自分の席種別。ホストが iframe URL の `?seatKind=` で伝える。
  *
@@ -390,14 +318,14 @@ interface BridgeMessage {
  */
 type SeatKind = 'player' | 'spectator' | 'admin';
 /** プレイヤーごとのリアルタイム状態 */
-interface PlayerVoiceState {
+type PlayerVoiceState = {
   /** 音声状態。音声通話に未接続の場合は null */
   audioStatus: 'speaking' | 'listening' | 'muted' | 'unstable' | null;
-}
+};
 /** @deprecated 旧形式。新コードでは onPlayersChanged() と PlayerVoiceState を使用 */
-interface PlayersChangedMessage {
+type PlayersChangedMessage = {
   players: Record<string, PlayerVoiceState>;
-}
+};
 /**
  * events handler。
  *
@@ -411,13 +339,13 @@ type EventHandler = (data: Record<string, unknown>) => void;
  * 先読みは外れることがあり、実行してしまったものは取り消せない。取り消せない副作用
  * (analytics / 実績解除 / 長い演出) は必ず `predict: false` にすること。
  */
-interface EventSubscription {
+type EventSubscription = {
   /** 先読み時点で実行してよいか。宣言必須。 */
   predict: boolean;
   handler: EventHandler;
-}
+};
 /** action 名から payload 型を引く表。 注釈のない handler は `any` になる。 */
-type PayloadMap<A> = { [K in keyof A]: A[K] extends ((args: infer G) => any) ? G extends {
+type PayloadMap<A> = { [K in keyof A]: A[K] extends ((args: infer G) => unknown) ? G extends {
   payload: infer P;
 } ? P : never : never; };
 /**
@@ -428,7 +356,7 @@ type PayloadMap<A> = { [K in keyof A]: A[K] extends ((args: infer G) => any) ? G
  * 省略できるようにする。
  */
 type SendAction<A> = <K extends keyof A & string>(...args: undefined extends PayloadMap<A>[K] ? [type: K, payload?: PayloadMap<A>[K]] : [type: K, payload: PayloadMap<A>[K]]) => void;
-interface GameConfig<S, A extends ActionMap<S> = ActionMap<S>, SA extends ServerActionMap<S> = ServerActionMap<S>> extends ConnectionCallbacks {
+type GameConfig<S, A extends ActionMap<S> = ActionMap<S>, SA extends ServerActionMap<S> = ServerActionMap<S>> = {
   logic: GameLogic<S, A, SA>;
   /**
    * `mySeatKind` は自分の席種別。roster に自分が居ない (= 観測者) ときに、GM ビューと
@@ -454,12 +382,12 @@ interface GameConfig<S, A extends ActionMap<S> = ActionMap<S>, SA extends Server
    * iframe 内部の `window.innerWidth/Height` を保証する。
    */
   devMinIframeShortEdge?: number;
-}
+} & ConnectionCallbacks;
 type ConnectionState = 'connecting' | 'connected' | 'reconnecting' | 'disconnected';
-interface ConnectionCallbacks {
+type ConnectionCallbacks = {
   /** WebSocket 接続状態が変化した時に呼ばれる */
   onConnectionStateChange?: (state: ConnectionState) => void;
-}
+};
 //#endregion
 //#region src/host-globals.d.ts
 declare global {
@@ -474,36 +402,114 @@ declare global {
 }
 //#endregion
 //#region src/dev-prediction-traps.d.ts
-interface PredictionWarning {
+type PredictionWarning = {
   /** 呼び出した action 名。描画経路では `'(render)'`。 */
   action: string;
   /** 呼ばれた API 名 (`'Date.now()'` など) */
   api: string;
-}
+};
 /** 検出済みの警告一覧。`__uzu_dev.getPredictionWarnings()` から E2E で assert する用。 */
 declare const getPredictionWarnings: () => readonly PredictionWarning[];
 //#endregion
+//#region src/dev-state-patch.d.ts
+/**
+ * `__uzu_dev.mergeRawState` / `__uzu_dev.patchRawState` の中身。
+ * scenario state を「object 階層の部分更新 (RFC 7396)」と「array 要素単体の書換
+ * 含む path-based ops (RFC 6902)」で書き換えるための utility。
+ */
+/**
+ * RFC 7396 風 Merge Patch。
+ *
+ * RFC 7396 strict との差分:
+ * - `null` は target 側の **削除ではなく** null をセットする (`timerEndsAt: null`
+ *   のような nullable field を狙い撃ちするユースケースを優先)
+ * - 値を削除したいときは {@link JsonPatchOp} の `remove` を使う
+ *
+ * Generic は使い手側の type を残すための shape ヒントで、ランタイム上は
+ * `Record<string, unknown>` と等価。
+ */
+type JsonMergePatch<S = unknown> = Partial<{ [K in keyof S]: S[K] extends unknown[] ? S[K] : S[K] extends object ? JsonMergePatch<S[K]> : S[K] | null; }> & Record<string, unknown>;
+/**
+ * RFC 6902 JSON Patch operation。
+ *
+ * - `add` / `replace` / `test`: `value` 必須
+ * - `remove`: `value` / `from` 不要
+ * - `move` / `copy`: `from` 必須 (JSON Pointer)
+ * - `path` は JSON Pointer (例: `/board/1/4`、root は空文字)
+ */
+type JsonPatchOp = {
+  op: 'add';
+  path: string;
+  value: unknown;
+} | {
+  op: 'remove';
+  path: string;
+} | {
+  op: 'replace';
+  path: string;
+  value: unknown;
+} | {
+  op: 'move';
+  path: string;
+  from: string;
+} | {
+  op: 'copy';
+  path: string;
+  from: string;
+} | {
+  op: 'test';
+  path: string;
+  value: unknown;
+};
+/**
+ * RFC 7396 (Merge Patch) を target に in-place 適用する。
+ *
+ * 規則:
+ * - `undefined` は no-op (key 自体を patch から落としたのと同じ)
+ * - `null` は **null をセット** (RFC 7396 strict と異なる、deletion はしない)
+ * - patch が object かつ target も object → 再帰 merge
+ * - patch が array → atomic replace (要素単位 merge なし、RFC 7396 spec 通り)
+ * - patch が primitive → overwrite
+ * - **target が array で patch が non-array object** → throw (silent な
+ *   `[..., ...]` → `{ "0": ..., "1": ... }` 化を防ぐ)
+ *
+ * 型 mismatch (例: object → primitive) は overwrite で許可する。
+ */
+declare const applyJsonMergePatch: (target: Record<string, unknown>, patch: JsonMergePatch) => void;
+/**
+ * RFC 6902 (JSON Patch) operations を target に in-place 適用する。
+ *
+ * 1 op でも失敗したら **その時点で throw** する (RFC 6902 spec: operations は
+ * sequentially evaluate、失敗時の rollback は規定なし)。caller が atomic に
+ * したいなら state を事前に snapshot しておく。
+ *
+ * root pointer (`''`) は本実装では `add` / `replace` のみ許可し、
+ * doc のフィールドを丸ごと差し替える形で動く (= 結局 `setRawState` で十分な
+ * ケースなので、わざわざ `patchRawState` で使うことはほぼない)。
+ */
+declare const applyJsonPatch: (target: Record<string, unknown>, ops: JsonPatchOp[]) => void;
+//#endregion
 //#region src/dev-hooks.d.ts
-interface UzuDevHooks<S = unknown> {
+type UzuDevHooks<S = unknown> = {
   /** 現在の per-player 視点 snapshot (onState コールバックの最新値)。未初期化なら null。 */
-  getSnapshot(): unknown;
+  getSnapshot: () => unknown;
   /** 生 server-side state (dev/local mode のみ。online ServerAction では null)。 */
-  getRawState(): S | null;
-  playerId(): string | null;
+  getRawState: () => S | null;
+  playerId: () => string | null;
   /**
    * 親 frame で virtual server を実体化した時の seed。
    * 親 frame の `runDevHarness({ server })` 経由でしか attach されず、子 iframe の
    * dev hooks 側では undefined。bug report 用に `?__dev_seed=<value>` として
    * 貼り付けやすい uint32 を返す。
    */
-  getSeed?(): number;
+  getSeed?: () => number;
   /**
    * 素の action handler が先読み実行中に実時刻 / 乱数を読んだ記録。
    *
    * 先読みはサーバーと同じ結果を再現できることが前提なので、ここに何か入っていたら
    * そのシナリオはオンラインでだけ予測がズレる。E2E で `[]` を assert すると回帰を防げる。
    */
-  getPredictionWarnings(): readonly PredictionWarning[];
+  getPredictionWarnings: () => readonly PredictionWarning[];
   /**
    * Server-side で action を直接 dispatch する。
    *
@@ -517,11 +523,11 @@ interface UzuDevHooks<S = unknown> {
    * 運用も可)。turn-based の E2E (将棋・人狼・カードゲーム) で「先手 → 後手」
    * を 1 frame から打ち分けたい時に使う。
    */
-  send?(args: {
+  send?: (args: {
     as: string;
     type: string;
     payload?: Record<string, unknown>;
-  }): Promise<void>;
+  }) => Promise<void>;
   /**
    * 生 state を **全置換** する。state owner の frame (= dev/local) のみ。
    *
@@ -530,7 +536,7 @@ interface UzuDevHooks<S = unknown> {
    * 部分更新は {@link mergeRawState} を、array 要素単体の書換は
    * {@link patchRawState} を使うこと。
    */
-  setRawState?(state: S): Promise<void>;
+  setRawState?: (state: S) => Promise<void>;
   /**
    * RFC 7396 風 JSON Merge Patch で生 state を部分更新する (dev/local のみ)。
    *
@@ -542,7 +548,7 @@ interface UzuDevHooks<S = unknown> {
    * array が pure object に化ける silent な破壊を防ぐため、`array に
    * non-array object patch を当てる`と **throw** する。
    */
-  mergeRawState?(patch: JsonMergePatch<S>): Promise<void>;
+  mergeRawState?: (patch: JsonMergePatch<S>) => Promise<void>;
   /**
    * RFC 6902 JSON Patch (path-based ops) で生 state を更新する (dev/local のみ)。
    *
@@ -552,7 +558,7 @@ interface UzuDevHooks<S = unknown> {
    *
    * 局面の部分更新 (将棋の一手・盤面の cell 単体書換など) に使う。
    */
-  patchRawState?(ops: JsonPatchOp[]): Promise<void>;
+  patchRawState?: (ops: JsonPatchOp[]) => Promise<void>;
   /**
    * snapshot 更新を event-driven に listen する。返り値は unsubscribe 関数。
    *
@@ -563,11 +569,11 @@ interface UzuDevHooks<S = unknown> {
    * cb には authoritative state の生参照 (run devHarness 親では `getRawState()` と
    * 同一) が渡るので mutate しない。
    */
-  subscribeSnapshot(cb: (snapshot: unknown) => void): () => void;
+  subscribeSnapshot: (cb: (snapshot: unknown) => void) => () => void;
   /** snapshot が predicate を満たすまで待つ。default 10 秒 timeout。 */
-  waitForSnapshot(predicate: (snapshot: unknown) => boolean, options?: {
+  waitForSnapshot: (predicate: (snapshot: unknown) => boolean, options?: {
     timeoutMs?: number;
-  }): Promise<unknown>;
+  }) => Promise<unknown>;
   /**
    * action handler / `logic.update` の `emit` を listen する。callback には 1 回の
    * dispatch / tick 内で発火した event を batch でまとめて渡す。**run devHarness 親
@@ -578,7 +584,7 @@ interface UzuDevHooks<S = unknown> {
    * したい場合に使う。`config.events` callback とは独立経路で、scenario callback の
    * throw も subscriber 通知を止めない。unsubscribe 関数を返す。
    */
-  subscribeEvents?(cb: (events: readonly ServerEvent[]) => void): () => void;
+  subscribeEvents?: (cb: (events: readonly ServerEvent[]) => void) => () => void;
   /**
    * tick loop を pause する (run() devHarness 親 frame のみ)。
    * 時間駆動の `logic.update` が走らなくなり、shogi の持ち時間減算等の自動進行を
@@ -586,15 +592,15 @@ interface UzuDevHooks<S = unknown> {
    * tick loop を持たない frame (子 iframe / sync 単独 frame / online) と
    * `tickRate <= 0` の scenario では undefined / no-op。
    */
-  pauseTick?(): void;
+  pauseTick?: () => void;
   /** pauseTick を解除する。 */
-  resumeTick?(): void;
+  resumeTick?: () => void;
   /** 手動で n tick 進める。default n = 1。 */
-  stepTick?(n?: number): void;
+  stepTick?: (n?: number) => void;
   /** 現在の tick 値を返す。tick loop を持たない frame では undefined。 */
-  getCurrentTick?(): number;
+  getCurrentTick?: () => number;
   /** pauseTick で止まっているかどうか。 */
-  isTickPaused?(): boolean;
+  isTickPaused?: () => boolean;
   /**
    * `logic.setup` を再実行して virtual server を fresh start させる。
    * run() devHarness の親 frame のみ attach される (state owner でしか reset 不可)。
@@ -605,10 +611,10 @@ interface UzuDevHooks<S = unknown> {
    *
    * pause 状態は維持される。`logic.setup` が副作用を持つ場合は再呼出で副作用が再発火する。
    */
-  reset?(opts?: {
+  reset?: (opts?: {
     seed?: number | 'random';
-  }): void;
-}
+  }) => void;
+};
 declare global {
   interface Window {
     __uzu_dev?: UzuDevHooks;
@@ -621,23 +627,23 @@ declare global {
  *
  * state 書き換え API は state owner frame のみ提供する。
  */
-interface RunHandle<S = unknown> {
+type RunHandle<S = unknown> = {
   /** 内部 state の getter (dev hooks 用)。host iframe を持たない側では undefined */
-  getRawState?(): S | null;
+  getRawState?: () => S | null;
   /** 生 state 全置換。host iframe を持たない側では undefined */
-  setRawState?(state: S): Promise<void>;
+  setRawState?: (state: S) => Promise<void>;
   /** RFC 7396 風 Merge Patch。host iframe を持たない側では undefined */
-  mergeRawState?(patch: JsonMergePatch<S>): Promise<void>;
+  mergeRawState?: (patch: JsonMergePatch<S>) => Promise<void>;
   /** RFC 6902 JSON Patch。host iframe を持たない側では undefined */
-  patchRawState?(ops: JsonPatchOp[]): Promise<void>;
+  patchRawState?: (ops: JsonPatchOp[]) => Promise<void>;
   /** 既存 inputs と同等の action 送信 (dev hooks 用) */
-  sendAction(type: string, payload?: Record<string, unknown>): void;
-}
+  sendAction: (type: string, payload?: Record<string, unknown>) => void;
+};
 /**
  * dev-hooks.ts から見た「SDK 内部のコンテキスト」。
  * 各 run/* モジュールがこの形の handle を組み立てて attachDevHooks に渡す。
  */
-interface DevHooksCtx<S = unknown> {
+type DevHooksCtx<S = unknown> = {
   /** 最新 snapshot (per-player view)。未初期化なら null。 */
   getSnapshot(): unknown;
   /** 生 state getter (dev/local mode のみ)。 */
@@ -655,11 +661,11 @@ interface DevHooksCtx<S = unknown> {
    * 提供する。それ以外のモードでは省略 (= `__uzu_dev.send` も生えない)。
    * `args.as` で server-side dispatch の `from` を指定する (必須)。
    */
-  sendAction?(args: {
+  sendAction?: (args: {
     as: string;
     type: string;
     payload?: Record<string, unknown>;
-  }): Promise<void>;
+  }) => Promise<void>;
   /** snapshot 更新を listen する。unsubscribe 関数を返す。 */
   subscribeSnapshot(cb: (snapshot: unknown) => void): () => void;
   /**
@@ -667,7 +673,7 @@ interface DevHooksCtx<S = unknown> {
    * frame の `DevHostHandle` のみが提供する。それ以外のモードでは省略
    * (= `__uzu_dev.subscribeEvents` も生えない)。
    */
-  subscribeEvents?(cb: (events: readonly ServerEvent[]) => void): () => void;
+  subscribeEvents?: (cb: (events: readonly ServerEvent[]) => void) => () => void;
   /** dev harness 親 frame の virtual server seed。親 attach 経路のみ。 */
   getSeed?: () => number;
   pauseTick?: () => void;
@@ -682,8 +688,8 @@ interface DevHooksCtx<S = unknown> {
   reset?: (opts?: {
     seed?: number | 'random';
   }) => void;
-}
-declare function createDevHooks<S>(ctx: DevHooksCtx<S>): UzuDevHooks<S>;
-declare function attachDevHooks<S>(ctx: DevHooksCtx<S>): void;
+};
+declare const createDevHooks: <S>(ctx: DevHooksCtx<S>) => UzuDevHooks<S>;
+declare const attachDevHooks: <S>(ctx: DevHooksCtx<S>) => void;
 //#endregion
-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 };
+export { plus as $, Deadline as A, ServerActionMap as B, SeatKind as C, ActionHandler as D, ActionContext as E, Seat as F, SetupArgs as G, ServerOnlyAction as H, SeededRandom as I, UpdateContext as J, SetupContext as K, ServerActionArgs as L, DeadlineContext as M, Emit as N, ActionMap as O, GameLogic as P, minus as Q, ServerActionContext as R, PlayersChangedMessage as S, ActionArgs as T, ServerOnlyActionContext as U, ServerEvent as V, ServerOnlyActionHandlerFn as W, GAME_START as X, Duration as Y, GameTime as Z, EventSubscription as _, createDevHooks as a, PlayScreenMessage as b, applyJsonMergePatch as c, getPredictionWarnings as d, sub as et, BridgeChannel as f, EventHandler as g, ConnectionState as h, attachDevHooks as i, DeadlineArgs as j, DEFAULT_ICON_URLS as k, applyJsonPatch as l, ConnectionCallbacks as m, RunHandle as n, JsonMergePatch as o, BridgeMessage as p, UpdateArgs as q, UzuDevHooks as r, JsonPatchOp as s, DevHooksCtx as t, PredictionWarning as u, GameConfig as v, SendAction as w, PlayerVoiceState as x, PayloadMap as y, ServerActionHandler as z };