@uzuhq/code-sdk 0.8.8 → 0.8.10

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-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-B9mpXwaP.js";
+import { $ as plus, A as Deadline, B as ServerActionMap, C as SeatKind, D as ActionHandler, E as ActionContext, F as Seat, G as SetupArgs, H as ServerOnlyAction, I as SeededRandom, J as UpdateContext, K as SetupContext, L as ServerActionArgs, M as DeadlineContext, N as Emit, O as ActionMap, P as GameLogic, Q as minus, R as ServerActionContext, S as PlayersChangedMessage, T as ActionArgs, U as ServerOnlyActionContext, V as ServerEvent, W as ServerOnlyActionHandlerFn, X as GAME_START, Y as Duration, Z as GameTime, _ as EventSubscription, a as createDevHooks, b as PlayScreenMessage, c as applyJsonMergePatch, d as getPredictionWarnings, et as sub, f as BridgeChannel, g as EventHandler, h as ConnectionState, i as attachDevHooks, j as DeadlineArgs, k as DEFAULT_ICON_URLS, l as applyJsonPatch, m as ConnectionCallbacks, n as RunHandle, o as JsonMergePatch, p as BridgeMessage, q as UpdateArgs, r as UzuDevHooks, s as JsonPatchOp, t as DevHooksCtx, u as PredictionWarning, v as GameConfig, w as SendAction, x as PlayerVoiceState, y as PayloadMap, z as ServerActionHandler } from "./dev-hooks-7UDN8Xac.js";
 //#region ../engine-core/src/json-patch.d.ts
 /**
  * @docs
@@ -7,11 +7,11 @@ import { $ as applyJsonMergePatch, A as GameLogic, B as ServerOnlyActionHandlerF
  * state 差分同期用の JSON Patch。RFC 6902 の全 op は実装せず、
  * `compare` が生成する replace / add / remove だけを扱う。
  */
-interface Operation {
+type Operation = {
   op: 'replace' | 'add' | 'remove';
   path: string;
   value?: unknown;
-}
+};
 //#endregion
 //#region ../engine-core/src/random.d.ts
 declare class SeededRandomImpl implements SeededRandom {
@@ -36,13 +36,13 @@ declare class SeededRandomImpl implements SeededRandom {
  * serverActions: { notifyExternal: async (state) => { ... } }
  * ```
  */
-declare function serverOnly<S>(handler: ServerActionHandler<S>): ServerOnlyAction<S>;
+declare const serverOnly: <S>(handler: ServerActionHandler<S>) => ServerOnlyAction<S>;
 /**
  * handler が `serverOnly()` で wrap されているか判定する。
  *
  * 移行期の互換用。`serverActions` へ移行済みの logic では常に false になる。
  */
-declare function isServerOnlyAction<S>(handler: ActionHandler<S> | ServerActionHandler<S> | ServerOnlyAction<S> | undefined): handler is ServerOnlyAction<S>;
+declare const isServerOnlyAction: <S>(handler: ActionHandler<S> | ServerActionHandler<S> | ServerOnlyAction<S> | undefined) => handler is ServerOnlyAction<S>;
 //#endregion
 //#region src/server-clock.d.ts
 /**
@@ -51,13 +51,13 @@ declare function isServerOnlyAction<S>(handler: ActionHandler<S> | ServerActionH
  * カウントダウン描画のように毎秒/毎フレーム呼ぶ用途を想定しているので、
  * state の到着とは無関係にいつでも呼べる。
  */
-declare function gameTime(): GameTime;
+declare const gameTime: () => GameTime;
 //#endregion
 //#region src/pause-state.d.ts
 /** 緊急停止中か。 */
-declare function isPaused(): boolean;
+declare const isPaused: () => boolean;
 /** 停止状態の変化を購読する。 */
-declare function onPauseChange(cb: (paused: boolean) => void): void;
+declare const onPauseChange: (cb: (paused: boolean) => void) => void;
 //#endregion
 //#region src/reconnectable-ws.d.ts
 /**
@@ -68,7 +68,7 @@ declare function onPauseChange(cb: (paused: boolean) => void): void;
  * - 再接続中のメッセージバッファリング
  */
 type ConnectionState$1 = 'connecting' | 'connected' | 'reconnecting' | 'disconnected';
-interface ReconnectableWSOptions {
+type ReconnectableWSOptions = {
   /** 最大再接続試行回数 (default: 15) */
   maxReconnectAttempts?: number;
   /** Backoff の基準遅延 ms (default: 1000) */
@@ -87,7 +87,7 @@ interface ReconnectableWSOptions {
   shouldBuffer?: (data: string) => boolean;
   /** 接続状態変更コールバック */
   onConnectionStateChange?: (state: ConnectionState$1) => void;
-}
+};
 declare class ReconnectableWebSocket {
   private ws;
   private readonly url;
@@ -105,8 +105,8 @@ declare class ReconnectableWebSocket {
   /** WebSocket.readyState 互換 (既存コードとの互換用) */
   get readyState(): number;
   send(data: string): void;
-  addEventListener(type: 'message', handler: (ev: MessageEvent) => void): void;
-  removeEventListener(type: 'message', handler: (ev: MessageEvent) => void): void;
+  addEventListener(_type: 'message', handler: (ev: MessageEvent) => void): void;
+  removeEventListener(_type: 'message', handler: (ev: MessageEvent) => void): void;
   /** バッファをクリア（権威的 state 受信時に呼ぶ） */
   clearBuffer(): void;
   /** 全リソース解放 */
@@ -138,14 +138,14 @@ declare class ReconnectableWebSocket {
  * [csswg-drafts#4670]: https://github.com/w3c/csswg-drafts/issues/4670
  */
 /** 4 辺の inset (CSS px)。 */
-interface Insets {
+type Insets = {
   top: number;
   right: number;
   bottom: number;
   left: number;
-}
+};
 /** ホストが配る inset の全層。 */
-interface UzuInsets {
+type UzuInsets = {
   /** デバイスの safe area (ノッチ / 角丸 / ホームインジケータ)。 */
   safeArea: Insets;
   /**
@@ -158,14 +158,14 @@ interface UzuInsets {
     x: number;
     y: number;
   };
-}
+};
 /**
  * 現在の inset を返す。
  *
  * canvas / WebGL は CSS 変数で避けられないので、そこから読む口。値は初回ペイント前に
  * 確定しているので、setup の中で読んでよい。
  */
-declare function getInsets(): UzuInsets;
+declare const getInsets: () => UzuInsets;
 /**
  * inset の変化を購読する。戻り値を呼ぶと解除できる。
  *
@@ -174,30 +174,30 @@ declare function getInsets(): UzuInsets;
  *
  * 登録時に即時呼び出しはしない。初期値は [getInsets] で読むこと。
  */
-declare function onInsetsChange(cb: (insets: UzuInsets) => void): () => void;
+declare const 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 init(opts?: {
+declare const init: (_opts?: {
   playerCount?: number;
-  orientation?: 'portrait' | 'landscape';
+  orientation?: "portrait" | "landscape";
   /**
    * Dev harness の iframe inner viewport 短辺 (CSS px) の下限。default 360。
    * harness 側で参照される値で、 SDK runtime 本体は使わない。
    */
   devMinIframeShortEdge?: number;
-}): void;
+}) => void;
 /** game channel でカスタムメッセージを送信する。 native コマンドには使用不可。 */
-declare function send(type: string, payload?: Record<string, unknown>): void;
+declare const send: (type: string, payload?: Record<string, unknown>) => void;
 /** game channel のカスタムメッセージを受信する。 */
-declare function on(type: string, handler: GameMessageHandler): void;
-declare function playSound(sound: string): void;
-declare function playBgm(sound: string): void;
-declare function stopBgm(): void;
-declare function setMicEnabled(enabled: boolean): void;
-declare function changeRoom(roomId: string | null): void;
+declare const on: (type: string, handler: GameMessageHandler) => void;
+declare const playSound: (sound: string) => void;
+declare const playBgm: (sound: string) => void;
+declare const stopBgm: () => void;
+declare const setMicEnabled: (enabled: boolean) => void;
+declare const changeRoom: (roomId: string | null) => void;
 /**
  * splash 描画完了を Flutter ホストに通知する。
  *
@@ -214,7 +214,7 @@ declare function changeRoom(roomId: string | null): void;
  * requestAnimationFrame(() => firstFrameReady());
  * ```
  */
-declare function firstFrameReady(): void;
+declare const firstFrameReady: () => void;
 /**
  * ユーザー操作受付可能を Flutter ホストに通知する。
  *
@@ -231,9 +231,30 @@ declare function firstFrameReady(): void;
  * gameReady();
  * ```
  */
-declare function gameReady(): void;
+declare const gameReady: () => void;
+/**
+ * ゲームを終えてプレイ画面を閉じるよう Flutter ホストに通知する。
+ *
+ * 閉じるのは**呼んだ端末だけ**。全員を閉じたいときは、終了を表す state を全員へ配り、
+ * 各端末の `onState` から呼ぶ。ホストはイベントを終了扱いにし (finishedAt を立てるのは
+ * 最初の 1 人だけ)、呼んだプレイヤーを退出させてから画面を閉じる。
+ *
+ * 呼び出しタイミング: 結果や感想戦を見終えて閉じるときなど、シナリオとしてゲームが完全に
+ * 終わった瞬間。勝敗が決まった瞬間 (`gameover` など) に呼ぶと、結果を見る前に画面が閉じる。
+ *
+ * 対応していない古いアプリや `uzu dev` harness では何も起きない。呼んだあとも画面を
+ * 操作不能にしないこと。
+ *
+ * @example
+ * ```ts
+ * onState(state) {
+ *   if (state.debriefClosed) finishGame();
+ * }
+ * ```
+ */
+declare const finishGame: () => void;
 /** Flutter からの playersChanged メッセージを受信するハンドラを登録する。 */
-declare function onPlayersChanged(handler: PlayersChangedHandler): void;
+declare const onPlayersChanged: (handler: PlayersChangedHandler) => void;
 /**
  * `A` に既定値が要る。 TypeScript は型引数の部分推論ができないので、 既定が無いと
  * 既存の `run<State>({…})` が「2 つ必要」で落ちる。 既定を置けば型引数を書かない
@@ -243,6 +264,6 @@ declare function onPlayersChanged(handler: PlayersChangedHandler): void;
  * `keyof (A & SA)` が `string` へ潰れ、action 名の検査が丸ごと消える。
  * `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 const run: <S, A extends ActionMap<S> = ActionMap<S>, SA extends ServerActionMap<S> = Record<never, never>>(config: GameConfig<S, A, SA>) => 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 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 };
+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, finishGame, firstFrameReady, gameReady, gameTime, getInsets, getPredictionWarnings, init, isHosted, isPaused, isServerOnlyAction, minus, on, onInsetsChange, onPauseChange, onPlayersChanged, playBgm, playSound, plus, run, send, serverOnly, setMicEnabled, stopBgm, sub };