@uzuhq/code-sdk 0.7.6 → 0.8.0

package/dist/index.d.ts

@@ -1,72 +1,162 @@
+import { $ as minus, 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 GameTime, 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, b as PlayersChangedMessage, c as getPredictionWarnings, d as ConnectionCallbacks, et as plus, f as ConnectionState, g as PatchFn, h as GameConfig, i as UzuDevHooks, it as applyJsonPatch, j as Deadline, k as ActionMap, l as BridgeChannel, m as EventSubscription, n as RunHandle, nt as JsonPatchOp, o as createDevHooks, p as EventHandler, q as SetupArgs, r as SyncHandle, rt as applyJsonMergePatch, s as PredictionWarning, t as DevHooksCtx, tt as JsonMergePatch, u as BridgeMessage, v as PlayScreenMessage, w as SyncConfig, x as SeatKind, y as PlayerVoiceState, z as ServerActionArgs } from "./dev-hooks-D6CbhPDP.js";
+//#region ../engine-core/src/random.d.ts
+declare class SeededRandomImpl implements SeededRandom {
+  private _state;
+  constructor(seed: number);
+  get state(): number;
+  static fromState(state: number): SeededRandomImpl;
+  float(): number;
+  int(max: number): number;
+  pick<T>(array: T[]): T;
+  shuffle<T>(array: T[]): T[];
+}
+//#endregion
+//#region ../engine-core/src/server-only.d.ts
+/**
+ * @deprecated `logic.serverActions` に直接書く。
+ *
+ * ```ts
+ * // before
+ * actions: { notifyExternal: serverOnly(async (state) => { ... }) }
+ * // after
+ * serverActions: { notifyExternal: async (state) => { ... } }
+ * ```
+ */
+declare function 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>;
+//#endregion
+//#region src/server-clock.d.ts
 /**
- * @docs
- * - SDK仕様: docs/docs/uzu_code/play-screen-sdk.md
- * - ブリッジ仕様: docs/docs/uzu_code/bridge.md
- * - Relay仕様: docs/docs/uzu_code/relay.md
- * - SyncRoom仕様: docs/docs/uzu_code/sync-room.md
- * - ゲーム仕様: docs/docs/uzu_code/games.md
- * - システム全体像: docs/docs/uzu_code/overview.md
- * - AI用APIリファレンス (README): javascript/uzu_code/sdk/README.md
+ * ゲーム内時刻の推定値。停止中は凍る。
  *
- * SDK は runtime のみ。 dev harness の DOM 描画 (iframe grid / HUD / state
- * inspector) と in-memory サーバー (Node ws による GameRoom / SyncRoom / RelayRoom) は
- * `@uzuhq/code-cli` の `uzu dev` サブコマンドに統合されている。 parent frame で
- * `init()` / `run()` / `sync()` を呼んでも何もしない (= noop)。 harness を立てるには
- * scenario ディレクトリで `uzu dev` を実行するだけで良い。 子 iframe は既存 online mode
- * (`?server=ws://localhost:<port>` 経路) で dev-server に接続する。
+ * カウントダウン描画のように毎秒/毎フレーム呼ぶ用途を想定しているので、
+ * state の到着とは無関係にいつでも呼べる。
  */
-export type { PlayScreenMessage, BridgeChannel, BridgeMessage, Seat, SeatKind, Emit, ServerEvent, SeededRandom, GameLogic, GameConfig, SyncConfig, PatchFn, SetFn, Operation, ConnectionState, ConnectionCallbacks, PlayerVoiceState, PlayersChangedMessage, ActionArgs, ActionContext, ActionHandler, ServerActionArgs, SetupArgs, SetupContext, UpdateArgs, UpdateContext, EventHandler, EventSubscription, Deadline, DeadlineArgs, DeadlineContext, ServerActionContext, ServerActionHandler, ServerOnlyAction, ServerOnlyActionContext, ServerOnlyActionHandlerFn, ActionMap, ServerActionMap, PayloadMap, SendAction, } from './types.js';
-export { SERVER_TIME, DEFAULT_ICON_URLS } from './types.js';
-export { serverOnly, isServerOnlyAction } from './server-only.js';
-export { serverNow } from './server-clock.js';
-export { Room } from './room.js';
-export type { RoomLike } from './room.js';
-export { ReconnectableWebSocket } from './reconnectable-ws.js';
-export type { ReconnectableWSOptions } from './reconnectable-ws.js';
-export { SeededRandomImpl } from './random.js';
-export { applyJsonMergePatch, applyJsonPatch } from './dev-state-patch.js';
-export type { JsonMergePatch, JsonPatchOp } from './dev-state-patch.js';
-export { attachDevHooks, createDevHooks } from './dev-hooks.js';
-export type { UzuDevHooks, DevHooksCtx, RunHandle, SyncHandle } from './dev-hooks.js';
-export { getPredictionWarnings } from './dev-prediction-traps.js';
-export type { PredictionWarning } from './dev-prediction-traps.js';
-import type { ActionMap, ServerActionMap, BridgeMessage, GameConfig, SyncConfig, PlayerVoiceState } from './types.js';
-import type { RoomLike } from './room.js';
+declare function gameTime(): GameTime;
+//#endregion
+//#region src/pause-state.d.ts
+/** 緊急停止中か。 */
+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 ラッパー
+ *
+ * - Exponential backoff + jitter 付き自動再接続
+ * - Heartbeat (__ping / __pong) による接続生存確認
+ * - 再接続中のメッセージバッファリング
+ */
+type ConnectionState$1 = 'connecting' | 'connected' | 'reconnecting' | 'disconnected';
+interface ReconnectableWSOptions {
+  /** 最大再接続試行回数 (default: 15) */
+  maxReconnectAttempts?: number;
+  /** Backoff の基準遅延 ms (default: 1000) */
+  baseDelay?: number;
+  /** Backoff の最大遅延 ms (default: 30000) */
+  maxDelay?: number;
+  /** Jitter 係数 0〜1 (default: 0.5) */
+  jitterFactor?: number;
+  /** Heartbeat 送信間隔 ms (default: 25000) */
+  heartbeatInterval?: number;
+  /** Pong 待ちタイムアウト ms (default: 10000) */
+  heartbeatTimeout?: number;
+  /** 再接続中のバッファ上限 (default: 50) */
+  maxBufferSize?: number;
+  /** バッファ対象判定。false を返すとドロップ */
+  shouldBuffer?: (data: string) => boolean;
+  /** 接続状態変更コールバック */
+  onConnectionStateChange?: (state: ConnectionState$1) => void;
+}
+declare class ReconnectableWebSocket {
+  private ws;
+  private readonly url;
+  private readonly opts;
+  private _state;
+  private reconnectAttempt;
+  private messageBuffer;
+  private messageHandlers;
+  private heartbeatTimer;
+  private heartbeatTimeoutTimer;
+  private reconnectTimer;
+  private disposed;
+  constructor(url: string, options?: ReconnectableWSOptions);
+  get connectionState(): ConnectionState$1;
+  /** 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;
+  /** バッファをクリア（権威的 state 受信時に呼ぶ） */
+  clearBuffer(): void;
+  /** 全リソース解放 */
+  dispose(): void;
+  private connect;
+  private setState;
+  private scheduleReconnect;
+  private getReconnectDelay;
+  private flushBuffer;
+  private startHeartbeat;
+  private stopHeartbeat;
+  private handlePong;
+}
+//#endregion
+//#region src/index.d.ts
 type GameMessageHandler = (payload: Record<string, unknown>) => void;
 type PlayersChangedHandler = (players: Record<string, PlayerVoiceState>) => void;
-declare global {
-    interface Window {
-        __ps?: {
-            onMessage: (msg: BridgeMessage) => void;
-        };
-        FlutterHost?: {
-            postMessage: (message: string) => void;
-        };
-    }
-}
-export declare const isHosted: boolean;
-export declare function getRoom(): RoomLike | null;
-export declare function onRoom(callback: (room: RoomLike) => void): void;
-export declare function init(opts?: {
-    wsEndpoint?: string;
-    syncEndpoint?: string;
-    playerCount?: number;
-    orientation?: 'portrait' | 'landscape';
-    /**
-     * Dev harness の iframe inner viewport 短辺 (CSS px) の下限。default 360。
-     * harness 側で参照される値で、 SDK runtime 本体は使わない。
-     */
-    devMinIframeShortEdge?: number;
+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';
+  /**
+   * Dev harness の iframe inner viewport 短辺 (CSS px) の下限。default 360。
+   * harness 側で参照される値で、 SDK runtime 本体は使わない。
+   */
+  devMinIframeShortEdge?: number;
 }): void;
 /** game channel でカスタムメッセージを送信する。 native コマンドには使用不可。 */
-export declare function send(type: string, payload?: Record<string, unknown>): void;
+declare function send(type: string, payload?: Record<string, unknown>): void;
 /** game channel のカスタムメッセージを受信する。 */
-export declare function on(type: string, handler: GameMessageHandler): void;
-export declare function playSound(sound: string): void;
-export declare function playBgm(sound: string): void;
-export declare function stopBgm(): void;
-export declare function setMicEnabled(enabled: boolean): void;
-export declare function changeRoom(roomId: string | null): void;
+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;
 /**
  * splash 描画完了を Flutter ホストに通知する。
  *
@@ -83,7 +173,7 @@ export declare function changeRoom(roomId: string | null): void;
  * requestAnimationFrame(() => firstFrameReady());
  * ```
  */
-export declare function firstFrameReady(): void;
+declare function firstFrameReady(): void;
 /**
  * ユーザー操作受付可能を Flutter ホストに通知する。
  *
@@ -100,9 +190,9 @@ export declare function firstFrameReady(): void;
  * gameReady();
  * ```
  */
-export declare function gameReady(): void;
+declare function gameReady(): void;
 /** Flutter からの playersChanged メッセージを受信するハンドラを登録する。 */
-export declare function onPlayersChanged(handler: PlayersChangedHandler): void;
+declare function onPlayersChanged(handler: PlayersChangedHandler): void;
 /**
  * `A` に既定値が要る。 TypeScript は型引数の部分推論ができないので、 既定が無いと
  * 既存の `run<State>({…})` が「2 つ必要」で落ちる。 既定を置けば型引数を書かない
@@ -112,5 +202,7 @@ export declare function onPlayersChanged(handler: PlayersChangedHandler): void;
  * `keyof (A & SA)` が `string` へ潰れ、action 名の検査が丸ごと消える。
  * `serverActions` を持たない logic でもキーが残るよう空 map を既定にする。
  */
-export declare function run<S, A extends ActionMap<S> = ActionMap<S>, SA extends ServerActionMap<S> = Record<never, never>>(config: GameConfig<S, A, SA>): void;
-export declare function sync<S>(config: SyncConfig<S>): void;
+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, 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, sync };