ball2d 0.0.1 → 0.1.0

package/dist/stadiums/huge.hbs

@@ -0,0 +1,85 @@
+{
+	"name" : "Huge",
+	
+	"width" : 800,
+	"height" : 350,
+	
+	"spawnDistance" : 350,
+	
+	"bg" : { "type" : "grass", "width" : 700, "height" : 320, "kickOffRadius" : 80, "cornerRadius" : 0 },
+
+	"vertexes" : [
+		{ "x" : -700, "y" : 320,  "trait" : "ballArea" },
+		{ "x" : -700, "y" : 100,   "trait" : "ballArea" },
+		{ "x" : -700, "y" : -100,  "trait" : "ballArea" },
+		{ "x" : -700, "y" : -320, "trait" : "ballArea" },
+		
+		{ "x" : 700, "y" : 320,  "trait" : "ballArea" },
+		{ "x" : 700, "y" : 100,   "trait" : "ballArea" },
+		{ "x" : 700, "y" : -100,  "trait" : "ballArea" },
+		{ "x" : 700, "y" : -320, "trait" : "ballArea" },
+		
+		{ "x" : 0, "y" :  350, "trait" : "kickOffBarrier" },
+		{ "x" : 0, "y" :   80, "trait" : "kickOffBarrier" },
+		{ "x" : 0, "y" :  -80, "trait" : "kickOffBarrier" },
+		{ "x" : 0, "y" : -350, "trait" : "kickOffBarrier" },
+		
+		{ "x" : -710, "y" : -100, "trait" : "goalNet" },
+		{ "x" : -730, "y" : -80, "trait" : "goalNet" },
+		{ "x" : -730, "y" :  80, "trait" : "goalNet" },
+		{ "x" : -710, "y" :  100, "trait" : "goalNet" },
+		
+		{ "x" : 710, "y" : -100, "trait" : "goalNet" },
+		{ "x" : 730, "y" : -80, "trait" : "goalNet" },
+		{ "x" : 730, "y" :  80, "trait" : "goalNet" },
+		{ "x" : 710, "y" :  100, "trait" : "goalNet" }
+	],
+	
+	"segments" : [
+		{ "v0" : 0, "v1" : 1, "trait" : "ballArea" },
+		{ "v0" : 2, "v1" : 3, "trait" : "ballArea" },
+		{ "v0" : 4, "v1" : 5, "trait" : "ballArea" },
+		{ "v0" : 6, "v1" : 7, "trait" : "ballArea" },
+		
+		{ "v0" : 12, "v1" : 13, "trait" : "goalNet", "curve" : -90 },
+		{ "v0" : 13, "v1" : 14, "trait" : "goalNet" },
+		{ "v0" : 14, "v1" : 15, "trait" : "goalNet", "curve" : -90 },
+		
+		{ "v0" : 16, "v1" : 17, "trait" : "goalNet", "curve" : 90 },
+		{ "v0" : 17, "v1" : 18, "trait" : "goalNet" },
+		{ "v0" : 18, "v1" : 19, "trait" : "goalNet", "curve" : 90 },
+		
+		{ "v0" : 8, "v1" : 9, "trait" : "kickOffBarrier" },
+		{ "v0" : 9, "v1" : 10, "trait" : "kickOffBarrier", "curve" : 180, "cGroup" : ["blueKO"] },
+		{ "v0" : 9, "v1" : 10, "trait" : "kickOffBarrier", "curve" : -180, "cGroup" : ["redKO"] },
+		{ "v0" : 10, "v1" : 11, "trait" : "kickOffBarrier" }
+	],
+	
+	"goals" : [
+		{ "p0" : [-700, 100], "p1" : [-700,-100], "team" : "red" },
+		{ "p0" : [700, 100], "p1" : [700,-100], "team" : "blue" }
+	],
+	
+	"discs" : [
+		{ "pos" : [-700,  100], "trait" : "goalPost", "color" : "FFCCCC" },
+		{ "pos" : [-700, -100], "trait" : "goalPost", "color" : "FFCCCC" },
+		{ "pos" : [ 700,  100], "trait" : "goalPost", "color" : "CCCCFF" },
+		{ "pos" : [ 700, -100], "trait" : "goalPost", "color" : "CCCCFF" }
+	],
+	
+	"planes" : [
+		{ "normal" : [0, 1], "dist" : -320, "trait" : "ballArea" },
+		{ "normal" : [0,-1], "dist" : -320, "trait" : "ballArea" },
+		{ "normal" : [ 0, 1], "dist" : -350, "bCoef" : 0.1 },
+		{ "normal" : [ 0,-1], "dist" : -350, "bCoef" : 0.1 },
+		{ "normal" : [ 1, 0], "dist" : -800, "bCoef" : 0.1 },
+		{ "normal" : [-1, 0], "dist" : -800, "bCoef" : 0.1 }
+	],
+	
+	"traits" : {
+		"ballArea" : { "vis" : false, "bCoef" : 1, "cMask" : ["ball"] },
+		"goalPost" : { "radius" : 8, "invMass" : 0, "bCoef" : 0.5 },
+		"goalNet" : { "vis" : true, "bCoef" : 0.1, "cMask" : ["ball"] }, 
+		"kickOffBarrier" : { "vis" : false, "bCoef" : 0.1, "cGroup" : ["redKO", "blueKO"], "cMask" : ["red", "blue"] }
+	}
+}

package/dist/stadiums/provenance.json

@@ -0,0 +1,46 @@
+{
+  "source": "https://github.com/haxball/haxball-issues/tree/master/stadiums",
+  "commit": "d3154004b7ef1c41788dde754d8b6bbf38a0a091",
+  "files": [
+    {
+      "file": "big.hbs",
+      "sha256": "0b325750b6c21677c8a7d3a5d7b17466a4f7c6cceeb43748a79fbaf224cf751c"
+    },
+    {
+      "file": "big_easy.hbs",
+      "sha256": "8cc9b06cf10d114c1285790ad7fc77dda37fbcec21f6cca3d0ca2d4040443d03"
+    },
+    {
+      "file": "big_hockey.hbs",
+      "sha256": "bc008f5bac3b3f39084d12b53b07c54a28df8032c765da23b5c08c0acc53319c"
+    },
+    {
+      "file": "big_rounded.hbs",
+      "sha256": "55d967ceb06d6774bc0be30b22af283b0fe0d690bcc8b9052c5555a19d27ec70"
+    },
+    {
+      "file": "classic.hbs",
+      "sha256": "e37799568e4fbdc04f64bcebc8b62825d426bf418ca1e0274f26d6aac204c3c8"
+    },
+    {
+      "file": "easy.hbs",
+      "sha256": "60fcc0863d68b847dd0fcb8037aa9f0d78451683591a72dfae6a6190dce13cd8"
+    },
+    {
+      "file": "hockey.hbs",
+      "sha256": "4e040662c3da6e1afa42cab93ffe8985497dabc1512ed81643b3ac157564713e"
+    },
+    {
+      "file": "huge.hbs",
+      "sha256": "704eb73b2e198e792a04badbf1f97212d361e184481d676d092b5181733c62c9"
+    },
+    {
+      "file": "rounded.hbs",
+      "sha256": "287cef71daac552256b06a29c103aedb9ce26177bf85b9bab00da13e0b3cfcd2"
+    },
+    {
+      "file": "small.hbs",
+      "sha256": "757a35605d65a2f610992bd8c87e2b6396845e4f8996786bccd29661b025fb13"
+    }
+  ]
+}

package/dist/stadiums/rounded.hbs

@@ -0,0 +1,100 @@
+{
+	"name" : "Rounded",
+	
+	"width" : 420,
+	"height" : 200,
+	
+	"spawnDistance" : 170,
+	
+	"bg" : { "type" : "grass", "width" : 370, "height" : 170, "kickOffRadius" : 75, "cornerRadius" : 75 },
+
+	"vertexes" : [
+		{ "x" : -370, "y" : 170,  "trait" : "ballArea" },
+		{ "x" : -370, "y" : 64,   "trait" : "ballArea" },
+		{ "x" : -370, "y" : -64,  "trait" : "ballArea" },
+		{ "x" : -370, "y" : -170, "trait" : "ballArea" },
+		
+		{ "x" : 370, "y" : 170,  "trait" : "ballArea" },
+		{ "x" : 370, "y" : 64,   "trait" : "ballArea" },
+		{ "x" : 370, "y" : -64,  "trait" : "ballArea" },
+		{ "x" : 370, "y" : -170, "trait" : "ballArea" },
+		
+		{ "x" : 0, "y" :  200, "trait" : "kickOffBarrier" },
+		{ "x" : 0, "y" :   75, "trait" : "kickOffBarrier" },
+		{ "x" : 0, "y" :  -75, "trait" : "kickOffBarrier" },
+		{ "x" : 0, "y" : -200, "trait" : "kickOffBarrier" },
+		
+		{ "x" : -380, "y" : -64, "trait" : "goalNet" },
+		{ "x" : -400, "y" : -44, "trait" : "goalNet" },
+		{ "x" : -400, "y" :  44, "trait" : "goalNet" },
+		{ "x" : -380, "y" :  64, "trait" : "goalNet" },
+		
+		{ "x" : 380, "y" : -64, "trait" : "goalNet" },
+		{ "x" : 400, "y" : -44, "trait" : "goalNet" },
+		{ "x" : 400, "y" :  44, "trait" : "goalNet" },
+		{ "x" : 380, "y" :  64, "trait" : "goalNet" },
+		
+		{ "x" : -295, "y" : -170,  "trait" : "ballArea" },
+		{ "x" : -370, "y" :  -95,  "trait" : "ballArea" },
+		{ "x" : -370, "y" :   95,  "trait" : "ballArea" },
+		{ "x" : -295, "y" :  170,  "trait" : "ballArea" },
+		
+		{ "x" : 295, "y" : -170,  "trait" : "ballArea" },
+		{ "x" : 370, "y" :  -95,  "trait" : "ballArea" },
+		{ "x" : 370, "y" :   95,  "trait" : "ballArea" },
+		{ "x" : 295, "y" :  170,  "trait" : "ballArea" }
+	],
+	
+	"segments" : [
+		{ "v0" : 0, "v1" : 1, "trait" : "ballArea" },
+		{ "v0" : 2, "v1" : 3, "trait" : "ballArea" },
+		{ "v0" : 4, "v1" : 5, "trait" : "ballArea" },
+		{ "v0" : 6, "v1" : 7, "trait" : "ballArea" },
+		
+		{ "v0" : 12, "v1" : 13, "trait" : "goalNet", "curve" : -90 },
+		{ "v0" : 13, "v1" : 14, "trait" : "goalNet" },
+		{ "v0" : 14, "v1" : 15, "trait" : "goalNet", "curve" : -90 },
+		
+		{ "v0" : 16, "v1" : 17, "trait" : "goalNet", "curve" : 90 },
+		{ "v0" : 17, "v1" : 18, "trait" : "goalNet" },
+		{ "v0" : 18, "v1" : 19, "trait" : "goalNet", "curve" : 90 },
+		
+		{ "v0" : 8, "v1" : 9, "trait" : "kickOffBarrier" },
+		{ "v0" : 9, "v1" : 10, "trait" : "kickOffBarrier", "curve" : 180, "cGroup" : ["blueKO"] },
+		{ "v0" : 9, "v1" : 10, "trait" : "kickOffBarrier", "curve" : -180, "cGroup" : ["redKO"] },
+		{ "v0" : 10, "v1" : 11, "trait" : "kickOffBarrier" },
+		
+		{ "v0" : 20, "v1" : 21, "trait" : "ballArea", "curve" : -90 },
+		{ "v0" : 22, "v1" : 23, "trait" : "ballArea", "curve" : -90 },
+		{ "v0" : 24, "v1" : 25, "trait" : "ballArea", "curve" : 90 },
+		{ "v0" : 26, "v1" : 27, "trait" : "ballArea", "curve" : 90 }
+	],
+	
+	"goals" : [
+		{ "p0" : [-370, 64], "p1" : [-370,-64], "team" : "red" },
+		{ "p0" : [370, 64], "p1" : [370,-64], "team" : "blue" }
+	],
+	
+	"discs" : [
+		{ "pos" : [-370,  64], "trait" : "goalPost", "color" : "FFCCCC" },
+		{ "pos" : [-370, -64], "trait" : "goalPost", "color" : "FFCCCC" },
+		{ "pos" : [ 370,  64], "trait" : "goalPost", "color" : "CCCCFF" },
+		{ "pos" : [ 370, -64], "trait" : "goalPost", "color" : "CCCCFF" }
+	],
+	
+	"planes" : [
+		{ "normal" : [0, 1], "dist" : -170, "trait" : "ballArea" },
+		{ "normal" : [0,-1], "dist" : -170, "trait" : "ballArea" },
+		{ "normal" : [ 0, 1], "dist" : -200, "bCoef" : 0.1 },
+		{ "normal" : [ 0,-1], "dist" : -200, "bCoef" : 0.1 },
+		{ "normal" : [ 1, 0], "dist" : -420, "bCoef" : 0.1 },
+		{ "normal" : [-1, 0], "dist" : -420, "bCoef" : 0.1 }
+	],
+	
+	"traits" : {
+		"ballArea" : { "vis" : false, "bCoef" : 1, "cMask" : ["ball"] },
+		"goalPost" : { "radius" : 8, "invMass" : 0, "bCoef" : 0.5 },
+		"goalNet" : { "vis" : true, "bCoef" : 0.1, "cMask" : ["ball"] }, 
+		"kickOffBarrier" : { "vis" : false, "bCoef" : 0.1, "cGroup" : ["redKO", "blueKO"], "cMask" : ["red", "blue"] }
+	}
+}

package/dist/stadiums/small.hbs

@@ -0,0 +1,85 @@
+{
+	"name" : "Small",
+	
+	"width" : 420,
+	"height" : 200,
+	
+	"spawnDistance" : 130,
+	
+	"bg" : { "type" : "grass", "width" : 320, "height" : 130, "kickOffRadius" : 70, "cornerRadius" : 0 },
+
+	"vertexes" : [
+		{ "x" : -320, "y" : 130,  "trait" : "ballArea" },
+		{ "x" : -320, "y" : 55,   "trait" : "ballArea" },
+		{ "x" : -320, "y" : -55,  "trait" : "ballArea" },
+		{ "x" : -320, "y" : -130, "trait" : "ballArea" },
+		
+		{ "x" : 320, "y" : 130,  "trait" : "ballArea" },
+		{ "x" : 320, "y" : 55,   "trait" : "ballArea" },
+		{ "x" : 320, "y" : -55,  "trait" : "ballArea" },
+		{ "x" : 320, "y" : -130, "trait" : "ballArea" },
+		
+		{ "x" : 0, "y" :  200, "trait" : "kickOffBarrier" },
+		{ "x" : 0, "y" :   70, "trait" : "kickOffBarrier" },
+		{ "x" : 0, "y" :  -70, "trait" : "kickOffBarrier" },
+		{ "x" : 0, "y" : -200, "trait" : "kickOffBarrier" },
+		
+		{ "x" : -330, "y" : -55, "trait" : "goalNet" },
+		{ "x" : -350, "y" : -35, "trait" : "goalNet" },
+		{ "x" : -350, "y" :  35, "trait" : "goalNet" },
+		{ "x" : -330, "y" :  55, "trait" : "goalNet" },
+		
+		{ "x" : 330, "y" : -55, "trait" : "goalNet" },
+		{ "x" : 350, "y" : -35, "trait" : "goalNet" },
+		{ "x" : 350, "y" :  35, "trait" : "goalNet" },
+		{ "x" : 330, "y" :  55, "trait" : "goalNet" }
+	],
+	
+	"segments" : [
+		{ "v0" : 0, "v1" : 1, "trait" : "ballArea" },
+		{ "v0" : 2, "v1" : 3, "trait" : "ballArea" },
+		{ "v0" : 4, "v1" : 5, "trait" : "ballArea" },
+		{ "v0" : 6, "v1" : 7, "trait" : "ballArea" },
+		
+		{ "v0" : 12, "v1" : 13, "trait" : "goalNet", "curve" : -90 },
+		{ "v0" : 13, "v1" : 14, "trait" : "goalNet" },
+		{ "v0" : 14, "v1" : 15, "trait" : "goalNet", "curve" : -90 },
+		
+		{ "v0" : 16, "v1" : 17, "trait" : "goalNet", "curve" : 90 },
+		{ "v0" : 17, "v1" : 18, "trait" : "goalNet" },
+		{ "v0" : 18, "v1" : 19, "trait" : "goalNet", "curve" : 90 },
+		
+		{ "v0" : 8, "v1" : 9, "trait" : "kickOffBarrier" },
+		{ "v0" : 9, "v1" : 10, "trait" : "kickOffBarrier", "curve" : 180, "cGroup" : ["blueKO"] },
+		{ "v0" : 9, "v1" : 10, "trait" : "kickOffBarrier", "curve" : -180, "cGroup" : ["redKO"] },
+		{ "v0" : 10, "v1" : 11, "trait" : "kickOffBarrier" }
+	],
+	
+	"goals" : [
+		{ "p0" : [-320, 55], "p1" : [-320,-55], "team" : "red" },
+		{ "p0" : [320, 55], "p1" : [320,-55], "team" : "blue" }
+	],
+	
+	"discs" : [
+		{ "pos" : [-320,  55], "trait" : "goalPost", "color" : "FFCCCC" },
+		{ "pos" : [-320, -55], "trait" : "goalPost", "color" : "FFCCCC" },
+		{ "pos" : [ 320,  55], "trait" : "goalPost", "color" : "CCCCFF" },
+		{ "pos" : [ 320, -55], "trait" : "goalPost", "color" : "CCCCFF" }
+	],
+	
+	"planes" : [
+		{ "normal" : [0, 1], "dist" : -130, "trait" : "ballArea" },
+		{ "normal" : [0,-1], "dist" : -130, "trait" : "ballArea" },
+		{ "normal" : [ 0, 1], "dist" : -200, "bCoef" : 0.1 },
+		{ "normal" : [ 0,-1], "dist" : -200, "bCoef" : 0.1 },
+		{ "normal" : [ 1, 0], "dist" : -420, "bCoef" : 0.1 },
+		{ "normal" : [-1, 0], "dist" : -420, "bCoef" : 0.1 }
+	],
+	
+	"traits" : {
+		"ballArea" : { "vis" : false, "bCoef" : 1, "cMask" : ["ball"] },
+		"goalPost" : { "radius" : 8, "invMass" : 0, "bCoef" : 0.5 },
+		"goalNet" : { "vis" : true, "bCoef" : 0.1, "cMask" : ["ball"] }, 
+		"kickOffBarrier" : { "vis" : false, "bCoef" : 0.1, "cGroup" : ["redKO", "blueKO"], "cMask" : ["red", "blue"] }
+	}
+}

package/dist/types/client/announcement.d.ts

@@ -0,0 +1,10 @@
+export declare const announcementStyles: readonly ['normal', 'bold', 'italic', 'small', 'small-bold', 'small-italic'];
+export type AnnouncementStyle = (typeof announcementStyles)[number];
+export interface Announcement {
+    type: 'announcement';
+    text: string;
+    color: number | null;
+    style: AnnouncementStyle;
+    sound: 0 | 1 | 2;
+}
+export declare function announcement(text: string, color?: number | null, style?: AnnouncementStyle | null, sound?: number | null): Announcement;

package/dist/types/client/connection-stats.d.ts

@@ -0,0 +1,11 @@
+interface StatsRow {
+    id: string;
+    type: string;
+    selectedCandidatePairId?: string;
+    state?: string;
+    nominated?: boolean;
+    currentRoundTripTime?: number;
+}
+/** Selected ICE path RTT from STUN checks; not input-to-display latency. */
+export declare function selectedRtt(rows: Iterable<StatsRow>): number | null;
+export {};

package/dist/types/client/headless.d.ts

@@ -0,0 +1,130 @@
+import { type HostConfig } from './host-config.js';
+import { type AnnouncementStyle } from './announcement.js';
+import { type DiscPropertyPatch } from '../core/disc-properties.js';
+import { type HostRuntime } from './host-runtime.js';
+import { Engine, type MatchState } from '../core/engine.js';
+import { Network } from './network.js';
+import type { HostPlayer, HostScores, HostDiscProperties } from '../core/host-types.js';
+export type { HostPlayer, HostScores, HostDiscProperties } from '../core/host-types.js';
+export type { HostConfig } from './host-config.js';
+/** Shared headless room implementation; browser runtime is the current default. */
+export declare class HeadlessRoom {
+    private readonly runtime;
+    readonly engine: Engine;
+    network: Network;
+    roomId: string;
+    roomLink: string;
+    roomName: string;
+    private epoch;
+    private stadiumSelection;
+    private players;
+    private nextPlayerId;
+    private bans;
+    private loop?;
+    private linkNotification?;
+    private last;
+    private accumulator;
+    private recorder?;
+    private closed;
+    private readonly closeController;
+    readonly signal: AbortSignal;
+    private finishingRecording;
+    lastRecording: Blob | null;
+    onRecordingComplete?: (blob: Blob, reason: string) => void;
+    private locked;
+    private teamStyles;
+    private inputs;
+    private traffic;
+    onRoomLink?: (url: string) => void;
+    onPlayerJoin?: (p: HostPlayer) => void;
+    onPlayerTeamChange?: (p: HostPlayer, byPlayer: HostPlayer | null) => void;
+    onPlayerAdminChange?: (p: HostPlayer, byPlayer: HostPlayer | null) => void;
+    onGameStart?: (byPlayer: HostPlayer | null) => void;
+    onGameStop?: (byPlayer: HostPlayer | null) => void;
+    onTeamVictory?: (scores: HostScores) => void;
+    /** Legacy Ball2D callback; prefer onTeamVictory. */
+    onGameVictory?: (scores: HostScores) => void;
+    onGamePauseChange?: (paused: boolean) => void;
+    onGamePause?: (byPlayer: HostPlayer | null) => void;
+    onGameUnpause?: (byPlayer: HostPlayer | null) => void;
+    onPlayerLeave?: (p: HostPlayer) => void;
+    onPlayerKicked?: (p: HostPlayer, reason: string, ban: boolean, byPlayer: HostPlayer | null) => void;
+    onPlayerActivity?: (p: HostPlayer) => void;
+    onPlayerChat?: (p: HostPlayer, text: string) => boolean | void;
+    onPlayerBallKick?: (p: HostPlayer) => void;
+    onTeamGoal?: (team: 1 | 2) => void;
+    onPositionsReset?: () => void;
+    onStadiumChange?: (name: string, byPlayer: HostPlayer | null) => void;
+    onTeamsLockChange?: (locked: boolean, byPlayer: HostPlayer | null) => void;
+    onKickRateLimitSet?: (min: number, rate: number, burst: number, byPlayer: HostPlayer | null) => void;
+    onGameTick?: () => void;
+    onError?: (message: string) => void;
+    private report;
+    private invoke;
+    private constructor();
+    static create(config: HostConfig, runtime?: HostRuntime, signal?: AbortSignal): Promise<HeadlessRoom>;
+    private advance;
+    private allowed;
+    private control;
+    private fast;
+    private command;
+    private roster;
+    private sync;
+    private state;
+    private leave;
+    private playerCopy;
+    getPlayerList(): HostPlayer[];
+    getPlayer(id: number): HostPlayer | null;
+    setTeamColors(team: number, angle: number, textColor: number, colors: number[]): void;
+    private changeTeamColors;
+    reorderPlayers(playerIdList: number[], moveToTop: boolean): void;
+    setPlayerAvatar(id: number, avatar: string | null): void;
+    setPlayerTeam(id: number, team: 0 | 1 | 2): void;
+    private changeTeam;
+    setPlayerAdmin(id: number, admin: boolean): void;
+    setTeamsLock(locked: boolean): void;
+    private changeTeamsLock;
+    kickPlayer(id: number, reason?: string, ban?: boolean): void | Promise<void>;
+    private banPlayer;
+    clearBan(id: number): Promise<void>;
+    clearBans(): Promise<void>;
+    private removePlayer;
+    sendChat(text: string, targetId?: number | null): void;
+    sendAnnouncement(text: string, targetId?: number | null, color?: number | null, style?: AnnouncementStyle | null, sound?: number | null): void;
+    startGame(): void;
+    private beginGame;
+    stopGame(): void;
+    private endGame;
+    pauseGame(paused: boolean): void;
+    private changePause;
+    setKickRateLimit(min?: number, rate?: number, burst?: number): void;
+    private changeKickRateLimit;
+    setPassword(password: string | null): Promise<void>;
+    get requireVerification(): boolean | null;
+    setRequireVerification(required: boolean): Promise<void>;
+    /** Migration alias: Ball2D uses Turnstile, not Google's reCAPTCHA. */
+    setRequireRecaptcha(required: boolean): Promise<void>;
+    setScoreLimit(limit: number): void;
+    setTimeLimit(minutes: number): void;
+    setDefaultStadium(name: string): Promise<void>;
+    setCustomStadium(source: string): void;
+    private changeStadium;
+    getScores(): HostScores | null;
+    getBallPosition(): {
+        x: number;
+        y: number;
+    } | null;
+    private readDisc;
+    get CollisionFlags(): Readonly<Record<string, number>>;
+    getDiscCount(): number;
+    getDiscProperties(discIndex: number): HostDiscProperties | null;
+    setDiscProperties(discIndex: number, properties: DiscPropertyPatch): void;
+    setPlayerDiscProperties(playerId: number, properties: DiscPropertyPatch): void;
+    private changeDisc;
+    getPlayerDiscProperties(playerId: number): HostDiscProperties | null;
+    getState(): MatchState;
+    startRecording(): void;
+    private finishRecording;
+    stopRecording(): Blob | null;
+    close(): void;
+}

package/dist/types/client/host-config.d.ts

@@ -0,0 +1,11 @@
+export interface HostConfig {
+    noPlayer?: boolean;
+    playerName?: string;
+    roomName: string;
+    maxPlayers?: number;
+    password?: string;
+    public?: boolean;
+    stadium?: string;
+}
+/** Validate before allocating an engine or making an admission request. */
+export declare function hostConfig(input: unknown): HostConfig;

package/dist/types/client/host-runtime.d.ts

@@ -0,0 +1,10 @@
+import { Engine } from '../core/engine.js';
+import { type NetworkRuntime } from './network-runtime.js';
+/** Internal boundary shared by the browser host and future native SDK adapter. */
+export interface HostRuntime {
+    readonly network: NetworkRuntime;
+    readonly request: (url: URL, init?: RequestInit) => Promise<Response>;
+    readonly loadEngine: (signal: AbortSignal) => Promise<Engine>;
+    readonly loadStadium: (name: string) => Promise<string>;
+}
+export declare function browserHostRuntime(): HostRuntime;

package/dist/types/client/network-runtime.d.ts

@@ -0,0 +1,8 @@
+/** Internal transport boundary. Adapters must preserve browser channel/recovery semantics. */
+export interface NetworkRuntime {
+    readonly serviceOrigin: string;
+    readonly createWebSocket: (url: URL) => WebSocket;
+    readonly createPeerConnection: (config: RTCConfiguration) => RTCPeerConnection;
+}
+export declare function serviceOrigin(value: string): string;
+export declare function browserNetworkRuntime(): NetworkRuntime;

package/dist/types/client/network.d.ts

@@ -0,0 +1,91 @@
+import { type NetworkRuntime } from './network-runtime.js';
+/** The service may have committed the operation before confirmation was lost. */
+export declare class UnconfirmedBanError extends Error {
+}
+export interface Peer {
+    id: string;
+    pc: RTCPeerConnection;
+    control?: RTCDataChannel;
+    fast?: RTCDataChannel;
+    connected: boolean;
+    rtt?: number | null;
+    admissionTimer?: ReturnType<typeof setTimeout>;
+    created: number;
+    candidates: RTCIceCandidateInit[];
+    lostAt?: number;
+    lastRestart: number;
+    restarts: number;
+    restarting: boolean;
+}
+export interface Hooks {
+    verify?: (challenge: {
+        siteKey: string;
+        roomId: string;
+    }, signal: AbortSignal) => Promise<string>;
+    allowStadiumUpload?: (peer: Peer) => boolean;
+    ready: (id: string, host: boolean) => void;
+    open: (peer: Peer) => void;
+    control: (peer: Peer, msg: unknown) => void;
+    fast: (peer: Peer, data: ArrayBuffer) => void;
+    leave: (id: string) => void;
+    status: (text: string) => void;
+    ended?: (reason: string) => void;
+}
+export declare class Network {
+    private room;
+    private credentials;
+    private hooks;
+    private readonly runtime;
+    ws: WebSocket;
+    peers: Map<string, Peer>;
+    id: string;
+    host: boolean;
+    hostId: string;
+    closed: boolean;
+    timer: ReturnType<typeof setInterval>;
+    bytesSent: number;
+    bytesReceived: number;
+    private pollingStats;
+    private verificationState;
+    get requireVerification(): boolean | null;
+    private verificationSequence;
+    private verificationRequest?;
+    private challenge?;
+    private rejectVerification;
+    setRequireVerification(required: boolean): Promise<boolean>;
+    private passwordRequestId;
+    private passwordRequest?;
+    private rejectPasswordUpdate;
+    setPassword(password: string | null): Promise<boolean>;
+    private banSequence;
+    private banRequest?;
+    private rejectBan;
+    updateBan(type: 'ban' | 'clearBan' | 'clearBans', target?: string): Promise<void>;
+    get rtt(): number | null;
+    private signalQueue;
+    private lastHeartbeat;
+    private controlId;
+    private controlAssemblers;
+    constructor(room: string, credentials: {
+        hostToken?: string;
+        password?: string;
+    }, hooks: Hooks, runtime?: NetworkRuntime);
+    signal(m: unknown): void;
+    private message;
+    private current;
+    private queueCandidate;
+    private noteHealthy;
+    private flushCandidates;
+    /** Host-only ICE repair; preserves channels, player identity and simulation state. */
+    restartPeer(id: string): Promise<boolean>;
+    private make;
+    private bind;
+    /** Called by the host only after validating and allocating a player slot. */
+    admit(p: Peer): void;
+    control(p: Peer, m: unknown): void;
+    fast(p: Peer, data: ArrayBuffer): void;
+    broadcast(m: unknown): void;
+    stats(): Promise<void>;
+    remove(id: string): void;
+    close(): void;
+}

package/dist/types/client/stadium-library.d.ts

@@ -0,0 +1,4 @@
+export declare const defaultStadiums: readonly [readonly ['classic', 'Classic'], readonly ['easy', 'Easy'], readonly ['small', 'Small'], readonly ['big', 'Big'], readonly ['rounded', 'Rounded'], readonly ['hockey', 'Hockey'], readonly ['big_easy', 'Big Easy'], readonly ['big_rounded', 'Big Rounded'], readonly ['big_hockey', 'Big Hockey'], readonly ['huge', 'Huge']];
+/** Each loader owns its cache; origins and runtime lifetimes cannot share entries. */
+export declare function createStadiumLoader(load: (path: string) => Promise<Response>): (name: string) => Promise<string>;
+export declare const loadDefaultStadium: (name: string) => Promise<string>;

package/dist/types/client/startup-scope.d.ts

@@ -0,0 +1,6 @@
+/** One cancellable deadline for assets, HTTP admission and signaling readiness. */
+export declare function startupScope(external?: AbortSignal): {
+    signal: AbortSignal;
+    run<T>(work: Promise<T>): Promise<T>;
+    dispose(): void;
+};

package/dist/types/client/traffic.d.ts

@@ -0,0 +1,9 @@
+type Budget = 'message' | 'action' | 'chat';
+/** Separate action budgets bound broadcast amplification during normal gameplay traffic. */
+export declare class PeerTraffic {
+    private peers;
+    allow(id: string, kind: Budget, now?: number): boolean;
+    delete(id: string): void;
+    clear(): void;
+}
+export {};

package/dist/types/core/avatar.d.ts

@@ -0,0 +1,2 @@
+/** Bound avatar labels before they enter rosters or canvas text rendering. */
+export declare function validAvatar(value: unknown): value is string | null;

package/dist/types/core/build-id.d.ts

@@ -0,0 +1,2 @@
+export declare const ENGINE_BUILD = "3de72bdcf92ccb0d235a";
+export declare const ENGINE_WASM_HASH = "18e0600cd78f6896249e672d14fefbc34e88826b1febf0b794dc5367f176e338";

package/dist/types/core/control.d.ts

@@ -0,0 +1,5 @@
+export declare function controlPackets(message: unknown, id: number): (string | ArrayBuffer)[];
+export declare class ControlAssembler {
+    private partial?;
+    push(data: string | ArrayBuffer, now?: number): unknown | undefined;
+}

package/dist/types/core/disc-properties.d.ts

@@ -0,0 +1,7 @@
+/** Runtime disc fields in reference action order; -1 denotes the color array. */
+export declare const DISC_PROPERTY_FIELDS: readonly [readonly ['x', 0, -8192, 8192], readonly ['y', 1, -8192, 8192], readonly ['xspeed', 2, -8192, 8192], readonly ['yspeed', 3, -8192, 8192], readonly ['xgravity', 8, -8192, 8192], readonly ['ygravity', 9, -8192, 8192], readonly ['radius', 4, 0.5, 100], readonly ['bCoeff', 7, -1, 8192], readonly ['invMass', 5, 0, 8192], readonly ['damping', 6, 0, 8192], readonly ['color', -1, -1, 16777215], readonly ['cMask', 11, -2147483648, 2147483647], readonly ['cGroup', 10, -2147483648, 2147483647]];
+export type DiscProperty = (typeof DISC_PROPERTY_FIELDS)[number][0];
+export type DiscProperties = Record<DiscProperty, number>;
+export type DiscPropertyPatch = Partial<Record<DiscProperty, number | null>>;
+/** Validate the entire update before any engine field can be changed. */
+export declare function normalizeDiscProperties(properties: unknown): Partial<DiscProperties>;