minimojs 1.0.0-alpha.40 → 1.0.0-alpha.41

package/dist/minimo-multiplayer.d.ts

@@ -293,7 +293,8 @@ export declare class Room {
  *
  * {@link Multiplayer.lobby} shows the lobby over the game, in HTML: creating a
  * room, joining one by its code, sharing its link, and waiting for the others
- * until the host starts. A player who opens the room's link lands in it.
+ * until the host starts. A player who opened the room's link lands in it as
+ * soon as the game calls it.
  *
  * ```js
  * import { Multiplayer } from "https://cdn.jsdelivr.net/npm/minimojs@<version>/dist/minimo-multiplayer.js";
@@ -309,15 +310,27 @@ export declare class Room {
  * const choice = await room.showResults(); // "rematch" or "leave"
  * ```
  *
- * A game with its own welcome screen asks {@link Multiplayer.pendingRoom}
- * first, so a player who opened a room's link, or reloaded the page in a
- * room, goes straight to it instead of to the welcome screen:
+ * A player who opens a room's link has already chosen to play online and
+ * which room to join. So a game asks {@link Multiplayer.pendingRoom} as soon
+ * as its assets are loaded, before showing anything. When a room is pending,
+ * it skips every screen that only leads to a room or that the host decides,
+ * such as a title screen, menus, playing alone or online, creating or joining,
+ * the mode, the difficulty, the rules, or the level, and shows only the
+ * choices that are the player's own, such as a character or a color, before
+ * {@link Multiplayer.lobby} or after it:
  *
  * ```js
  * const pending = await mp.pendingRoom();
- * if (pending) room = await mp.lobby(); // that room's lobby, or its game in progress
- * else showWelcome();                   // Play online, then mp.lobby() to create or join
+ * if (pending) {
+ *   await chooseCharacter();   // only the player's own choices
+ *   room = await mp.lobby();   // that room's lobby, or its game in progress
+ * } else showWelcome();        // Play online, then mp.lobby() to create or join
  * ```
+ *
+ * What every player must share is the host's choice and travels in the
+ * room's state. A player returning to a room after a reload (`invited` is
+ * false) is asked again only what the game could not keep. When the player
+ * closes the lobby, show the welcome screen.
  */
 export declare class Multiplayer {
     /**

package/dist/minimo-multiplayer.js

@@ -757,7 +757,8 @@ export class Room {
  *
  * {@link Multiplayer.lobby} shows the lobby over the game, in HTML: creating a
  * room, joining one by its code, sharing its link, and waiting for the others
- * until the host starts. A player who opens the room's link lands in it.
+ * until the host starts. A player who opened the room's link lands in it as
+ * soon as the game calls it.
  *
  * ```js
  * import { Multiplayer } from "https://cdn.jsdelivr.net/npm/minimojs@<version>/dist/minimo-multiplayer.js";
@@ -773,15 +774,27 @@ export class Room {
  * const choice = await room.showResults(); // "rematch" or "leave"
  * ```
  *
- * A game with its own welcome screen asks {@link Multiplayer.pendingRoom}
- * first, so a player who opened a room's link, or reloaded the page in a
- * room, goes straight to it instead of to the welcome screen:
+ * A player who opens a room's link has already chosen to play online and
+ * which room to join. So a game asks {@link Multiplayer.pendingRoom} as soon
+ * as its assets are loaded, before showing anything. When a room is pending,
+ * it skips every screen that only leads to a room or that the host decides,
+ * such as a title screen, menus, playing alone or online, creating or joining,
+ * the mode, the difficulty, the rules, or the level, and shows only the
+ * choices that are the player's own, such as a character or a color, before
+ * {@link Multiplayer.lobby} or after it:
  *
  * ```js
  * const pending = await mp.pendingRoom();
- * if (pending) room = await mp.lobby(); // that room's lobby, or its game in progress
- * else showWelcome();                   // Play online, then mp.lobby() to create or join
+ * if (pending) {
+ *   await chooseCharacter();   // only the player's own choices
+ *   room = await mp.lobby();   // that room's lobby, or its game in progress
+ * } else showWelcome();        // Play online, then mp.lobby() to create or join
  * ```
+ *
+ * What every player must share is the host's choice and travels in the
+ * room's state. A player returning to a room after a reload (`invited` is
+ * false) is asked again only what the game could not keep. When the player
+ * closes the lobby, show the welcome screen.
  */
 export class Multiplayer {
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "minimojs",
-  "version": "1.0.0-alpha.40",
+  "version": "1.0.0-alpha.41",
   "description": "MinimoJS v1 — ultra-minimal, flat, deterministic 2D web game engine. Image-first sprites with emoji as a zero-asset alternative, rAF loop, TypeScript-first, LLM-friendly.",
   "type": "module",
   "main": "dist/minimo.js",