ball2d 0.2.2 → 0.3.0

package/dist/stadiums/training_green.ball2dstadium

@@ -0,0 +1,611 @@
+{
+  "version": 1,
+  "physicsMode": "substeps",
+  "name": "Training Green",
+  "width": 435,
+  "height": 265,
+  "spawnDistance": 144,
+  "bg": {
+    "type": "grass",
+    "width": 360,
+    "height": 200,
+    "kickOffRadius": 65,
+    "color": "718C5A",
+    "cornerRadius": 24
+  },
+  "vertexes": [
+    {
+      "x": -336,
+      "y": -200,
+      "cMask": [
+        "ball"
+      ]
+    },
+    {
+      "x": 336,
+      "y": -200,
+      "cMask": [
+        "ball"
+      ]
+    },
+    {
+      "x": 360,
+      "y": -176,
+      "cMask": [
+        "ball"
+      ]
+    },
+    {
+      "x": 360,
+      "y": -90,
+      "cMask": [
+        "ball"
+      ]
+    },
+    {
+      "x": 360,
+      "y": 90,
+      "cMask": [
+        "ball"
+      ]
+    },
+    {
+      "x": 360,
+      "y": 176,
+      "cMask": [
+        "ball"
+      ]
+    },
+    {
+      "x": 336,
+      "y": 200,
+      "cMask": [
+        "ball"
+      ]
+    },
+    {
+      "x": -336,
+      "y": 200,
+      "cMask": [
+        "ball"
+      ]
+    },
+    {
+      "x": -360,
+      "y": 176,
+      "cMask": [
+        "ball"
+      ]
+    },
+    {
+      "x": -360,
+      "y": 90,
+      "cMask": [
+        "ball"
+      ]
+    },
+    {
+      "x": -360,
+      "y": -90,
+      "cMask": [
+        "ball"
+      ]
+    },
+    {
+      "x": -360,
+      "y": -176,
+      "cMask": [
+        "ball"
+      ]
+    },
+    {
+      "x": 336,
+      "y": -200,
+      "cMask": [
+        "ball"
+      ]
+    },
+    {
+      "x": 360,
+      "y": -176,
+      "cMask": [
+        "ball"
+      ]
+    },
+    {
+      "x": 360,
+      "y": 176,
+      "cMask": [
+        "ball"
+      ]
+    },
+    {
+      "x": 336,
+      "y": 200,
+      "cMask": [
+        "ball"
+      ]
+    },
+    {
+      "x": -336,
+      "y": 200,
+      "cMask": [
+        "ball"
+      ]
+    },
+    {
+      "x": -360,
+      "y": 176,
+      "cMask": [
+        "ball"
+      ]
+    },
+    {
+      "x": -360,
+      "y": -176,
+      "cMask": [
+        "ball"
+      ]
+    },
+    {
+      "x": -336,
+      "y": -200,
+      "cMask": [
+        "ball"
+      ]
+    },
+    {
+      "x": -360,
+      "y": -90,
+      "cMask": [
+        "ball"
+      ]
+    },
+    {
+      "x": -390,
+      "y": -90,
+      "cMask": [
+        "ball"
+      ]
+    },
+    {
+      "x": -390,
+      "y": -90,
+      "cMask": [
+        "ball"
+      ]
+    },
+    {
+      "x": -390,
+      "y": 90,
+      "cMask": [
+        "ball"
+      ]
+    },
+    {
+      "x": -390,
+      "y": 90,
+      "cMask": [
+        "ball"
+      ]
+    },
+    {
+      "x": -360,
+      "y": 90,
+      "cMask": [
+        "ball"
+      ]
+    },
+    {
+      "x": 360,
+      "y": -90,
+      "cMask": [
+        "ball"
+      ]
+    },
+    {
+      "x": 390,
+      "y": -90,
+      "cMask": [
+        "ball"
+      ]
+    },
+    {
+      "x": 390,
+      "y": -90,
+      "cMask": [
+        "ball"
+      ]
+    },
+    {
+      "x": 390,
+      "y": 90,
+      "cMask": [
+        "ball"
+      ]
+    },
+    {
+      "x": 390,
+      "y": 90,
+      "cMask": [
+        "ball"
+      ]
+    },
+    {
+      "x": 360,
+      "y": 90,
+      "cMask": [
+        "ball"
+      ]
+    },
+    {
+      "x": 0,
+      "y": -240,
+      "cGroup": [
+        "redKO",
+        "blueKO"
+      ],
+      "cMask": [
+        "red",
+        "blue"
+      ]
+    },
+    {
+      "x": 0,
+      "y": -65,
+      "cGroup": [
+        "redKO",
+        "blueKO"
+      ],
+      "cMask": [
+        "red",
+        "blue"
+      ]
+    },
+    {
+      "x": 0,
+      "y": 65,
+      "cGroup": [
+        "redKO",
+        "blueKO"
+      ],
+      "cMask": [
+        "red",
+        "blue"
+      ]
+    },
+    {
+      "x": 0,
+      "y": 240,
+      "cGroup": [
+        "redKO",
+        "blueKO"
+      ],
+      "cMask": [
+        "red",
+        "blue"
+      ]
+    }
+  ],
+  "segments": [
+    {
+      "v0": 0,
+      "v1": 1,
+      "curve": 0,
+      "cMask": [
+        "ball"
+      ],
+      "color": "FFFFFF",
+      "bCoef": 0.8
+    },
+    {
+      "v0": 2,
+      "v1": 3,
+      "curve": 0,
+      "cMask": [
+        "ball"
+      ],
+      "color": "FFFFFF",
+      "bCoef": 0.8
+    },
+    {
+      "v0": 4,
+      "v1": 5,
+      "curve": 0,
+      "cMask": [
+        "ball"
+      ],
+      "color": "FFFFFF",
+      "bCoef": 0.8
+    },
+    {
+      "v0": 6,
+      "v1": 7,
+      "curve": 0,
+      "cMask": [
+        "ball"
+      ],
+      "color": "FFFFFF",
+      "bCoef": 0.8
+    },
+    {
+      "v0": 8,
+      "v1": 9,
+      "curve": 0,
+      "cMask": [
+        "ball"
+      ],
+      "color": "FFFFFF",
+      "bCoef": 0.8
+    },
+    {
+      "v0": 10,
+      "v1": 11,
+      "curve": 0,
+      "cMask": [
+        "ball"
+      ],
+      "color": "FFFFFF",
+      "bCoef": 0.8
+    },
+    {
+      "v0": 12,
+      "v1": 13,
+      "curve": 90,
+      "cMask": [
+        "ball"
+      ],
+      "color": "FFFFFF",
+      "bCoef": 0.8
+    },
+    {
+      "v0": 14,
+      "v1": 15,
+      "curve": 90,
+      "cMask": [
+        "ball"
+      ],
+      "color": "FFFFFF",
+      "bCoef": 0.8
+    },
+    {
+      "v0": 16,
+      "v1": 17,
+      "curve": 90,
+      "cMask": [
+        "ball"
+      ],
+      "color": "FFFFFF",
+      "bCoef": 0.8
+    },
+    {
+      "v0": 18,
+      "v1": 19,
+      "curve": 90,
+      "cMask": [
+        "ball"
+      ],
+      "color": "FFFFFF",
+      "bCoef": 0.8
+    },
+    {
+      "v0": 20,
+      "v1": 21,
+      "curve": 0,
+      "cMask": [
+        "ball"
+      ],
+      "color": "DDE2E5",
+      "bCoef": 0.15
+    },
+    {
+      "v0": 22,
+      "v1": 23,
+      "curve": 0,
+      "cMask": [
+        "ball"
+      ],
+      "color": "DDE2E5",
+      "bCoef": 0.15
+    },
+    {
+      "v0": 24,
+      "v1": 25,
+      "curve": 0,
+      "cMask": [
+        "ball"
+      ],
+      "color": "DDE2E5",
+      "bCoef": 0.15
+    },
+    {
+      "v0": 26,
+      "v1": 27,
+      "curve": 0,
+      "cMask": [
+        "ball"
+      ],
+      "color": "DDE2E5",
+      "bCoef": 0.15
+    },
+    {
+      "v0": 28,
+      "v1": 29,
+      "curve": 0,
+      "cMask": [
+        "ball"
+      ],
+      "color": "DDE2E5",
+      "bCoef": 0.15
+    },
+    {
+      "v0": 30,
+      "v1": 31,
+      "curve": 0,
+      "cMask": [
+        "ball"
+      ],
+      "color": "DDE2E5",
+      "bCoef": 0.15
+    },
+    {
+      "v0": 32,
+      "v1": 33,
+      "vis": false,
+      "cGroup": [
+        "redKO",
+        "blueKO"
+      ],
+      "cMask": [
+        "red",
+        "blue"
+      ]
+    },
+    {
+      "v0": 34,
+      "v1": 35,
+      "vis": false,
+      "cGroup": [
+        "redKO",
+        "blueKO"
+      ],
+      "cMask": [
+        "red",
+        "blue"
+      ]
+    },
+    {
+      "v0": 34,
+      "v1": 33,
+      "curve": -180,
+      "vis": false,
+      "cGroup": [
+        "redKO"
+      ],
+      "cMask": [
+        "red",
+        "blue"
+      ]
+    },
+    {
+      "v0": 34,
+      "v1": 33,
+      "curve": 180,
+      "vis": false,
+      "cGroup": [
+        "blueKO"
+      ],
+      "cMask": [
+        "red",
+        "blue"
+      ]
+    }
+  ],
+  "planes": [
+    {
+      "normal": [
+        0,
+        1
+      ],
+      "dist": -240
+    },
+    {
+      "normal": [
+        0,
+        -1
+      ],
+      "dist": -240
+    },
+    {
+      "normal": [
+        1,
+        0
+      ],
+      "dist": -410
+    },
+    {
+      "normal": [
+        -1,
+        0
+      ],
+      "dist": -410
+    }
+  ],
+  "goals": [
+    {
+      "p0": [
+        -360,
+        -90
+      ],
+      "p1": [
+        -360,
+        90
+      ],
+      "team": "red"
+    },
+    {
+      "p0": [
+        360,
+        -90
+      ],
+      "p1": [
+        360,
+        90
+      ],
+      "team": "blue"
+    }
+  ],
+  "discs": [
+    {
+      "pos": [
+        -360,
+        -90
+      ],
+      "radius": 6,
+      "invMass": 0,
+      "color": "FFFFFF",
+      "bCoef": 0.5
+    },
+    {
+      "pos": [
+        -360,
+        90
+      ],
+      "radius": 6,
+      "invMass": 0,
+      "color": "FFFFFF",
+      "bCoef": 0.5
+    },
+    {
+      "pos": [
+        360,
+        -90
+      ],
+      "radius": 6,
+      "invMass": 0,
+      "color": "FFFFFF",
+      "bCoef": 0.5
+    },
+    {
+      "pos": [
+        360,
+        90
+      ],
+      "radius": 6,
+      "invMass": 0,
+      "color": "FFFFFF",
+      "bCoef": 0.5
+    }
+  ],
+  "ballPhysics": {
+    "radius": 9,
+    "damping": 0.991,
+    "bCoef": 0.6
+  },
+  "playerPhysics": {
+    "radius": 15,
+    "acceleration": 0.11,
+    "damping": 0.96,
+    "kickStrength": 5.5
+  }
+}

package/dist/types/browser.d.ts

@@ -5,6 +5,12 @@ import type { Replay } from './replay.js';
 import type { StadiumValidation } from './stadium.js';
 export type { RoomConfig, CreateRoomOptions, Room, Replay, StadiumValidation };
 export type { HostPlayer, HostScores, HostDiscProperties } from './player.js';
+/** Room creation was rejected by the signaling service. */
+export declare class RoomAdmissionError extends Error {
+    readonly status: number;
+    readonly retryAfterSeconds: number | null;
+    constructor(message: string, status: number, retryAfterSeconds?: number | null);
+}
 export declare function createRoom(config?: RoomConfig, options?: CreateRoomOptions): Promise<Room>;
 export declare function readReplay(blob: Blob): Promise<Replay>;
 export declare function validateStadium(source: string): StadiumValidation;

package/dist/types/config.d.ts

@@ -1,3 +1,4 @@
+import type { RoomGeo } from './room-geo.js';
 export interface RoomConfig {
     noPlayer?: boolean;
     playerName?: string;
@@ -6,4 +7,6 @@ export interface RoomConfig {
     password?: string;
     public?: boolean;
     stadium?: string;
+    /** Override the room's advertised location; does not select a game server. */
+    geo?: RoomGeo;
 }

package/dist/types/match-state.d.ts

@@ -1,6 +1,12 @@
+export interface BallTouch {
+    slot: number;
+    team: 1 | 2;
+}
 export interface MatchState {
-    /** Complete terrain checkpoint. Omitted for historical or disabled surfaces. */
-    surface?: number[];
+    /** Host-simulated touch; null when no player has touched this kickoff. */
+    lastTouch?: BallTouch | null;
+    /** Frozen at the goal line, including the player's team for own goals. */
+    goalTouch?: BallTouch | null;
     tick: number;
     elapsed: number;
     red: number;

package/dist/types/node.d.ts

@@ -1,10 +1,10 @@
 import type { RoomConfig } from './config.js';
 import type { Room } from './room.js';
 import type { CreateRoomOptions } from './creation.js';
-export { readReplay, validateStadium } from './browser.js';
+export { readReplay, validateStadium, RoomAdmissionError } from './browser.js';
 export type { Replay, StadiumValidation, CreateRoomOptions, HostPlayer, HostScores, HostDiscProperties, } from './browser.js';
 export interface NodeRoomConfig extends RoomConfig {
-    /** Ball2D signaling service. Defaults to https://ball2d.com. */
+    /** Ball2D signaling service. Defaults to HTTPS; HTTP permits loopback only. */
     serviceOrigin?: string;
     /** Required account-owned API key. Keep it on your server, never in browser code. */
     apiKey: string;

package/dist/types/player.d.ts

@@ -12,6 +12,8 @@ export interface HostPlayer {
         x: number;
         y: number;
     } | null;
+    /** Current authoritative key bitmask: up 1, down 2, left 4, right 8, kick 16. */
+    input: number;
 }
 export interface HostScores {
     red: number;

package/dist/types/replay.d.ts

@@ -3,7 +3,7 @@ import type { TeamStyles } from './team.js';
 import type { MatchState } from './match-state.js';
 export type ReplayCommand = {
     tick: number;
-    kind: 'input' | 'team' | 'start' | 'stop' | 'pause' | 'scoreLimit' | 'timeLimit' | 'kickRate' | 'join' | 'disc' | 'surface';
+    kind: 'input' | 'team' | 'start' | 'stop' | 'pause' | 'scoreLimit' | 'timeLimit' | 'kickRate' | 'join' | 'disc' | 'finishDraw';
     properties?: DiscPropertyPatch;
     slot: number;
     value: number;

package/dist/types/room-geo.d.ts

@@ -0,0 +1,6 @@
+/** Public discovery location; never a routing or authorization claim. */
+export interface RoomGeo {
+    code: string;
+    lat: number;
+    lon: number;
+}