onelobby 0.0.0-stage → 0.2.0

package/dist/ui/controller.d.ts

@@ -0,0 +1,137 @@
+import type { Lobby } from "../lobby.js";
+import type { HostOptions } from "../onelobby.js";
+import { type FriendlyError } from "../friendly.js";
+export type UiState = "idle" | "connecting" | "lobby" | "playing" | "error";
+export interface Player {
+    id: number;
+    name: string;
+    isHost: boolean;
+    isMe: boolean;
+}
+/** What the controller needs from `OneLobby` (so tests can pass the in-memory rig). */
+export interface KitLike {
+    host(h: HostOptions): Promise<Lobby>;
+    join(code: string): Promise<Lobby>;
+    /** Take back the seat this tab held before a reload (OneLobby `rememberSeat`); null when there is none. */
+    resume?(): Promise<Lobby | null>;
+    readonly rememberedCode?: string | null;
+}
+export interface ControllerEvents {
+    message: {
+        from: Player | null;
+        data: unknown;
+    };
+    "player-joined": {
+        player: Player;
+    };
+    "player-left": {
+        player: Player;
+        reason: string;
+    };
+    start: Record<string, never>;
+    error: FriendlyError;
+    "shared-change": {
+        key: string;
+        value: unknown;
+        from: Player | null;
+    };
+}
+export interface ControllerOptions {
+    makeKit: (name: string) => KitLike;
+    /** A number, or a function read each time a game is hosted. */
+    maxPlayers: number | (() => number);
+    /** Lobby name shown to the server (not to players). */
+    lobbyName?: string;
+}
+/** Wire envelope inside raw frames. Kept tiny and versioned by key names only. */
+type Wire = {
+    k: "m";
+    d: unknown;
+} | {
+    k: "set";
+    key: string;
+    v: unknown;
+} | {
+    k: "add";
+    key: string;
+    n: number;
+} | {
+    k: "S";
+    key: string;
+    v: unknown;
+    by: number;
+    q: number;
+} | {
+    k: "SS";
+    all: Record<string, unknown>;
+    q: number;
+};
+export declare class SharedState {
+    private c;
+    /** @internal */ values: Map<string, unknown>;
+    constructor(c: LobbyController);
+    get(key: string): unknown;
+    /** Set a value for everyone. The host decides the order; everyone gets `shared-change`. */
+    set(key: string, value: unknown): void;
+    /** Add `n` (default 1) to a number, safely even when several players click at once. */
+    add(key: string, n?: number): void;
+    /** A plain copy of every value. */
+    all(): Record<string, unknown>;
+    keys(): string[];
+}
+export declare class LobbyController {
+    private opts;
+    state: UiState;
+    lobby: Lobby | null;
+    error: FriendlyError | null;
+    /** True while a joiner waits for its direct link to the host. */
+    linking: boolean;
+    name: string;
+    readonly shared: SharedState;
+    onChange: () => void;
+    onEvent: <K extends keyof ControllerEvents>(type: K, detail: ControllerEvents[K]) => void;
+    private lastAction;
+    private unsub;
+    private gen;
+    /** Host: changes made so far. Joiner: the newest change applied (older queued ones are skipped). */
+    private seq;
+    constructor(opts: ControllerOptions);
+    get isHost(): boolean;
+    get code(): string | null;
+    get players(): Player[];
+    /** One line of plain language for the status area. */
+    get statusText(): string;
+    private get hostName();
+    private toPlayer;
+    host(name: string): Promise<void>;
+    join(code: string, name: string): Promise<void>;
+    /**
+     * Take back this tab's seat after a page reload, if the kit remembers one (host or joiner). Quietly stays on the
+     * start screen when there is nothing to resume or the seat is gone. Resolves true when back in a game.
+     */
+    resume(name: string): Promise<boolean>;
+    /** Repeat whatever failed last (host or join). */
+    retry(): Promise<void>;
+    start(): Promise<void>;
+    leave(): Promise<void>;
+    /** Back to the start screen (after an error, or to cancel). */
+    reset(): void;
+    /** Send any JSON-able value to everyone else. */
+    send(data: unknown): void;
+    private run;
+    private attach;
+    private linked;
+    private detach;
+    private fail;
+    private playerById;
+    private onRaw;
+    /** @internal from SharedState */
+    _sharedOp(op: Extract<Wire, {
+        k: "set";
+    } | {
+        k: "add";
+    }>): void;
+    private applyHost;
+    private applyValue;
+}
+export {};

package/dist/ui/controller.js

@@ -0,0 +1,337 @@
+/**
+ * The DOM-free brain of `<one-lobby>`: a small state machine over OneLobby + Lobby (raw mode) that the element
+ * renders, plus the JSON message envelope and the host-authoritative shared state. Unit-tested without a browser.
+ */
+import { OneLobbyError } from "../signaling.js";
+import { describeError } from "../friendly.js";
+import { normalizeCode } from "../crockford.js";
+const enc = new TextEncoder();
+const dec = new TextDecoder();
+const toBytes = (w) => enc.encode(JSON.stringify(w));
+export class SharedState {
+    c;
+    /** @internal */ values = new Map();
+    constructor(c) {
+        this.c = c;
+    }
+    get(key) {
+        return this.values.get(key);
+    }
+    /** Set a value for everyone. The host decides the order; everyone gets `shared-change`. */
+    set(key, value) {
+        this.c._sharedOp({ k: "set", key: String(key), v: value === undefined ? null : value });
+    }
+    /** Add `n` (default 1) to a number, safely even when several players click at once. */
+    add(key, n = 1) {
+        this.c._sharedOp({ k: "add", key: String(key), n: Number(n) || 0 });
+    }
+    /** A plain copy of every value. */
+    all() {
+        return Object.fromEntries(this.values);
+    }
+    keys() {
+        return [...this.values.keys()];
+    }
+}
+export class LobbyController {
+    opts;
+    state = "idle";
+    lobby = null;
+    error = null;
+    /** True while a joiner waits for its direct link to the host. */
+    linking = false;
+    name = "";
+    shared = new SharedState(this);
+    onChange = () => { };
+    onEvent = () => { };
+    lastAction = null;
+    unsub = [];
+    gen = 0;
+    /** Host: changes made so far. Joiner: the newest change applied (older queued ones are skipped). */
+    seq = 0;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    get isHost() {
+        return !!this.lobby && this.lobby.isHost;
+    }
+    get code() {
+        return this.lobby?.code ?? null;
+    }
+    get players() {
+        const l = this.lobby;
+        if (!l)
+            return [];
+        const list = l.peers.map((p) => this.toPlayer(p));
+        if (!list.some((p) => p.isMe))
+            list.push({ id: l.localPeerId, name: this.name || `Player ${l.localPeerId}`, isHost: l.isHost, isMe: true });
+        return list.sort((a, b) => a.id - b.id);
+    }
+    /** One line of plain language for the status area. */
+    get statusText() {
+        switch (this.state) {
+            case "idle":
+                return "Host a game, or type a code to join one.";
+            case "connecting":
+                return this.lastAction?.kind === "join" ? "Joining…" : this.lastAction?.kind === "resume" ? "Getting your seat back…" : "Creating a game…";
+            case "error":
+                return this.error?.message ?? "Something went wrong.";
+            case "lobby": {
+                if (this.linking)
+                    return `Connecting to ${this.hostName}…`;
+                if (this.isHost) {
+                    const n = this.players.length;
+                    return n <= 1 ? "Waiting for players… Share the code with your friends." : `${n} players here. Press Start when everyone's in.`;
+                }
+                return `Connected! Waiting for ${this.hostName} to start.`;
+            }
+            case "playing":
+                return this.linking ? `Connecting to ${this.hostName}…` : "Game on!";
+        }
+    }
+    get hostName() {
+        const l = this.lobby;
+        if (!l)
+            return "the host";
+        return l.peer(l.hostPeerId)?.name || "the host";
+    }
+    toPlayer(p, id) {
+        const l = this.lobby;
+        const pid = p?.peerId ?? id ?? 0;
+        return { id: pid, name: p?.name || (pid === l.localPeerId && this.name) || `Player ${pid}`, isHost: pid === l.hostPeerId, isMe: pid === l.localPeerId };
+    }
+    // ---- actions -----------------------------------------------------------------------------------------------------
+    host(name) {
+        this.lastAction = { kind: "host" };
+        return this.run(name, (kit) => kit.host({ name: this.opts.lobbyName ?? "game", maxPlayers: typeof this.opts.maxPlayers === "function" ? this.opts.maxPlayers() : this.opts.maxPlayers, visibility: "unlisted", lateJoin: true }));
+    }
+    join(code, name) {
+        const norm = normalizeCode(code);
+        this.lastAction = { kind: "join", code };
+        if (!norm) {
+            this.fail(new OneLobbyError("bad_code"));
+            return Promise.resolve();
+        }
+        return this.run(name, (kit) => kit.join(norm));
+    }
+    /**
+     * Take back this tab's seat after a page reload, if the kit remembers one (host or joiner). Quietly stays on the
+     * start screen when there is nothing to resume or the seat is gone. Resolves true when back in a game.
+     */
+    async resume(name) {
+        const kit = this.opts.makeKit(name);
+        if (!kit.resume || !kit.rememberedCode)
+            return false;
+        this.lastAction = { kind: "resume" };
+        await this.run(name, () => kit.resume(), true);
+        return !!this.lobby;
+    }
+    /** Repeat whatever failed last (host or join). */
+    retry() {
+        const a = this.lastAction;
+        if (!a || a.kind === "resume") {
+            this.reset();
+            return Promise.resolve();
+        }
+        return a.kind === "host" ? this.host(this.name) : this.join(a.code, this.name);
+    }
+    async start() {
+        if (!this.lobby || !this.isHost || this.state === "playing")
+            return;
+        await this.lobby.start();
+    }
+    async leave() {
+        const l = this.lobby;
+        this.detach();
+        await l?.leave();
+        this.reset();
+    }
+    /** Back to the start screen (after an error, or to cancel). */
+    reset() {
+        this.detach();
+        this.state = "idle";
+        this.error = null;
+        this.onChange();
+    }
+    /** Send any JSON-able value to everyone else. */
+    send(data) {
+        if (!this.lobby)
+            return;
+        this.lobby.broadcast(toBytes({ k: "m", d: data === undefined ? null : data }));
+    }
+    // ---- internals ---------------------------------------------------------------------------------------------------
+    async run(name, go, quiet = false) {
+        this.detach();
+        const gen = ++this.gen;
+        this.name = (name || "").trim().slice(0, 24); // empty: other players see "Player N"
+        this.state = "connecting";
+        this.error = null;
+        this.onChange();
+        let lobby;
+        try {
+            lobby = await go(this.opts.makeKit(this.name));
+        }
+        catch (e) {
+            if (gen !== this.gen)
+                return;
+            if (quiet)
+                this.reset();
+            else
+                this.fail(e);
+            return;
+        }
+        if (gen !== this.gen) {
+            void lobby?.leave();
+            return;
+        }
+        if (lobby)
+            this.attach(lobby);
+        else
+            this.reset();
+    }
+    attach(l) {
+        this.lobby = l;
+        // A joiner takes the host's values; a host keeps anything the page set up front (defaults).
+        if (!l.isHost)
+            this.shared.values.clear();
+        this.seq = 0;
+        this.state = l.phase === "in_game" ? "playing" : "lobby";
+        this.linking = !l.isHost;
+        const on = this.unsub;
+        on.push(l.on("ready", () => this.linked()));
+        on.push(l.on("peerJoined", (p) => {
+            this.onEvent("player-joined", { player: this.toPlayer(p) });
+            this.onChange();
+        }));
+        on.push(l.on("peerLeft", (p, reason) => {
+            this.onEvent("player-left", { player: this.toPlayer(p), reason });
+            this.onChange();
+        }));
+        on.push(l.on("peerReady", (p) => {
+            if (l.isHost && p.peerId !== l.localPeerId)
+                l.send(p.peerId, toBytes({ k: "SS", all: this.shared.all(), q: this.seq }));
+        }));
+        on.push(l.on("hostChanged", () => this.onChange()));
+        on.push(l.on("phase", (ph) => {
+            if (ph === "in_game" && this.state !== "playing") {
+                this.state = "playing";
+                this.onChange();
+                this.onEvent("start", {});
+            }
+        }));
+        on.push(l.on("message", (from, bytes) => this.onRaw(from, bytes)));
+        on.push(l.on("sessionEnded", (reason) => {
+            if (this.lobby !== l)
+                return;
+            if (reason === "left")
+                return;
+            this.fail(new OneLobbyError(reason));
+        }));
+        // A joiner that cannot reach the host: the kit gives up after its readyTimeoutMs, leaves, and ends the session
+        // with "ice_failed", which lands in the sessionEnded handler above.
+        l.ready.then(() => { if (this.lobby === l)
+            this.linked(); }, () => { });
+        this.onChange();
+        if (this.state === "playing" && !this.linking)
+            this.onEvent("start", {});
+    }
+    linked() {
+        if (!this.linking)
+            return;
+        this.linking = false;
+        this.onChange();
+        if (this.state === "playing")
+            this.onEvent("start", {});
+    }
+    detach() {
+        this.gen++;
+        for (const u of this.unsub.splice(0))
+            u();
+        this.lobby = null;
+        this.linking = false;
+    }
+    fail(e) {
+        const l = this.lobby;
+        this.detach();
+        if (l)
+            void l.leave();
+        this.state = "error";
+        this.error = describeError(e);
+        this.onChange();
+        this.onEvent("error", this.error);
+    }
+    playerById(id) {
+        const l = this.lobby;
+        if (!l || !id)
+            return null;
+        return this.toPlayer(l.peer(id), id);
+    }
+    onRaw(from, bytes) {
+        let w;
+        try {
+            w = JSON.parse(dec.decode(bytes));
+        }
+        catch {
+            return; // not ours
+        }
+        if (!w || typeof w !== "object")
+            return;
+        const l = this.lobby;
+        switch (w.k) {
+            case "m":
+                this.onEvent("message", { from: this.playerById(from), data: w.d });
+                break;
+            case "set":
+            case "add":
+                if (l.isHost)
+                    this.applyHost(w, from);
+                break;
+            case "S":
+                if (!l.isHost && from === l.hostPeerId && !(w.q <= this.seq)) {
+                    this.seq = w.q;
+                    this.applyValue(w.key, w.v, w.by);
+                }
+                break;
+            case "SS":
+                if (!l.isHost && from === l.hostPeerId && w.all && typeof w.all === "object" && !(w.q < this.seq)) {
+                    this.seq = w.q;
+                    for (const k of [...this.shared.values.keys()])
+                        if (!(k in w.all))
+                            this.applyValue(k, null, 0);
+                    for (const [k, v] of Object.entries(w.all))
+                        this.applyValue(k, v, 0);
+                }
+                break;
+        }
+    }
+    /** @internal from SharedState */
+    _sharedOp(op) {
+        const l = this.lobby;
+        if (!l) {
+            // Not in a game yet: keep it local, so a page can set defaults up front.
+            const v = op.k === "set" ? op.v : (Number(this.shared.values.get(op.key)) || 0) + op.n;
+            this.applyValue(op.key, v, 0);
+            return;
+        }
+        if (l.isHost)
+            this.applyHost(op, l.localPeerId);
+        else
+            l.send(l.hostPeerId, toBytes(op));
+    }
+    applyHost(op, by) {
+        const l = this.lobby;
+        if (typeof op.key !== "string")
+            return;
+        const v = op.k === "set" ? op.v : (Number(this.shared.values.get(op.key)) || 0) + (Number(op.n) || 0);
+        this.applyValue(op.key, v, by);
+        l.broadcast(toBytes({ k: "S", key: op.key, v, by, q: ++this.seq }));
+    }
+    applyValue(key, v, by) {
+        if (v === null)
+            this.shared.values.delete(key);
+        else
+            this.shared.values.set(key, v);
+        this.onEvent("shared-change", { key, value: v, from: this.playerById(by) });
+    }
+}
+//# sourceMappingURL=controller.js.map

package/dist/ui/controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.js","sourceRoot":"","sources":["../../src/ui/controller.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The DOM-free brain of `<one-lobby>`: a small state machine over OneLobby + Lobby (raw mode) that the element\n * renders, plus the JSON message envelope and the host-authoritative shared state. Unit-tested without a browser.\n */\nimport { OneLobbyError } from \"../signaling.js\";\nimport type { Lobby, Peer } from \"../lobby.js\";\nimport type { HostOptions } from \"../onelobby.js\";\nimport { describeError, type FriendlyError } from \"../friendly.js\";\nimport { normalizeCode } from \"../crockford.js\";\n\nexport type UiState = \"idle\" | \"connecting\" | \"lobby\" | \"playing\" | \"error\";\n\nexport interface Player {\n  id: number;\n  name: string;\n  isHost: boolean;\n  isMe: boolean;\n}\n\n/** What the controller needs from `OneLobby` (so tests can pass the in-memory rig). */\nexport interface KitLike {\n  host(h: HostOptions): Promise<Lobby>;\n  join(code: string): Promise<Lobby>;\n  /** Take back the seat this tab held before a reload (OneLobby `rememberSeat`); null when there is none. */\n  resume?(): Promise<Lobby | null>;\n  readonly rememberedCode?: string | null;\n}\n\nexport interface ControllerEvents {\n  message: { from: Player | null; data: unknown };\n  \"player-joined\": { player: Player };\n  \"player-left\": { player: Player; reason: string };\n  start: Record<string, never>;\n  error: FriendlyError;\n  \"shared-change\": { key: string; value: unknown; from: Player | null };\n}\n\nexport interface ControllerOptions {\n  makeKit: (name: string) => KitLike;\n  /** A number, or a function read each time a game is hosted. */\n  maxPlayers: number | (() => number);\n  /** Lobby name shown to the server (not to players). */\n  lobbyName?: string;\n}\n\n/** Wire envelope inside raw frames. Kept tiny and versioned by key names only. */\ntype Wire =\n  | { k: \"m\"; d: unknown } // game message\n  | { k: \"set\"; key: string; v: unknown } // joiner -> host: please set\n  | { k: \"add\"; key: string; n: number } // joiner -> host: please add\n  | { k: \"S\"; key: string; v: unknown; by: number; q: number } // host -> all: value changed (q = host change counter)\n  | { k: \"SS\"; all: Record<string, unknown>; q: number }; // host -> one: full state as of change q\n\nconst enc = new TextEncoder();\nconst dec = new TextDecoder();\nconst toBytes = (w: Wire) => enc.encode(JSON.stringify(w));\n\nexport class SharedState {\n  /** @internal */ values = new Map<string, unknown>();\n  constructor(private c: LobbyController) {}\n  get(key: string): unknown {\n    return this.values.get(key);\n  }\n  /** Set a value for everyone. The host decides the order; everyone gets `shared-change`. */\n  set(key: string, value: unknown): void {\n    this.c._sharedOp({ k: \"set\", key: String(key), v: value === undefined ? null : value });\n  }\n  /** Add `n` (default 1) to a number, safely even when several players click at once. */\n  add(key: string, n = 1): void {\n    this.c._sharedOp({ k: \"add\", key: String(key), n: Number(n) || 0 });\n  }\n  /** A plain copy of every value. */\n  all(): Record<string, unknown> {\n    return Object.fromEntries(this.values);\n  }\n  keys(): string[] {\n    return [...this.values.keys()];\n  }\n}\n\nexport class LobbyController {\n  state: UiState = \"idle\";\n  lobby: Lobby | null = null;\n  error: FriendlyError | null = null;\n  /** True while a joiner waits for its direct link to the host. */\n  linking = false;\n  name = \"\";\n  readonly shared = new SharedState(this);\n\n  onChange: () => void = () => {};\n  onEvent: <K extends keyof ControllerEvents>(type: K, detail: ControllerEvents[K]) => void = () => {};\n\n  private lastAction: { kind: \"host\" } | { kind: \"join\"; code: string } | { kind: \"resume\" } | null = null;\n  private unsub: Array<() => void> = [];\n  private gen = 0;\n  /** Host: changes made so far. Joiner: the newest change applied (older queued ones are skipped). */\n  private seq = 0;\n\n  constructor(private opts: ControllerOptions) {}\n\n  get isHost(): boolean {\n    return !!this.lobby && this.lobby.isHost;\n  }\n  get code(): string | null {\n    return this.lobby?.code ?? null;\n  }\n  get players(): Player[] {\n    const l = this.lobby;\n    if (!l) return [];\n    const list = l.peers.map((p) => this.toPlayer(p));\n    if (!list.some((p) => p.isMe)) list.push({ id: l.localPeerId, name: this.name || `Player ${l.localPeerId}`, isHost: l.isHost, isMe: true });\n    return list.sort((a, b) => a.id - b.id);\n  }\n\n  /** One line of plain language for the status area. */\n  get statusText(): string {\n    switch (this.state) {\n      case \"idle\":\n        return \"Host a game, or type a code to join one.\";\n      case \"connecting\":\n        return this.lastAction?.kind === \"join\" ? \"Joining…\" : this.lastAction?.kind === \"resume\" ? \"Getting your seat back…\" : \"Creating a game…\";\n      case \"error\":\n        return this.error?.message ?? \"Something went wrong.\";\n      case \"lobby\": {\n        if (this.linking) return `Connecting to ${this.hostName}…`;\n        if (this.isHost) {\n          const n = this.players.length;\n          return n <= 1 ? \"Waiting for players… Share the code with your friends.\" : `${n} players here. Press Start when everyone's in.`;\n        }\n        return `Connected! Waiting for ${this.hostName} to start.`;\n      }\n      case \"playing\":\n        return this.linking ? `Connecting to ${this.hostName}…` : \"Game on!\";\n    }\n  }\n\n  private get hostName(): string {\n    const l = this.lobby;\n    if (!l) return \"the host\";\n    return l.peer(l.hostPeerId)?.name || \"the host\";\n  }\n\n  private toPlayer(p: Peer | undefined, id?: number): Player {\n    const l = this.lobby!;\n    const pid = p?.peerId ?? id ?? 0;\n    return { id: pid, name: p?.name || (pid === l.localPeerId && this.name) || `Player ${pid}`, isHost: pid === l.hostPeerId, isMe: pid === l.localPeerId };\n  }\n\n  // ---- actions -----------------------------------------------------------------------------------------------------\n\n  host(name: string): Promise<void> {\n    this.lastAction = { kind: \"host\" };\n    return this.run(name, (kit) => kit.host({ name: this.opts.lobbyName ?? \"game\", maxPlayers: typeof this.opts.maxPlayers === \"function\" ? this.opts.maxPlayers() : this.opts.maxPlayers, visibility: \"unlisted\", lateJoin: true }));\n  }\n\n  join(code: string, name: string): Promise<void> {\n    const norm = normalizeCode(code);\n    this.lastAction = { kind: \"join\", code };\n    if (!norm) {\n      this.fail(new OneLobbyError(\"bad_code\"));\n      return Promise.resolve();\n    }\n    return this.run(name, (kit) => kit.join(norm));\n  }\n\n  /**\n   * Take back this tab's seat after a page reload, if the kit remembers one (host or joiner). Quietly stays on the\n   * start screen when there is nothing to resume or the seat is gone. Resolves true when back in a game.\n   */\n  async resume(name: string): Promise<boolean> {\n    const kit = this.opts.makeKit(name);\n    if (!kit.resume || !kit.rememberedCode) return false;\n    this.lastAction = { kind: \"resume\" };\n    await this.run(name, () => kit.resume!(), true);\n    return !!this.lobby;\n  }\n\n  /** Repeat whatever failed last (host or join). */\n  retry(): Promise<void> {\n    const a = this.lastAction;\n    if (!a || a.kind === \"resume\") {\n      this.reset();\n      return Promise.resolve();\n    }\n    return a.kind === \"host\" ? this.host(this.name) : this.join(a.code, this.name);\n  }\n\n  async start(): Promise<void> {\n    if (!this.lobby || !this.isHost || this.state === \"playing\") return;\n    await this.lobby.start();\n  }\n\n  async leave(): Promise<void> {\n    const l = this.lobby;\n    this.detach();\n    await l?.leave();\n    this.reset();\n  }\n\n  /** Back to the start screen (after an error, or to cancel). */\n  reset(): void {\n    this.detach();\n    this.state = \"idle\";\n    this.error = null;\n    this.onChange();\n  }\n\n  /** Send any JSON-able value to everyone else. */\n  send(data: unknown): void {\n    if (!this.lobby) return;\n    this.lobby.broadcast(toBytes({ k: \"m\", d: data === undefined ? null : data }));\n  }\n\n  // ---- internals ---------------------------------------------------------------------------------------------------\n\n  private async run(name: string, go: (kit: KitLike) => Promise<Lobby | null>, quiet = false): Promise<void> {\n    this.detach();\n    const gen = ++this.gen;\n    this.name = (name || \"\").trim().slice(0, 24); // empty: other players see \"Player N\"\n    this.state = \"connecting\";\n    this.error = null;\n    this.onChange();\n    let lobby: Lobby | null;\n    try {\n      lobby = await go(this.opts.makeKit(this.name));\n    } catch (e) {\n      if (gen !== this.gen) return;\n      if (quiet) this.reset();\n      else this.fail(e);\n      return;\n    }\n    if (gen !== this.gen) {\n      void lobby?.leave();\n      return;\n    }\n    if (lobby) this.attach(lobby);\n    else this.reset();\n  }\n\n  private attach(l: Lobby): void {\n    this.lobby = l;\n    // A joiner takes the host's values; a host keeps anything the page set up front (defaults).\n    if (!l.isHost) this.shared.values.clear();\n    this.seq = 0;\n    this.state = l.phase === \"in_game\" ? \"playing\" : \"lobby\";\n    this.linking = !l.isHost;\n    const on = this.unsub;\n    on.push(l.on(\"ready\", () => this.linked()));\n    on.push(l.on(\"peerJoined\", (p) => {\n      this.onEvent(\"player-joined\", { player: this.toPlayer(p) });\n      this.onChange();\n    }));\n    on.push(l.on(\"peerLeft\", (p, reason) => {\n      this.onEvent(\"player-left\", { player: this.toPlayer(p), reason });\n      this.onChange();\n    }));\n    on.push(l.on(\"peerReady\", (p) => {\n      if (l.isHost && p.peerId !== l.localPeerId) l.send(p.peerId, toBytes({ k: \"SS\", all: this.shared.all(), q: this.seq }));\n    }));\n    on.push(l.on(\"hostChanged\", () => this.onChange()));\n    on.push(l.on(\"phase\", (ph) => {\n      if (ph === \"in_game\" && this.state !== \"playing\") {\n        this.state = \"playing\";\n        this.onChange();\n        this.onEvent(\"start\", {});\n      }\n    }));\n    on.push(l.on(\"message\", (from, bytes) => this.onRaw(from, bytes)));\n    on.push(l.on(\"sessionEnded\", (reason) => {\n      if (this.lobby !== l) return;\n      if (reason === \"left\") return;\n      this.fail(new OneLobbyError(reason));\n    }));\n    // A joiner that cannot reach the host: the kit gives up after its readyTimeoutMs, leaves, and ends the session\n    // with \"ice_failed\", which lands in the sessionEnded handler above.\n    l.ready.then(() => { if (this.lobby === l) this.linked(); }, () => {});\n    this.onChange();\n    if (this.state === \"playing\" && !this.linking) this.onEvent(\"start\", {});\n  }\n\n  private linked(): void {\n    if (!this.linking) return;\n    this.linking = false;\n    this.onChange();\n    if (this.state === \"playing\") this.onEvent(\"start\", {});\n  }\n\n  private detach(): void {\n    this.gen++;\n    for (const u of this.unsub.splice(0)) u();\n    this.lobby = null;\n    this.linking = false;\n  }\n\n  private fail(e: unknown): void {\n    const l = this.lobby;\n    this.detach();\n    if (l) void l.leave();\n    this.state = \"error\";\n    this.error = describeError(e);\n    this.onChange();\n    this.onEvent(\"error\", this.error);\n  }\n\n  private playerById(id: number): Player | null {\n    const l = this.lobby;\n    if (!l || !id) return null;\n    return this.toPlayer(l.peer(id), id);\n  }\n\n  private onRaw(from: number, bytes: Uint8Array): void {\n    let w: Wire;\n    try {\n      w = JSON.parse(dec.decode(bytes)) as Wire;\n    } catch {\n      return; // not ours\n    }\n    if (!w || typeof w !== \"object\") return;\n    const l = this.lobby!;\n    switch (w.k) {\n      case \"m\":\n        this.onEvent(\"message\", { from: this.playerById(from), data: w.d });\n        break;\n      case \"set\":\n      case \"add\":\n        if (l.isHost) this.applyHost(w, from);\n        break;\n      case \"S\":\n        if (!l.isHost && from === l.hostPeerId && !(w.q <= this.seq)) {\n          this.seq = w.q;\n          this.applyValue(w.key, w.v, w.by);\n        }\n        break;\n      case \"SS\":\n        if (!l.isHost && from === l.hostPeerId && w.all && typeof w.all === \"object\" && !(w.q < this.seq)) {\n          this.seq = w.q;\n          for (const k of [...this.shared.values.keys()]) if (!(k in w.all)) this.applyValue(k, null, 0);\n          for (const [k, v] of Object.entries(w.all)) this.applyValue(k, v, 0);\n        }\n        break;\n    }\n  }\n\n  /** @internal from SharedState */\n  _sharedOp(op: Extract<Wire, { k: \"set\" } | { k: \"add\" }>): void {\n    const l = this.lobby;\n    if (!l) {\n      // Not in a game yet: keep it local, so a page can set defaults up front.\n      const v = op.k === \"set\" ? op.v : (Number(this.shared.values.get(op.key)) || 0) + op.n;\n      this.applyValue(op.key, v, 0);\n      return;\n    }\n    if (l.isHost) this.applyHost(op, l.localPeerId);\n    else l.send(l.hostPeerId, toBytes(op));\n  }\n\n  private applyHost(op: Extract<Wire, { k: \"set\" } | { k: \"add\" }>, by: number): void {\n    const l = this.lobby!;\n    if (typeof op.key !== \"string\") return;\n    const v = op.k === \"set\" ? op.v : (Number(this.shared.values.get(op.key)) || 0) + (Number(op.n) || 0);\n    this.applyValue(op.key, v, by);\n    l.broadcast(toBytes({ k: \"S\", key: op.key, v, by, q: ++this.seq }));\n  }\n\n  private applyValue(key: string, v: unknown, by: number): void {\n    if (v === null) this.shared.values.delete(key);\n    else this.shared.values.set(key, v);\n    this.onEvent(\"shared-change\", { key, value: v, from: this.playerById(by) });\n  }\n}\n"]}

package/dist/ui/element.d.ts

@@ -0,0 +1,22 @@
+import { type Player, type SharedState, type UiState } from "./controller.js";
+export declare const LOBBY_TAG = "one-lobby";
+/** The element's public surface (for TypeScript users). */
+export interface OneLobbyElement extends HTMLElement {
+    readonly isHost: boolean;
+    readonly players: Player[];
+    readonly code: string | null;
+    readonly state: UiState;
+    readonly shared: SharedState;
+    send(data: unknown): void;
+    host(): Promise<void>;
+    join(code: string): Promise<void>;
+    start(): Promise<void>;
+    leave(): Promise<void>;
+}
+/** Register `<one-lobby>` (safe to call more than once; a no-op outside a browser). */
+export declare function defineLobbyElement(tag?: string): void;
+declare global {
+    interface HTMLElementTagNameMap {
+        "one-lobby": OneLobbyElement;
+    }
+}