@rpgjs/client 5.0.0-beta.25 → 5.0.0-beta.26

package/dist/services/mapStreaming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapStreaming.js","names":[],"sources":["../../src/services/mapStreaming.ts"],"sourcesContent":["import { Context, inject } from \"@signe/di\";\nimport {\n  MAP_STREAM_EVENT,\n  MAP_STREAM_REQUEST_EVENT,\n  type MapChunkHitbox,\n  type MapStreamChunk,\n  type MapStreamManifest,\n  type MapStreamPacket,\n} from \"@rpgjs/common\";\nimport { AbstractWebsocket, WebSocketToken } from \"./AbstractSocket\";\nimport { LoadMapToken, type MapData, type LoadMapOptions } from \"./loadMap\";\nimport { UpdateMapService, UpdateMapToken } from \"@rpgjs/common\";\n\nexport interface ClientMapStreamingAdapter<TManifestData = unknown, TChunkData = unknown, TState = unknown> {\n  /** CanvasEngine component that renders the provider-specific state. */\n  component: unknown;\n  /** Create empty client render state from public manifest data. */\n  createState(manifest: MapStreamManifest<TManifestData>): TState;\n  /** Apply one disclosed render chunk to the state. */\n  applyChunk(state: TState, chunk: MapStreamChunk<TChunkData>): void;\n  /** Remove one chunk that left the retention window. */\n  removeChunk(state: TState, key: string): void;\n  /** Return the serializable/component-ready map value exposed to CanvasEngine. */\n  getData(state: TState): unknown;\n  /** Optionally derive component parameters from the public manifest. */\n  getParams?(manifest: MapStreamManifest<TManifestData>): Record<string, unknown>;\n}\n\nexport interface ClientMapStreamingOptions<TManifestData = unknown, TChunkData = unknown, TState = unknown> {\n  /** Format adapter paired with the server compiler. */\n  adapter: ClientMapStreamingAdapter<TManifestData, TChunkData, TState>;\n  /** Optional direct loader used only by standalone RPG mode. */\n  directLoad?: LoadMapOptions;\n  /** Maximum wait for the initial authoritative manifest. Defaults to 10 seconds. */\n  timeoutMs?: number;\n}\n\ntype StreamingPhysicsMap = {\n  data: { (): MapData | null; set(value: MapData): void };\n  replaceStreamedStaticHitboxes(namespace: string, hitboxes: MapChunkHitbox[]): void;\n  clearStreamedStaticHitboxes(namespace: string): void;\n};\n\ntype Waiter = {\n  resolve(controller: MapStreamClientController<any, any, any>): void;\n  reject(error: Error): void;\n  timer: ReturnType<typeof setTimeout>;\n};\n\nexport class MapStreamClientController<TManifestData, TChunkData, TState> {\n  private state: TState;\n  private manifest: MapStreamManifest<TManifestData>;\n  private readonly chunks = new Map<string, MapStreamChunk<TChunkData>>();\n  private attachedMap?: StreamingPhysicsMap;\n\n  constructor(\n    private readonly adapter: ClientMapStreamingAdapter<TManifestData, TChunkData, TState>,\n    manifest: MapStreamManifest<TManifestData>,\n  ) {\n    this.manifest = manifest;\n    this.state = adapter.createState(manifest);\n  }\n\n  get revision(): string {\n    return this.manifest.revision;\n  }\n\n  reset(manifest: MapStreamManifest<TManifestData>): void {\n    const attachedMap = this.attachedMap;\n    this.detach();\n    this.manifest = manifest;\n    this.state = this.adapter.createState(manifest);\n    this.chunks.clear();\n    this.attachedMap = attachedMap;\n  }\n\n  receive(packet: MapStreamPacket<TManifestData, TChunkData>): void {\n    for (const key of packet.removed) {\n      this.chunks.delete(key);\n      this.adapter.removeChunk(this.state, key);\n      this.attachedMap?.clearStreamedStaticHitboxes(key);\n    }\n    for (const chunk of packet.chunks) {\n      this.chunks.set(chunk.key, chunk);\n      this.adapter.applyChunk(this.state, chunk);\n      this.attachedMap?.replaceStreamedStaticHitboxes(chunk.key, chunk.hitboxes);\n    }\n    this.publish();\n  }\n\n  toMapData(): MapData {\n    return {\n      id: this.manifest.mapId,\n      width: this.manifest.width,\n      height: this.manifest.height,\n      data: this.adapter.getData(this.state),\n      component: this.adapter.component,\n      params: this.adapter.getParams?.(this.manifest),\n      streamController: this,\n    };\n  }\n\n  attach(map: StreamingPhysicsMap): void {\n    this.attachedMap = map;\n    for (const chunk of this.chunks.values()) {\n      map.replaceStreamedStaticHitboxes(chunk.key, chunk.hitboxes);\n    }\n    this.updatePredictionBoundary();\n  }\n\n  detach(): void {\n    if (!this.attachedMap) return;\n    for (const key of this.chunks.keys()) {\n      this.attachedMap.clearStreamedStaticHitboxes(key);\n    }\n    this.attachedMap.clearStreamedStaticHitboxes(\"__boundary__\");\n    this.attachedMap = undefined;\n  }\n\n  private publish(): void {\n    if (!this.attachedMap) return;\n    const current = this.attachedMap.data();\n    if (current) {\n      this.attachedMap.data.set({ ...current, data: this.adapter.getData(this.state) });\n    }\n    this.updatePredictionBoundary();\n  }\n\n  private updatePredictionBoundary(): void {\n    const map = this.attachedMap;\n    if (!map) return;\n    if (this.chunks.size === 0) {\n      map.clearStreamedStaticHitboxes(\"__boundary__\");\n      return;\n    }\n    const chunks = [...this.chunks.values()];\n    const left = Math.min(...chunks.map((chunk) => chunk.bounds.x));\n    const top = Math.min(...chunks.map((chunk) => chunk.bounds.y));\n    const right = Math.max(...chunks.map((chunk) => chunk.bounds.x + chunk.bounds.width));\n    const bottom = Math.max(...chunks.map((chunk) => chunk.bounds.y + chunk.bounds.height));\n    const thickness = 2;\n    const barriers: MapChunkHitbox[] = [];\n    if (left > 0) barriers.push({ x: left - thickness, y: top, width: thickness, height: bottom - top });\n    if (top > 0) barriers.push({ x: left, y: top - thickness, width: right - left, height: thickness });\n    if (right < this.manifest.width) barriers.push({ x: right, y: top, width: thickness, height: bottom - top });\n    if (bottom < this.manifest.height) barriers.push({ x: left, y: bottom, width: right - left, height: thickness });\n    map.replaceStreamedStaticHitboxes(\"__boundary__\", barriers);\n  }\n}\n\nclass MapStreamingClientService<TManifestData, TChunkData, TState> {\n  private readonly controllers = new Map<string, MapStreamClientController<TManifestData, TChunkData, TState>>();\n  private readonly waiters = new Map<string, Waiter[]>();\n\n  constructor(\n    private readonly socket: AbstractWebsocket,\n    private readonly options: ClientMapStreamingOptions<TManifestData, TChunkData, TState>,\n  ) {\n    socket.on(MAP_STREAM_EVENT, (packet) => this.receive(packet));\n  }\n\n  async load(mapId: string): Promise<MapData> {\n    const normalizedId = mapId.replace(/^map-/, \"\");\n    const existing = this.controllers.get(normalizedId);\n    if (existing) {\n      this.socket.emit(MAP_STREAM_REQUEST_EVENT, { mapId: normalizedId });\n      return existing.toMapData();\n    }\n\n    const shouldRequest = !this.waiters.has(normalizedId);\n    const controllerPromise = new Promise<MapStreamClientController<TManifestData, TChunkData, TState>>((resolve, reject) => {\n      const timeoutMs = Math.max(1, this.options.timeoutMs ?? 10_000);\n      const waiter: Waiter = { resolve, reject, timer: undefined as unknown as ReturnType<typeof setTimeout> };\n      const timer = setTimeout(() => {\n        const current = this.waiters.get(normalizedId) ?? [];\n        const remaining = current.filter((entry) => entry !== waiter);\n        if (remaining.length > 0) this.waiters.set(normalizedId, remaining);\n        else this.waiters.delete(normalizedId);\n        reject(new Error(`Map stream '${normalizedId}' was not received after ${timeoutMs}ms`));\n      }, timeoutMs);\n      waiter.timer = timer;\n      const waiters = this.waiters.get(normalizedId) ?? [];\n      waiters.push(waiter);\n      this.waiters.set(normalizedId, waiters);\n    });\n    // The map-room connection is established before load() runs. Request the\n    // initial packet only after the waiter is registered so fast local and DO\n    // transports cannot deliver it before the client is ready.\n    if (shouldRequest) {\n      this.socket.emit(MAP_STREAM_REQUEST_EVENT, { mapId: normalizedId });\n    }\n    return (await controllerPromise).toMapData();\n  }\n\n  private receive(packet: MapStreamPacket<TManifestData, TChunkData>): void {\n    if (!packet || typeof packet.mapId !== \"string\") return;\n    const mapId = packet.mapId.replace(/^map-/, \"\");\n    let controller = this.controllers.get(mapId);\n    if (!controller) {\n      if (!packet.manifest) return;\n      controller = new MapStreamClientController(this.options.adapter, packet.manifest);\n      this.controllers.set(mapId, controller);\n    }\n    else if (packet.manifest && controller.revision !== packet.manifest.revision) {\n      controller.reset(packet.manifest);\n    }\n    controller.receive(packet);\n\n    const waiters = this.waiters.get(mapId) ?? [];\n    waiters.forEach((waiter) => {\n      clearTimeout(waiter.timer);\n      waiter.resolve(controller!);\n    });\n    this.waiters.delete(mapId);\n  }\n}\n\nclass MapStreamingLoadMapService<TManifestData, TChunkData, TState> {\n  private socket?: AbstractWebsocket;\n  private stream?: MapStreamingClientService<TManifestData, TChunkData, TState>;\n  private updateMap?: UpdateMapService;\n\n  constructor(\n    private readonly context: Context,\n    private readonly options: ClientMapStreamingOptions<TManifestData, TChunkData, TState>,\n  ) {}\n\n  initialize(): void {\n    if (this.stream) return;\n    this.socket = inject<AbstractWebsocket>(this.context, WebSocketToken);\n    this.stream = new MapStreamingClientService(this.socket, this.options);\n  }\n\n  async load(mapId: string): Promise<MapData> {\n    this.initialize();\n    const map = this.socket?.mode === \"standalone\" && this.options.directLoad\n      ? await this.options.directLoad(mapId.replace(/^map-/, \"\"))\n      : await this.stream!.load(mapId);\n    this.updateMap ??= inject<UpdateMapService>(this.context, UpdateMapToken);\n    await this.updateMap.update(map);\n    return map;\n  }\n}\n\n/**\n * Provide a transport-neutral client map loader backed by authoritative chunks.\n * Standalone mode may keep a direct loader while MMORPG mode never fetches the\n * private source map.\n *\n * @param options - Client adapter, optional standalone loader, and timeout.\n * @returns Dependency-injection providers for the RPGJS map loader.\n *\n * @example\n * ```ts\n * provideClientMapStreaming({\n *   adapter: {\n *     component: MyMap,\n *     createState: (manifest) => ({ manifest, chunks: new Map() }),\n *     applyChunk: (state, chunk) => state.chunks.set(chunk.key, chunk.renderData),\n *     removeChunk: (state, key) => state.chunks.delete(key),\n *     getData: (state) => state,\n *   },\n * })\n * ```\n */\nexport function provideClientMapStreaming<TManifestData, TChunkData, TState>(\n  options: ClientMapStreamingOptions<TManifestData, TChunkData, TState>,\n) {\n  return [\n    {\n      provide: LoadMapToken,\n      useFactory: (context: Context) => new MapStreamingLoadMapService(context, options),\n    },\n  ];\n}\n"],"mappings":"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"}

package/dist/services/mapStreaming.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/services/mmorpg.d.ts

@@ -9,6 +9,12 @@ export interface MmorpgOptions {
     connectionIdScope?: "local" | "session" | "ephemeral";
     query?: SocketQuery | (() => SocketQuery | undefined);
     socketOptions?: Record<string, any>;
+    /**
+     * Time allowed for a room to restore and send the RPGJS acceptance packet.
+     * Increase this for cold edge rooms or local Durable Object startup.
+     * Defaults to 10 seconds.
+     */
+    connectionAcceptanceTimeoutMs?: number;
 }
 export declare class BridgeWebsocket extends AbstractWebsocket {
     protected context: Context;

package/dist/services/mmorpg.js

@@ -51,7 +51,7 @@ var BridgeWebsocket = class extends AbstractWebsocket {
 		const pendingOn = this.pendingOn;
 		this.pendingOn = [];
 		pendingOn.filter(({ event }) => !this.isNativeSocketEvent(event)).forEach(({ event, callback }) => this.attachEvent(event, callback));
-		await waitForRpgjsConnected(this.socket.conn);
+		await waitForRpgjsConnected(this.socket.conn, this.options.connectionAcceptanceTimeoutMs ?? 1e4);
 		pendingOn.filter(({ event }) => this.isNativeSocketEvent(event)).forEach(({ event, callback }) => this.attachEvent(event, callback));
 		this.emitAcceptedOpen();
 		listeners?.(this.socket);
@@ -116,7 +116,7 @@ var BridgeWebsocket = class extends AbstractWebsocket {
 	async reconnect(_listeners) {
 		if (!this.socket?.conn) return;
 		const conn = this.socket.conn;
-		const connected = waitForRpgjsConnected(conn, 1e4, { ignoreCleanClose: true });
+		const connected = waitForRpgjsConnected(conn, this.options.connectionAcceptanceTimeoutMs ?? 1e4, { ignoreCleanClose: true });
 		conn.reconnect();
 		await connected;
 		this.emitAcceptedOpen();

package/dist/services/mmorpg.js.map

@@ -1 +1 @@
-{"version":3,"file":"mmorpg.js","names":[],"sources":["../../src/services/mmorpg.ts"],"sourcesContent":["import { Context } from \"@signe/di\";\nimport { connectionRoom } from \"@signe/sync/client\";\nimport { RpgGui } from \"../Gui/Gui\";\nimport { RpgClientEngine } from \"../RpgClientEngine\";\nimport { AbstractWebsocket, SocketQuery, SocketUpdateProperties, WebSocketToken } from \"./AbstractSocket\";\nimport { UpdateMapService, UpdateMapToken } from \"@rpgjs/common\";\nimport { provideKeyboardControls } from \"./keyboardControls\";\nimport { provideSaveClient } from \"./save\";\nimport { isNativeSocketEvent, waitForRpgjsConnected } from \"./mmorpg-connection\";\n\nexport interface MmorpgOptions {\n    host?: string;\n    connectionId?: string;\n    connectionIdScope?: \"local\" | \"session\" | \"ephemeral\";\n    query?: SocketQuery | (() => SocketQuery | undefined);\n    socketOptions?: Record<string, any>;\n}\n\nexport class BridgeWebsocket extends AbstractWebsocket {\n  readonly mode = \"mmorpg\" as const;\n\n  private socket: any;\n  private privateId: string;\n  private pendingOn: Array<{ event: string; callback: (data: any) => void }> = [];\n  private acceptedOpenListeners = new Set<(data: any) => void>();\n  private targetRoom = \"lobby-1\";\n\n  constructor(protected context: Context, private options: MmorpgOptions = {}) {\n    super(context);\n    this.privateId = this.resolveConnectionId();\n  }\n\n  private resolveConnectionId(): string {\n    if (this.options.connectionId) {\n      return this.options.connectionId;\n    }\n\n    const scope = this.options.connectionIdScope ?? \"local\";\n    const key = \"rpgjs-user-id\";\n\n    if (scope === \"ephemeral\") {\n      return crypto.randomUUID();\n    }\n\n    const storage =\n      scope === \"session\"\n        ? window.sessionStorage\n        : window.localStorage;\n\n    const existing = storage.getItem(key);\n    if (existing) {\n      return existing;\n    }\n\n    const id = crypto.randomUUID();\n    storage.setItem(key, id);\n    return id;\n  }\n\n  private resolveQuery(): SocketQuery {\n    const query = typeof this.options.query === \"function\"\n      ? this.options.query()\n      : this.options.query;\n\n    return query ?? {};\n  }\n\n  async connection(listeners?: (data: any) => void) {\n    // tmp\n    class Room {\n        \n    }\n    const instance = new Room()\n    const host = this.options.host || window.location.host;\n    this.socket = await connectionRoom({\n        maxRetries: 0,\n        ...this.options.socketOptions,\n        host,\n        room: this.targetRoom,\n        id: this.privateId,\n        query: {\n          ...this.resolveQuery(),\n          id: this.privateId,\n        },\n    }, instance)\n\n    const pendingOn = this.pendingOn;\n    this.pendingOn = [];\n    pendingOn\n      .filter(({ event }) => !this.isNativeSocketEvent(event))\n      .forEach(({ event, callback }) => this.attachEvent(event, callback));\n    await waitForRpgjsConnected(this.socket.conn);\n    pendingOn\n      .filter(({ event }) => this.isNativeSocketEvent(event))\n      .forEach(({ event, callback }) => this.attachEvent(event, callback));\n    this.emitAcceptedOpen();\n    listeners?.(this.socket)\n  }\n\n  on(key: string, callback: (data: any) => void) {\n    if (!this.socket) {\n      this.pendingOn.push({ event: key, callback });\n      return;\n    }\n    this.attachEvent(key, callback);\n  }\n\n  off(event: string, callback: (data: any) => void) {\n    if (!this.socket) return;\n    if (event === \"open\") {\n      this.acceptedOpenListeners.delete(callback);\n      return;\n    }\n    if (this.isNativeSocketEvent(event)) {\n      this.socket.conn.removeEventListener(event, callback);\n      return;\n    }\n    this.socket.off(event, callback);\n  }\n\n  emit(event: string, data: any) {\n    this.socket.emit(event, data);\n  }\n\n  private attachEvent(event: string, callback: (data: any) => void) {\n    if (event === \"open\") {\n      this.acceptedOpenListeners.add(callback);\n      return;\n    }\n    if (this.isNativeSocketEvent(event)) {\n      this.socket.conn.addEventListener(event, callback);\n      return;\n    }\n    this.socket.on(event, callback);\n  }\n\n  private emitAcceptedOpen() {\n    const event = new Event(\"open\");\n    this.acceptedOpenListeners.forEach((callback) => callback(event));\n  }\n\n  updateProperties({ room, host, query }: SocketUpdateProperties) {\n    if (!this.socket?.conn) return;\n    this.targetRoom = room;\n    this.socket.conn.updateProperties({\n      room,\n      id: this.privateId,\n      host: host || this.options.host || window.location.host,\n      query: {\n        ...this.resolveQuery(),\n        ...query,\n        id: this.privateId,\n      },\n    })\n  }\n\n  private isNativeSocketEvent(event: string) {\n    return isNativeSocketEvent(event);\n  }\n\n  async reconnect(_listeners?: (data: any) => void): Promise<void> {\n    if (!this.socket?.conn) return;\n    const conn = this.socket.conn;\n    const connected = waitForRpgjsConnected(conn, 10000, { ignoreCleanClose: true });\n    conn.reconnect();\n    await connected;\n    this.emitAcceptedOpen();\n  }\n\n  getCurrentRoom(): string {\n    return this.targetRoom || this.socket?.conn?.room || \"lobby-1\";\n  }\n}\n\nclass UpdateMapStandaloneService extends UpdateMapService {\n  constructor(protected context: Context, private _options: MmorpgOptions) {\n    super(context);\n  }\n\n  async update(_map: any) {\n    // In MMORPG mode, clients are untrusted and must not push map definitions.\n    // Map bootstrap/update is handled server-side by @rpgjs/vite.\n    return;\n  }\n}\n\nexport function provideMmorpg(options: MmorpgOptions) {\n  return [\n    {\n      provide: WebSocketToken,\n      useFactory: (context: Context) => new BridgeWebsocket(context, options),\n    },\n    {\n      provide: UpdateMapToken,\n      useFactory: (context: Context) => new UpdateMapStandaloneService(context, options),\n    },\n    provideKeyboardControls(),\n    provideSaveClient(),\n    RpgGui,\n    RpgClientEngine,\n  ];\n}\n"],"mappings":"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"}
+{"version":3,"file":"mmorpg.js","names":[],"sources":["../../src/services/mmorpg.ts"],"sourcesContent":["import { Context } from \"@signe/di\";\nimport { connectionRoom } from \"@signe/sync/client\";\nimport { RpgGui } from \"../Gui/Gui\";\nimport { RpgClientEngine } from \"../RpgClientEngine\";\nimport { AbstractWebsocket, SocketQuery, SocketUpdateProperties, WebSocketToken } from \"./AbstractSocket\";\nimport { UpdateMapService, UpdateMapToken } from \"@rpgjs/common\";\nimport { provideKeyboardControls } from \"./keyboardControls\";\nimport { provideSaveClient } from \"./save\";\nimport { isNativeSocketEvent, waitForRpgjsConnected } from \"./mmorpg-connection\";\n\nexport interface MmorpgOptions {\n    host?: string;\n    connectionId?: string;\n    connectionIdScope?: \"local\" | \"session\" | \"ephemeral\";\n    query?: SocketQuery | (() => SocketQuery | undefined);\n    socketOptions?: Record<string, any>;\n    /**\n     * Time allowed for a room to restore and send the RPGJS acceptance packet.\n     * Increase this for cold edge rooms or local Durable Object startup.\n     * Defaults to 10 seconds.\n     */\n    connectionAcceptanceTimeoutMs?: number;\n}\n\nexport class BridgeWebsocket extends AbstractWebsocket {\n  readonly mode = \"mmorpg\" as const;\n\n  private socket: any;\n  private privateId: string;\n  private pendingOn: Array<{ event: string; callback: (data: any) => void }> = [];\n  private acceptedOpenListeners = new Set<(data: any) => void>();\n  private targetRoom = \"lobby-1\";\n\n  constructor(protected context: Context, private options: MmorpgOptions = {}) {\n    super(context);\n    this.privateId = this.resolveConnectionId();\n  }\n\n  private resolveConnectionId(): string {\n    if (this.options.connectionId) {\n      return this.options.connectionId;\n    }\n\n    const scope = this.options.connectionIdScope ?? \"local\";\n    const key = \"rpgjs-user-id\";\n\n    if (scope === \"ephemeral\") {\n      return crypto.randomUUID();\n    }\n\n    const storage =\n      scope === \"session\"\n        ? window.sessionStorage\n        : window.localStorage;\n\n    const existing = storage.getItem(key);\n    if (existing) {\n      return existing;\n    }\n\n    const id = crypto.randomUUID();\n    storage.setItem(key, id);\n    return id;\n  }\n\n  private resolveQuery(): SocketQuery {\n    const query = typeof this.options.query === \"function\"\n      ? this.options.query()\n      : this.options.query;\n\n    return query ?? {};\n  }\n\n  async connection(listeners?: (data: any) => void) {\n    // tmp\n    class Room {\n        \n    }\n    const instance = new Room()\n    const host = this.options.host || window.location.host;\n    this.socket = await connectionRoom({\n        maxRetries: 0,\n        ...this.options.socketOptions,\n        host,\n        room: this.targetRoom,\n        id: this.privateId,\n        query: {\n          ...this.resolveQuery(),\n          id: this.privateId,\n        },\n    }, instance)\n\n    const pendingOn = this.pendingOn;\n    this.pendingOn = [];\n    pendingOn\n      .filter(({ event }) => !this.isNativeSocketEvent(event))\n      .forEach(({ event, callback }) => this.attachEvent(event, callback));\n    await waitForRpgjsConnected(\n      this.socket.conn,\n      this.options.connectionAcceptanceTimeoutMs ?? 10_000,\n    );\n    pendingOn\n      .filter(({ event }) => this.isNativeSocketEvent(event))\n      .forEach(({ event, callback }) => this.attachEvent(event, callback));\n    this.emitAcceptedOpen();\n    listeners?.(this.socket)\n  }\n\n  on(key: string, callback: (data: any) => void) {\n    if (!this.socket) {\n      this.pendingOn.push({ event: key, callback });\n      return;\n    }\n    this.attachEvent(key, callback);\n  }\n\n  off(event: string, callback: (data: any) => void) {\n    if (!this.socket) return;\n    if (event === \"open\") {\n      this.acceptedOpenListeners.delete(callback);\n      return;\n    }\n    if (this.isNativeSocketEvent(event)) {\n      this.socket.conn.removeEventListener(event, callback);\n      return;\n    }\n    this.socket.off(event, callback);\n  }\n\n  emit(event: string, data: any) {\n    this.socket.emit(event, data);\n  }\n\n  private attachEvent(event: string, callback: (data: any) => void) {\n    if (event === \"open\") {\n      this.acceptedOpenListeners.add(callback);\n      return;\n    }\n    if (this.isNativeSocketEvent(event)) {\n      this.socket.conn.addEventListener(event, callback);\n      return;\n    }\n    this.socket.on(event, callback);\n  }\n\n  private emitAcceptedOpen() {\n    const event = new Event(\"open\");\n    this.acceptedOpenListeners.forEach((callback) => callback(event));\n  }\n\n  updateProperties({ room, host, query }: SocketUpdateProperties) {\n    if (!this.socket?.conn) return;\n    this.targetRoom = room;\n    this.socket.conn.updateProperties({\n      room,\n      id: this.privateId,\n      host: host || this.options.host || window.location.host,\n      query: {\n        ...this.resolveQuery(),\n        ...query,\n        id: this.privateId,\n      },\n    })\n  }\n\n  private isNativeSocketEvent(event: string) {\n    return isNativeSocketEvent(event);\n  }\n\n  async reconnect(_listeners?: (data: any) => void): Promise<void> {\n    if (!this.socket?.conn) return;\n    const conn = this.socket.conn;\n    const connected = waitForRpgjsConnected(\n      conn,\n      this.options.connectionAcceptanceTimeoutMs ?? 10_000,\n      { ignoreCleanClose: true },\n    );\n    conn.reconnect();\n    await connected;\n    this.emitAcceptedOpen();\n  }\n\n  getCurrentRoom(): string {\n    return this.targetRoom || this.socket?.conn?.room || \"lobby-1\";\n  }\n}\n\nclass UpdateMapStandaloneService extends UpdateMapService {\n  constructor(protected context: Context, private _options: MmorpgOptions) {\n    super(context);\n  }\n\n  async update(_map: any) {\n    // In MMORPG mode, clients are untrusted and must not push map definitions.\n    // Map bootstrap/update is handled server-side by @rpgjs/vite.\n    return;\n  }\n}\n\nexport function provideMmorpg(options: MmorpgOptions) {\n  return [\n    {\n      provide: WebSocketToken,\n      useFactory: (context: Context) => new BridgeWebsocket(context, options),\n    },\n    {\n      provide: UpdateMapToken,\n      useFactory: (context: Context) => new UpdateMapStandaloneService(context, options),\n    },\n    provideKeyboardControls(),\n    provideSaveClient(),\n    RpgGui,\n    RpgClientEngine,\n  ];\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rpgjs/client",
-  "version": "5.0.0-beta.25",
+  "version": "5.0.0-beta.26",
   "description": "RPGJS is a framework for creating RPG/MMORPG games",
   "main": "dist/index.js",
   "types": "./dist/index.d.ts",
@@ -22,8 +22,8 @@
     "pixi.js": "^8.9.2"
   },
   "dependencies": {
-    "@rpgjs/common": "5.0.0-beta.24",
-    "@rpgjs/server": "5.0.0-beta.25",
+    "@rpgjs/common": "5.0.0-beta.25",
+    "@rpgjs/server": "5.0.0-beta.26",
     "@rpgjs/ui-css": "5.0.0-beta.23",
     "@signe/di": "3.1.0",
     "@signe/room": "3.1.0",

package/src/Game/Map.ts

@@ -59,6 +59,7 @@ export class RpgClientMap extends RpgCommonMap<any> {
   currentPlayer = computed(() => this.players()[this.engine.playerIdSignal()!])
   weatherState = signal<WeatherState | null>(null);
   localWeatherOverride = signal<WeatherState | null>(null);
+  private localWeatherValue: WeatherState | null = null;
   lightingState = signal<LightingState | null>(null);
   localLightSpots = signal<Record<string, LightSpot>>({});
   weather = computed<WeatherState | null>(() => {
@@ -132,6 +133,7 @@ export class RpgClientMap extends RpgCommonMap<any> {
     );
     this.events.set({})
     this.weatherState.set(null);
+    this.localWeatherValue = null;
     this.localWeatherOverride.set(null);
     this.lightingState.set(null);
     this.localLightSpots.set({});
@@ -143,10 +145,15 @@ export class RpgClientMap extends RpgCommonMap<any> {
   }
 
   setLocalWeather(next: WeatherState | null): void {
+    if (this.localWeatherValue === next) {
+      return;
+    }
+    this.localWeatherValue = next;
     this.localWeatherOverride.set(next);
   }
 
   clearLocalWeather(): void {
+    this.localWeatherValue = null;
     this.localWeatherOverride.set(null);
   }
 

package/src/RpgClient.ts

@@ -259,7 +259,8 @@ export interface RpgSceneHooks<Scene> {
     onRemoveSprite?: (scene: Scene, sprite: RpgComponent) => any
 
      /**
-     * Before the scene is loaded
+     * Before the scene is loaded. Async hooks are awaited while the previous
+     * scene is still mounted, allowing transition UI to cover it before teardown.
      * 
      * @prop { (scene: RpgScene) => any } [onBeforeLoading]
      * @memberof RpgSceneHooks

package/src/RpgClientEngine.ts

@@ -170,7 +170,40 @@ export class RpgClientEngine<T = any> {
   componentAnimations: any[] = [];
   clientVisuals = new ClientVisualRegistry();
   projectiles: ProjectileManager;
+  /**
+   * Read the latest pointer position tracked by the client canvas. World
+   * coordinates are suitable for action payloads and map interactions.
+   *
+   * @title pointer
+   * @prop pointer: ClientPointerContext
+   * @memberof RpgClientEngine
+   * @example
+   * ```ts
+   * const target = engine.pointer.world()
+   * if (target) engine.processAction('projectile:shoot', { target })
+   * ```
+   */
   pointer: ClientPointerContext = createClientPointerContext();
+  /**
+   * Register client-only pointer behaviors for map sprites. Interactions remain
+   * local unless a behavior explicitly sends an action to the server.
+   *
+   * See the [client interactions guide](../../guide/interactions.md) for hover,
+   * selection, hit testing, drag-and-drop, overlays, and network rules.
+   *
+   * @title interactions
+   * @prop interactions: RpgClientInteractions
+   * @memberof RpgClientEngine
+   * @example
+   * ```ts
+   * engine.interactions.use('Guard', {
+   *   cursor: 'pointer',
+   *   click(ctx) {
+   *     ctx.action('guard:talk', { eventId: ctx.target.id })
+   *   }
+   * })
+   * ```
+   */
   interactions: RpgClientInteractions = new RpgClientInteractions(this);
   private spritesheetResolver?: (id: string | number) => any | Promise<any>;
   private soundResolver?: (id: string) => any | Promise<any>;
@@ -218,6 +251,8 @@ export class RpgClientEngine<T = any> {
   private pingInterval: any = null;
   private readonly PING_INTERVAL_MS = 5000; // Send ping every 5 seconds
   private lastInputTime = 0;
+  private latestDirectionalInput?: RpgMovementInput;
+  private pendingMapTransferInput?: RpgMovementInput;
   private readonly MOVE_PATH_RESEND_INTERVAL_MS = 120;
   private readonly MAX_MOVE_TRAJECTORY_POINTS = 240;
   private lastMovePathSentAt = 0;
@@ -231,6 +266,7 @@ export class RpgClientEngine<T = any> {
   private sceneResetQueued = false;
   private mapTransitionInProgress = false;
   private currentMapRoomId?: string;
+  private activeMapStreamController?: { attach(map: RpgClientMap): void; detach(): void };
   private socketListenersInitialized = false;
   private clientReadyForMapChanges = false;
   private pendingMapChanges: any[] = [];
@@ -383,6 +419,7 @@ export class RpgClientEngine<T = any> {
     this.sceneMap.loadPhysic();
     this.resolveSceneMapComponent();
 
+    this.loadMapService.initialize?.();
     const saveClient = inject(SaveClientService);
     saveClient.initialize();
     this.initListeners();
@@ -888,11 +925,23 @@ export class RpgClientEngine<T = any> {
     })
   }
 
-  private beginMapTransfer(nextMapId?: string) {
+  private beginMapTransfer(
+    nextMapId?: string,
+    continueMovement = false,
+  ) {
+    this.pendingMapTransferInput = continueMovement
+      ? this.latestDirectionalInput
+      : undefined;
     this.mapTransitionInProgress = true;
     this.currentMapRoomId = nextMapId;
     this.sceneResetQueued = false;
-    this.clearClientPredictionStates();
+    this.clearMapTransferPredictionStates();
+  }
+
+  private resetSceneForMapTransfer(nextMapId?: string) {
+    // The before-loading hook has now covered the previous scene. Unmount it
+    // before reconnecting so stale map content cannot appear behind the loader.
+    this.sceneMap.data.set(null);
     this.sceneMap.weatherState.set(null);
     this.sceneMap.lightingState.set(null);
     this.sceneMap.clearLightSpots();
@@ -936,7 +985,7 @@ export class RpgClientEngine<T = any> {
 
   private handleChangeMap(data: any) {
     const nextMapId = typeof data?.mapId === "string" ? data.mapId : undefined;
-    this.beginMapTransfer(nextMapId);
+    this.beginMapTransfer(nextMapId, data?.continueMovement === true);
     const transferToken = typeof data?.transferToken === "string" ? data.transferToken : undefined;
     this.loadScene(data.mapId, transferToken);
   }
@@ -1067,10 +1116,25 @@ export class RpgClientEngine<T = any> {
   }
 
   private async loadScene(mapId: string, transferToken?: string) {
+    // Keep the previous scene mounted while async before-loading hooks install
+    // and animate their transition UI. The hook contract is awaited, allowing
+    // modules to report when the old scene is fully covered.
     await lastValueFrom(this.hooks.callHooks("client-sceneMap-onBeforeLoading", this.sceneMap));
 
-    // Clear client prediction states when changing maps
-    this.clearClientPredictionStates();
+    this.activeMapStreamController?.detach();
+    this.activeMapStreamController = undefined;
+    if (this.mapTransitionInProgress) {
+      this.resetSceneForMapTransfer(mapId);
+    }
+
+    // A session-transferred player keeps the last acknowledged input frame on
+    // the server. Preserve the client's monotonic frame sequence so movement
+    // sent in the destination room is not discarded as stale.
+    if (this.mapTransitionInProgress) {
+      this.clearMapTransferPredictionStates();
+    } else {
+      this.clearClientPredictionStates();
+    }
 
     // Reset all conditions for new map loading
     this.mapLoadCompleted$.next(false);
@@ -1095,6 +1159,7 @@ export class RpgClientEngine<T = any> {
     }
     catch (error) {
       this.mapTransitionInProgress = false;
+      this.pendingMapTransferInput = undefined;
       this.stopPingPong();
       await this.callConnectError(error);
       throw error;
@@ -1130,6 +1195,33 @@ export class RpgClientEngine<T = any> {
     this.mapTransitionInProgress = false;
     this.sceneMap.configureClientPrediction(this.predictionEnabled);
     this.sceneMap.loadPhysic()
+    if (res?.streamController) {
+      const controller = res.streamController;
+      this.activeMapStreamController = controller;
+      controller.attach(this.sceneMap);
+    }
+    const transferInput = this.pendingMapTransferInput;
+    this.pendingMapTransferInput = undefined;
+    if (transferInput !== undefined) {
+      void this.resumeMapTransferMovement(transferInput, mapId);
+    }
+  }
+
+  private async resumeMapTransferMovement(
+    input: RpgMovementInput,
+    mapId: string,
+  ): Promise<void> {
+    const repeatCount = 4;
+    const repeatIntervalMs = 50;
+    for (let index = 0; index < repeatCount; index += 1) {
+      if (this.mapTransitionInProgress || this.currentMapRoomId !== mapId) return;
+      await this.processInput({ input });
+      if (index < repeatCount - 1) {
+        await new Promise<void>((resolve) =>
+          setTimeout(resolve, repeatIntervalMs),
+        );
+      }
+    }
   }
 
   addSpriteSheet<T = any>(spritesheetClass: any, id?: string): any {
@@ -1860,6 +1952,9 @@ export class RpgClientEngine<T = any> {
       ? normalizeDashInput(input, currentPlayer?.direction?.())
       : input;
     if (!movementInput) return;
+    if (!isDashInput(movementInput)) {
+      this.latestDirectionalInput = movementInput;
+    }
     if (isDashInput(movementInput)) {
       const cooldown = movementInput.cooldown ?? DEFAULT_DASH_COOLDOWN_MS;
       if (timestamp < this.dashLockedUntil) return;
@@ -1897,7 +1992,26 @@ export class RpgClientEngine<T = any> {
       : Date.now();
   }
 
-  async processDash(input: Partial<RpgDashInput> = {}) {
+  /**
+   * Start a predicted dash for the current player and send it through the
+   * authoritative movement channel.
+   *
+   * @title processDash
+   * @method processDash(input?: Partial<RpgDashInput>): Promise<void>
+   * @param input - Optional direction, speed, duration, and cooldown overrides.
+   * @returns A promise resolved after the dash input has been processed locally.
+   * @memberof RpgClientEngine
+   * @example
+   * ```ts
+   * await engine.processDash({
+   *   direction: { x: 1, y: 0 },
+   *   additionalSpeed: 10,
+   *   duration: 220,
+   *   cooldown: 600,
+   * })
+   * ```
+   */
+  async processDash(input: Partial<RpgDashInput> = {}): Promise<void> {
     const currentPlayer = this.sceneMap.getCurrentPlayer() as any;
     const fallbackDirection =
       typeof currentPlayer?.direction === "function"
@@ -1908,6 +2022,24 @@ export class RpgClientEngine<T = any> {
     await this.processInput({ input: dashInput });
   }
 
+  /**
+   * Send an action intent to the authoritative server. Client-provided data
+   * must be validated by the receiving player input handler or action.
+   *
+   * @title processAction
+   * @method processAction(action: RpgActionName | RpgActionInput, data?: any): void
+   * @param action - Action name/control value, or a normalized action object.
+   * @param data - Optional serializable context sent with an action name.
+   * @returns Nothing.
+   * @memberof RpgClientEngine
+   * @example
+   * ```ts
+   * engine.processAction('projectile:shoot', {
+   *   target: engine.pointer.world(),
+   *   source: 'map-click',
+   * })
+   * ```
+   */
   processAction(action: RpgActionName, data?: any): void;
   processAction(action: RpgActionInput): void;
   processAction(action: RpgActionName | RpgActionInput, data?: any): void {
@@ -2298,6 +2430,15 @@ export class RpgClientEngine<T = any> {
     this.lastMovePathSentFrame = 0;
   }
 
+  private clearMapTransferPredictionStates(): void {
+    this.prediction?.clearPendingInputs();
+    this.frameOffset = 0;
+    this.pendingPredictionFrames = [];
+    this.lastClientPhysicsStepAt = 0;
+    this.lastMovePathSentAt = 0;
+    this.lastMovePathSentFrame = this.inputFrameCounter;
+  }
+
   /**
    * Stop local movement immediately and discard pending predicted movement.
    *

package/src/components/scenes/draw-map.ce

@@ -9,7 +9,7 @@
 
   <Container>
     @if (map() && sceneComponent()) {
-      <sceneComponent() data={map().data} params={map().params} />
+      <sceneComponent() data={map()?.data ?? emptySceneData} params={map()?.params ?? emptySceneParams} />
     }
   </Container>
 
@@ -38,6 +38,7 @@
 
 <script>
     import { computed, effect } from 'canvasengine'
+    import './weather-lifecycle-compat'
     import { inject } from "../../core/inject";
     import { RpgClientEngine } from "../../RpgClientEngine";
     import { Weather } from '@canvasengine/presets'
@@ -47,6 +48,8 @@
     const componentAnimations = engine.componentAnimations
     const projectiles = engine.projectiles.current
     const map = engine.sceneMap?.data
+    const emptySceneData = { params: {} }
+    const emptySceneParams = {}
     const sceneComponent = computed(() => map()?.component)
     const weather = engine.sceneMap.weather
     const backgroundMusic = computed(() => {

package/src/components/scenes/weather-lifecycle-compat.ts

@@ -0,0 +1,8 @@
+import "@canvasengine/presets";
+import { createComponent } from "canvasengine";
+import { patchWeatherTickLifecycle } from "./weather-tick-lifecycle";
+
+for (const tag of ["RainTextureLayer", "RainImpactLayer"]) {
+  const probe = createComponent(tag);
+  patchWeatherTickLifecycle(Object.getPrototypeOf(probe.componentInstance));
+}

package/src/components/scenes/weather-tick-lifecycle.spec.ts

@@ -0,0 +1,60 @@
+import { describe, expect, it, vi } from "vitest";
+import { patchWeatherTickLifecycle } from "./weather-tick-lifecycle";
+
+function deferred() {
+  let resolve!: () => void;
+  const promise = new Promise<void>((done) => {
+    resolve = done;
+  });
+  return { promise, resolve };
+}
+
+describe("patchWeatherTickLifecycle", () => {
+  it("stops a tick subscription created by a mount that finishes after destroy", async () => {
+    const started = deferred();
+    const mounted = deferred();
+    const unsubscribe = vi.fn();
+    const prototype = {
+      async onMount(this: any) {
+        started.resolve();
+        await mounted.promise;
+        this.tickSubscription = { unsubscribe };
+      },
+      onDestroy() {},
+    };
+    patchWeatherTickLifecycle(prototype);
+
+    const instance = Object.create(prototype);
+    const mounting = instance.onMount();
+    await started.promise;
+    instance.onDestroy();
+    mounted.resolve();
+    await mounting;
+
+    expect(unsubscribe).toHaveBeenCalledOnce();
+    expect(instance.tickSubscription).toBeUndefined();
+  });
+
+  it("serializes remounts and replaces the previous tick subscription", async () => {
+    const subscriptions = [
+      { unsubscribe: vi.fn() },
+      { unsubscribe: vi.fn() },
+    ];
+    const prototype = {
+      mountCount: 0,
+      async onMount(this: any) {
+        await Promise.resolve();
+        this.tickSubscription = subscriptions[this.mountCount++];
+      },
+      onDestroy() {},
+    };
+    patchWeatherTickLifecycle(prototype);
+
+    const instance = Object.create(prototype);
+    await Promise.all([instance.onMount(), instance.onMount()]);
+
+    expect(subscriptions[0].unsubscribe).toHaveBeenCalledOnce();
+    expect(subscriptions[1].unsubscribe).not.toHaveBeenCalled();
+    expect(instance.tickSubscription).toBe(subscriptions[1]);
+  });
+});

package/src/components/scenes/weather-tick-lifecycle.ts

@@ -0,0 +1,69 @@
+const PATCHED = Symbol.for("@rpgjs/client/weather-tick-lifecycle-patched");
+const DISPOSED = Symbol("weather-tick-lifecycle-disposed");
+const MOUNT_QUEUE = Symbol("weather-tick-lifecycle-mount-queue");
+
+type TickSubscription = {
+  unsubscribe?: () => void;
+};
+
+type TickSubscriptionInstance = {
+  destroyed?: boolean;
+  tickSubscription?: TickSubscription;
+  [DISPOSED]?: boolean;
+  [MOUNT_QUEUE]?: Promise<void>;
+};
+
+type TickSubscriptionPrototype = {
+  [PATCHED]?: boolean;
+  onMount?: (...args: any[]) => unknown;
+  onDestroy?: (...args: any[]) => unknown;
+};
+
+function stopTickSubscription(instance: TickSubscriptionInstance) {
+  instance.tickSubscription?.unsubscribe?.();
+  instance.tickSubscription = undefined;
+}
+
+/**
+ * CanvasEngine presets 2.0.0 can finish mounting a rain layer after that layer
+ * has already been destroyed. The late mount then leaves a tick subscription
+ * operating on a destroyed Pixi object. It can also overwrite an existing
+ * subscription when mounts overlap.
+ *
+ * Keep this compatibility patch local to the affected preset prototypes. It
+ * can be removed once the preset owns the same lifecycle guarantees.
+ */
+export function patchWeatherTickLifecycle(prototype: TickSubscriptionPrototype) {
+  if (!prototype || prototype[PATCHED]) return;
+
+  const originalOnMount = prototype.onMount;
+  const originalOnDestroy = prototype.onDestroy;
+  if (!originalOnMount || !originalOnDestroy) return;
+
+  Object.defineProperty(prototype, PATCHED, { value: true });
+
+  prototype.onMount = function (this: TickSubscriptionInstance, ...args: any[]) {
+    const mount = async () => {
+      if (this[DISPOSED] || this.destroyed) return;
+
+      stopTickSubscription(this);
+      await originalOnMount.apply(this, args);
+
+      if (this[DISPOSED] || this.destroyed) {
+        stopTickSubscription(this);
+      }
+    };
+
+    const pendingMount = (this[MOUNT_QUEUE] ?? Promise.resolve())
+      .catch(() => undefined)
+      .then(mount);
+    this[MOUNT_QUEUE] = pendingMount;
+    return pendingMount;
+  };
+
+  prototype.onDestroy = function (this: TickSubscriptionInstance, ...args: any[]) {
+    this[DISPOSED] = true;
+    stopTickSubscription(this);
+    return originalOnDestroy.apply(this, args);
+  };
+}

package/src/i18n.spec.ts

@@ -4,7 +4,7 @@ import { describe, expect, test } from "vitest";
 import { Context, injector } from "@signe/di";
 import { getOrCreateI18nService } from "@rpgjs/common";
 import { provideClientModules } from "./module";
-import { provideI18n } from "./i18n";
+import { provideI18n, RpgClientBuiltinI18n } from "./i18n";
 
 describe("client i18n", () => {
   test("merges client module translations with game overrides", async () => {
@@ -35,5 +35,6 @@ describe("client i18n", () => {
 
     expect(service.t("menu.title", undefined, "fr")).toBe("Titre du jeu");
     expect(service.t("menu.module-only", undefined, "fr")).toBe("Module");
+    expect(RpgClientBuiltinI18n.en["rpg.transition.loading"]).toBe("Loading area…");
   });
 });

package/src/i18n.ts

@@ -51,6 +51,7 @@ export const RpgClientBuiltinI18n = {
     "rpg.input.error.min-length": "Enter at least {minLength} characters.",
     "rpg.input.error.max-length": "Enter no more than {maxLength} characters.",
     "rpg.input.error.email": "Enter a valid email address.",
+    "rpg.transition.loading": "Loading area…",
     "rpg.shop.default-message": "Welcome to my shop!",
     "rpg.shop.choose-action": "Choose an action",
     "rpg.shop.buy": "Buy",

package/src/index.ts

@@ -7,6 +7,7 @@ export * from "./core/setup";
 export * from "./core/inject";
 export * from "./services/loadMap";
 export * from "./services/actionInput";
+export * from "./services/mapStreaming";
 export * from "./services/pointerContext";
 export * from "./services/interactions";
 export * from "./module";
@@ -24,6 +25,7 @@ export * from "./utils/getEntityProp";
 export { Context } from "@signe/di";
 export { KeyboardControls, Input } from "canvasengine";
 export { Control } from "./services/keyboardControls";
+export { defineModule } from "@rpgjs/common";
 export { RpgClientObject } from "./Game/Object";
 export { RpgClientPlayer } from "./Game/Player";
 export { RpgClientEvent } from "./Game/Event";