@crowdedkingdoms/crowdyjs 18.11.0-dev.1 → 18.12.0-dev.1

package/dist/kit/modules/instances.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instances.d.ts","sourceRoot":"","sources":["../../../src/kit/modules/instances.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,OAAO,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;IAC7C,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,oCAAoC;AACpC,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,GAAG,SAAS,CAAC;IAC9E,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,yEAAyE;IACzE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,GAAG,EAAE,MAAM,EAAE,CAAC;CACf;AAED,+EAA+E;AAC/E,qBAAa,YAAY;IAIrB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAJ3B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAkC;gBAGpC,OAAO,EAAE,UAAU,EACnB,QAAQ,SAAa;IAGxC,qEAAqE;IACrE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW;CAQ9B;AAED;;;;GAIG;AACH,qBAAa,WAAW;IAIpB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM;IALtB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAC;gBAGtB,OAAO,EAAE,UAAU,EAC3B,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM;IAKtB,KAAK,IAAI,OAAO,CAAC,eAAe,CAAC;IAIjC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxB;;;OAGG;IACH,IAAI,CAAC,OAAO,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,aAAa,CAAC,MAAM,GAAG,MAAM,CAAC,CAAA;KAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAO9F,0EAA0E;IAC1E,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIjD,+DAA+D;IAC/D,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAIxB;;;OAGG;IACH,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;IAIxB,+HAA+H;IAC/H,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IAI1B,+CAA+C;IAC/C,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;CAG5B"}

package/dist/kit/modules/instances.js

@@ -0,0 +1,72 @@
+import { HubState } from '../mirror.js';
+/** Private runs for one party (the `instance` starter): {@link run} by key. */
+export class InstancesKit {
+    constructor(runtime, nodeType = 'instance') {
+        this.runtime = runtime;
+        this.nodeType = nodeType;
+        this.runs = new Map();
+    }
+    /** The run with key `key` (a key the game makes up, one per run). */
+    run(key) {
+        let r = this.runs.get(key);
+        if (!r) {
+            r = new InstanceRun(this.runtime, this.nodeType, key);
+            this.runs.set(key, r);
+        }
+        return r;
+    }
+}
+/**
+ * One run: a party plays down floors the hub generates from the run's seed, the hub resolves each
+ * room, a party with nobody standing is wiped (permadeath), and a run nobody touches expires. A
+ * cleared or wiped run posts each member's depth to a leaderboard when the hub's config names one.
+ */
+export class InstanceRun {
+    constructor(runtime, nodeType, key) {
+        this.runtime = runtime;
+        this.nodeType = nodeType;
+        this.key = key;
+        this.view = new HubState(runtime, nodeType, key, 'run');
+    }
+    watch() {
+        return this.view.start();
+    }
+    unwatch() {
+        return this.view.stop();
+    }
+    /**
+     * Opens the run as its owner (a developer kit opens one for `party`); resolves with its seed.
+     * @throws {KitError} `started`, `bad_request` (party size), `conflict` (its grid could not be reserved).
+     */
+    open(options = {}) {
+        const args = {};
+        if (options.seed !== undefined)
+            args.seed = options.seed;
+        if (options.party?.length)
+            args.party = options.party.map(Number);
+        return this.runtime.call(this.nodeType, this.key, 'open', args, { action: true });
+    }
+    /** The owner invites a player. @throws {KitError} `forbidden`, `full`. */
+    invite(player) {
+        return this.runtime.call(this.nodeType, this.key, 'invite', { player: Number(player) }, { action: true });
+    }
+    /** An invited player joins. @throws {KitError} `forbidden`. */
+    join() {
+        return this.runtime.call(this.nodeType, this.key, 'join', null, { action: true });
+    }
+    /**
+     * Resolves the room the party is at; resolves with what happened, as the log has it.
+     * @throws {KitError} `not_member`, `forbidden` (the caller is down), `conflict` (descend first), `finished`.
+     */
+    enter() {
+        return this.runtime.call(this.nodeType, this.key, 'enter', null, { action: true });
+    }
+    /** The owner leads the party to the next floor; resolves with it. @throws {KitError} `not_ready` (rooms left), `forbidden`. */
+    descend() {
+        return this.runtime.call(this.nodeType, this.key, 'descend', null, { action: true });
+    }
+    /** The owner (or a developer) ends the run. */
+    abandon() {
+        return this.runtime.call(this.nodeType, this.key, 'abandon', null, { action: true });
+    }
+}

package/dist/kit/modules/leaderboards.d.ts

@@ -0,0 +1,79 @@
+import { HubState } from '../mirror.js';
+import type { KitRuntime } from '../runtime.js';
+/** A player's place on a board. */
+export interface LeaderboardRank {
+    rank: number;
+    player: number;
+    score: number;
+}
+/** What the `board` topic carries: the top of the board and the season. */
+export interface LeaderboardView {
+    season: number;
+    /** When the season began (Unix ms). */
+    season_started: number;
+    /** Players with a score this season. */
+    entries: number;
+    top: LeaderboardRank[];
+}
+/** The season, and the last one's final standings. */
+export interface LeaderboardSeason {
+    season: number;
+    started: number;
+    entries: number;
+    last: LeaderboardRank[];
+}
+/** A board's settings (developers). */
+export interface LeaderboardConfig {
+    /** `best` (by `order`), `sum` or `latest` submission. */
+    keep?: 'best' | 'sum' | 'latest';
+    /** `high` scores rank first (points) or `low` (times). */
+    order?: 'high' | 'low';
+    top_size?: number;
+    /** A cron schedule that ends the season (`0 0 * * 1`: every Monday), or null for none. */
+    season_cron?: string | null;
+    max_entries?: number;
+}
+/** Leaderboards (the `leaderboard` starter): {@link board} by name. */
+export declare class LeaderboardsKit {
+    private readonly runtime;
+    private readonly nodeType;
+    private readonly boards;
+    constructor(runtime: KitRuntime, nodeType?: string);
+    /** The board named `name` (`weekly-score`, `fastest-lap`, ...). */
+    board(name: string): LeaderboardHandle;
+}
+/**
+ * One board. The hub ranks players itself, and only other hubs and developers submit: a client
+ * never sends its own score, the hub that decided the result does (a session, a race, a run).
+ * {@link view} mirrors the `board` topic (at most once a second).
+ */
+export declare class LeaderboardHandle {
+    private readonly runtime;
+    readonly nodeType: string;
+    readonly name: string;
+    /** The `board` topic: the top of the board and the season. */
+    readonly view: HubState<LeaderboardView>;
+    constructor(runtime: KitRuntime, nodeType: string, name: string);
+    watch(): Promise<LeaderboardView>;
+    unwatch(): Promise<void>;
+    /** A page of the board, best first. */
+    top(options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<LeaderboardRank[]>;
+    /** The places around a player (the caller's own, without `player`). */
+    around(options?: {
+        player?: number | string;
+        radius?: number;
+    }): Promise<LeaderboardRank[]>;
+    /** The caller's own place, or null without a score this season. */
+    me(): Promise<LeaderboardRank | null>;
+    season(): Promise<LeaderboardSeason>;
+    /** Submits a score for `player`. Developers only (a developer kit); players are refused. */
+    submit(player: number | string, score: number): Promise<number>;
+    /** Sets the board's config. Developers only. */
+    configure(config: LeaderboardConfig): Promise<boolean>;
+    /** Ends the season now; resolves with the new season. Developers only. */
+    roll(): Promise<number>;
+}
+//# sourceMappingURL=leaderboards.d.ts.map

package/dist/kit/modules/leaderboards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"leaderboards.d.ts","sourceRoot":"","sources":["../../../src/kit/modules/leaderboards.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,mCAAmC;AACnC,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,2EAA2E;AAC3E,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,cAAc,EAAE,MAAM,CAAC;IACvB,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,eAAe,EAAE,CAAC;CACxB;AAED,sDAAsD;AACtD,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,eAAe,EAAE,CAAC;CACzB;AAED,uCAAuC;AACvC,MAAM,WAAW,iBAAiB;IAChC,yDAAyD;IACzD,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;IACjC,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0FAA0F;IAC1F,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,uEAAuE;AACvE,qBAAa,eAAe;IAIxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAJ3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwC;gBAG5C,OAAO,EAAE,UAAU,EACnB,QAAQ,SAAgB;IAG3C,mEAAmE;IACnE,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB;CAQvC;AAED;;;;GAIG;AACH,qBAAa,iBAAiB;IAK1B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM;IANvB,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAC;gBAGtB,OAAO,EAAE,UAAU,EAC3B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM;IAKvB,KAAK,IAAI,OAAO,CAAC,eAAe,CAAC;IAIjC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxB,uCAAuC;IACvC,GAAG,CAAC,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAIlF,uEAAuE;IACvE,MAAM,CAAC,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAO/F,mEAAmE;IACnE,EAAE,IAAI,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAIrC,MAAM,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAIpC,4FAA4F;IAC5F,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI/D,gDAAgD;IAChD,SAAS,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC;IAItD,0EAA0E;IAC1E,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;CAGxB"}

package/dist/kit/modules/leaderboards.js

@@ -0,0 +1,69 @@
+import { HubState } from '../mirror.js';
+/** Leaderboards (the `leaderboard` starter): {@link board} by name. */
+export class LeaderboardsKit {
+    constructor(runtime, nodeType = 'leaderboard') {
+        this.runtime = runtime;
+        this.nodeType = nodeType;
+        this.boards = new Map();
+    }
+    /** The board named `name` (`weekly-score`, `fastest-lap`, ...). */
+    board(name) {
+        let b = this.boards.get(name);
+        if (!b) {
+            b = new LeaderboardHandle(this.runtime, this.nodeType, name);
+            this.boards.set(name, b);
+        }
+        return b;
+    }
+}
+/**
+ * One board. The hub ranks players itself, and only other hubs and developers submit: a client
+ * never sends its own score, the hub that decided the result does (a session, a race, a run).
+ * {@link view} mirrors the `board` topic (at most once a second).
+ */
+export class LeaderboardHandle {
+    constructor(runtime, nodeType, name) {
+        this.runtime = runtime;
+        this.nodeType = nodeType;
+        this.name = name;
+        this.view = new HubState(runtime, nodeType, name, 'board');
+    }
+    watch() {
+        return this.view.start();
+    }
+    unwatch() {
+        return this.view.stop();
+    }
+    /** A page of the board, best first. */
+    top(options = {}) {
+        return this.runtime.call(this.nodeType, this.name, 'top', options);
+    }
+    /** The places around a player (the caller's own, without `player`). */
+    around(options = {}) {
+        const args = {};
+        if (options.player !== undefined)
+            args.player = Number(options.player);
+        if (options.radius !== undefined)
+            args.radius = options.radius;
+        return this.runtime.call(this.nodeType, this.name, 'around', args);
+    }
+    /** The caller's own place, or null without a score this season. */
+    me() {
+        return this.runtime.call(this.nodeType, this.name, 'me');
+    }
+    season() {
+        return this.runtime.call(this.nodeType, this.name, 'season');
+    }
+    /** Submits a score for `player`. Developers only (a developer kit); players are refused. */
+    submit(player, score) {
+        return this.runtime.call(this.nodeType, this.name, 'submit', { player: Number(player), score }, { action: true });
+    }
+    /** Sets the board's config. Developers only. */
+    configure(config) {
+        return this.runtime.call(this.nodeType, this.name, 'configure', config, { action: true });
+    }
+    /** Ends the season now; resolves with the new season. Developers only. */
+    roll() {
+        return this.runtime.call(this.nodeType, this.name, 'roll', null, { action: true });
+    }
+}

package/dist/kit/modules/minigames.d.ts

@@ -0,0 +1,59 @@
+import { HubState } from '../mirror.js';
+import type { KitRuntime } from '../runtime.js';
+export interface DuelSeat {
+    player: number;
+    wins: number;
+    /** Whether this round's throw is in (never which). */
+    thrown: boolean;
+}
+export interface DuelReveal {
+    round: number;
+    /** Each seat's throw, in seat order; null when it was not in on time. */
+    hands: Array<string | null>;
+    winner: number | null;
+}
+/** What the `duel` topic carries: who has thrown, never what, until the reveal. */
+export interface DuelView {
+    phase: 'waiting' | 'playing' | 'finished';
+    seats: DuelSeat[];
+    best_of: number;
+    round: number;
+    /** When this round closes (Unix ms). */
+    deadline: number | null;
+    last: DuelReveal | null;
+    winner: number | null;
+}
+/** Two-player duels of hidden throws (the `minigame` starter): {@link duel} by table. */
+export declare class MinigamesKit {
+    private readonly runtime;
+    private readonly nodeType;
+    private readonly duels;
+    constructor(runtime: KitRuntime, nodeType?: string);
+    duel(key: string): Duel;
+}
+/**
+ * One duel: the hub keeps each round's throws until both are in (or the round's time runs out),
+ * then reveals them; the first to win a majority of `best_of` rounds wins. The starter's game is
+ * rock, paper, scissors.
+ */
+export declare class Duel {
+    private readonly runtime;
+    readonly nodeType: string;
+    readonly key: string;
+    readonly view: HubState<DuelView>;
+    constructor(runtime: KitRuntime, nodeType: string, key: string);
+    watch(): Promise<DuelView>;
+    unwatch(): Promise<void>;
+    /** Takes a seat; resolves with whether this seat started the first round. @throws {KitError} `full`. */
+    join(): Promise<boolean>;
+    /** Before the duel starts. @throws {KitError} `started`. */
+    leave(): Promise<boolean>;
+    /**
+     * The caller's hidden throw this round; resolves with whether it completed the round.
+     * @throws {KitError} `conflict` (already in, or no round open), `bad_request` (not a hand), `not_member`.
+     */
+    throw(hand: string): Promise<boolean>;
+    /** Once it is over: play again. @throws {KitError} `conflict`, `not_member`. */
+    rematch(): Promise<boolean>;
+}
+//# sourceMappingURL=minigames.d.ts.map

package/dist/kit/modules/minigames.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"minigames.d.ts","sourceRoot":"","sources":["../../../src/kit/modules/minigames.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,KAAK,EAAE,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC5B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,mFAAmF;AACnF,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;IAC1C,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,yFAAyF;AACzF,qBAAa,YAAY;IAIrB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAJ3B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2B;gBAG9B,OAAO,EAAE,UAAU,EACnB,QAAQ,SAAa;IAGxC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;CAQxB;AAED;;;;GAIG;AACH,qBAAa,IAAI;IAIb,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM;IALtB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;gBAGf,OAAO,EAAE,UAAU,EAC3B,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM;IAKtB,KAAK,IAAI,OAAO,CAAC,QAAQ,CAAC;IAI1B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxB,wGAAwG;IACxG,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAIxB,4DAA4D;IAC5D,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC;IAIzB;;;OAGG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIrC,gFAAgF;IAChF,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;CAG5B"}

package/dist/kit/modules/minigames.js

@@ -0,0 +1,55 @@
+import { HubState } from '../mirror.js';
+/** Two-player duels of hidden throws (the `minigame` starter): {@link duel} by table. */
+export class MinigamesKit {
+    constructor(runtime, nodeType = 'minigame') {
+        this.runtime = runtime;
+        this.nodeType = nodeType;
+        this.duels = new Map();
+    }
+    duel(key) {
+        let d = this.duels.get(key);
+        if (!d) {
+            d = new Duel(this.runtime, this.nodeType, key);
+            this.duels.set(key, d);
+        }
+        return d;
+    }
+}
+/**
+ * One duel: the hub keeps each round's throws until both are in (or the round's time runs out),
+ * then reveals them; the first to win a majority of `best_of` rounds wins. The starter's game is
+ * rock, paper, scissors.
+ */
+export class Duel {
+    constructor(runtime, nodeType, key) {
+        this.runtime = runtime;
+        this.nodeType = nodeType;
+        this.key = key;
+        this.view = new HubState(runtime, nodeType, key, 'duel');
+    }
+    watch() {
+        return this.view.start();
+    }
+    unwatch() {
+        return this.view.stop();
+    }
+    /** Takes a seat; resolves with whether this seat started the first round. @throws {KitError} `full`. */
+    join() {
+        return this.runtime.call(this.nodeType, this.key, 'join', null, { action: true });
+    }
+    /** Before the duel starts. @throws {KitError} `started`. */
+    leave() {
+        return this.runtime.call(this.nodeType, this.key, 'leave', null, { action: true });
+    }
+    /**
+     * The caller's hidden throw this round; resolves with whether it completed the round.
+     * @throws {KitError} `conflict` (already in, or no round open), `bad_request` (not a hand), `not_member`.
+     */
+    throw(hand) {
+        return this.runtime.call(this.nodeType, this.key, 'throw', { hand }, { action: true });
+    }
+    /** Once it is over: play again. @throws {KitError} `conflict`, `not_member`. */
+    rematch() {
+        return this.runtime.call(this.nodeType, this.key, 'rematch', null, { action: true });
+    }
+}

package/dist/kit/modules/racing.d.ts

@@ -0,0 +1,131 @@
+import { HubState } from '../mirror.js';
+import type { KitRuntime } from '../runtime.js';
+export interface RaceGate {
+    x: number;
+    z: number;
+    radius: number;
+}
+export interface RaceRacer {
+    player: number;
+    x: number;
+    z: number;
+    lap: number;
+    /** The gate the racer must pass next. */
+    next_gate: number;
+    best_lap_ms: number | null;
+    place: number | null;
+    total_ms: number | null;
+    did_not_finish: boolean;
+}
+/** What the `race` topic carries. */
+export interface RaceView {
+    phase: 'lobby' | 'countdown' | 'racing' | 'finished';
+    course_id: string;
+    gates: RaceGate[];
+    laps: number;
+    /** When the race starts (Unix ms), once counting down. */
+    go_at: number | null;
+    /** When the rest's time is up, once the winner is in. */
+    closes_at: number | null;
+    racers: RaceRacer[];
+}
+/** The winner's run: `[ms from the start, x, y, z, yaw]` frames to race against. */
+export interface RaceGhost {
+    player: number;
+    total_ms: number;
+    frames: Array<[number, number, number, number, number]>;
+}
+export interface BallPlayer {
+    player: number;
+    team: 'red' | 'blue';
+    x: number;
+    z: number;
+}
+export interface BallState {
+    x: number;
+    z: number;
+    vx: number;
+    vz: number;
+    holder: number | null;
+    held_since: number;
+    last_touch: number | null;
+}
+/** What the `ball` topic carries. */
+export interface BallView {
+    phase: 'lobby' | 'playing' | 'finished';
+    width: number;
+    depth: number;
+    goal_width: number;
+    ball: BallState;
+    players: BallPlayer[];
+    /** Red's, then blue's. */
+    score: [number, number];
+    ends_at: number | null;
+    winner: 'red' | 'blue' | null;
+}
+/** Races and ball games (the `racing` starter, types `race` and `ball`). */
+export declare class RacingKit {
+    private readonly runtime;
+    private readonly raceType;
+    private readonly ballType;
+    private readonly races;
+    private readonly matches;
+    constructor(runtime: KitRuntime, raceType?: string, ballType?: string);
+    /** The race with key `key`. */
+    race(key: string): Race;
+    /** The ball game with key `key`. */
+    ball(key: string): BallMatch;
+}
+/**
+ * One race: a course of gates passed in order, a countdown, laps and splits, places in finishing
+ * order, and a ghost of the winner's run. A client reports where its racer is ({@link pos}, a few
+ * times a second) and the hub times the positions its movement warden kept. `view.onEvent` hears
+ * `go`, `timing` (with its `stage`: `started`, `checkpoint`, `lap`, `finished`), `violation` and
+ * `finished`.
+ */
+export declare class Race {
+    private readonly runtime;
+    readonly nodeType: string;
+    readonly key: string;
+    readonly view: HubState<RaceView>;
+    constructor(runtime: KitRuntime, nodeType: string, key: string);
+    watch(): Promise<RaceView>;
+    unwatch(): Promise<void>;
+    /** @throws {KitError} `started`, `full`. */
+    join(): Promise<boolean>;
+    leave(): Promise<boolean>;
+    /** Starts the countdown (the first to join, or a developer). @throws {KitError} `forbidden`, `started`. */
+    start(): Promise<boolean>;
+    /** Reports where the racer is; resolves with the position the hub kept. */
+    pos(x: number, z: number): Promise<[number, number]>;
+    /** The winner's run, once there is one. */
+    ghost(): Promise<RaceGhost | null>;
+}
+/**
+ * One ball game: two teams, a ball the hub moves (passes, shots, friction, the side walls),
+ * possession (claim a loose ball near it, or take it from an opponent whose protection is over), a
+ * goal in each end wall. `view.onEvent` hears `claimed`, `passed`, `shot`, `goal`, `violation` and
+ * `finished`.
+ */
+export declare class BallMatch {
+    private readonly runtime;
+    readonly nodeType: string;
+    readonly key: string;
+    readonly view: HubState<BallView>;
+    constructor(runtime: KitRuntime, nodeType: string, key: string);
+    watch(): Promise<BallView>;
+    unwatch(): Promise<void>;
+    /** @throws {KitError} `bad_request` (red or blue), `full`, `started`. */
+    join(team: 'red' | 'blue'): Promise<boolean>;
+    /** @throws {KitError} `forbidden`, `not_ready` (each team needs a player), `started`. */
+    start(): Promise<boolean>;
+    /** Reports where the player is; resolves with the position the hub kept. */
+    pos(x: number, z: number): Promise<[number, number]>;
+    /** Claims the ball. @throws {KitError} `out_of_reach`, `cooldown` (too soon, or its holder's protection), `conflict` (a teammate has it). */
+    claim(): Promise<boolean>;
+    /** Passes to a teammate. @throws {KitError} `conflict` (not the holder), `bad_request` (not a teammate). */
+    pass(to: number | string): Promise<boolean>;
+    /** Shoots toward `(x, z)`. @throws {KitError} `conflict` (not the holder). */
+    shoot(x: number, z: number): Promise<boolean>;
+}
+//# sourceMappingURL=racing.d.ts.map

package/dist/kit/modules/racing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"racing.d.ts","sourceRoot":"","sources":["../../../src/kit/modules/racing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,MAAM,WAAW,QAAQ;IACvB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,GAAG,EAAE,MAAM,CAAC;IACZ,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,qCAAqC;AACrC,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,OAAO,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,CAAC;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,yDAAyD;IACzD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB;AAED,oFAAoF;AACpF,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACzD;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,KAAK,GAAG,MAAM,CAAC;IACrB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,SAAS;IACxB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,qCAAqC;AACrC,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,OAAO,GAAG,SAAS,GAAG,UAAU,CAAC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,0BAA0B;IAC1B,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,4EAA4E;AAC5E,qBAAa,SAAS;IAKlB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAN3B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2B;IACjD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgC;gBAGrC,OAAO,EAAE,UAAU,EACnB,QAAQ,SAAS,EACjB,QAAQ,SAAS;IAGpC,+BAA+B;IAC/B,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IASvB,oCAAoC;IACpC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS;CAQ7B;AAED;;;;;;GAMG;AACH,qBAAa,IAAI;IAIb,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM;IALtB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;gBAGf,OAAO,EAAE,UAAU,EAC3B,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM;IAKtB,KAAK,IAAI,OAAO,CAAC,QAAQ,CAAC;IAI1B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxB,4CAA4C;IAC5C,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAIxB,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC;IAIzB,2GAA2G;IAC3G,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC;IAIzB,2EAA2E;IAC3E,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAIpD,2CAA2C;IAC3C,KAAK,IAAI,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;CAGnC;AAED;;;;;GAKG;AACH,qBAAa,SAAS;IAIlB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM;IALtB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;gBAGf,OAAO,EAAE,UAAU,EAC3B,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM;IAKtB,KAAK,IAAI,OAAO,CAAC,QAAQ,CAAC;IAI1B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxB,yEAAyE;IACzE,IAAI,CAAC,IAAI,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI5C,yFAAyF;IACzF,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC;IAIzB,4EAA4E;IAC5E,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAIpD,6IAA6I;IAC7I,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC;IAIzB,4GAA4G;IAC5G,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI3C,8EAA8E;IAC9E,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAG9C"}

package/dist/kit/modules/racing.js

@@ -0,0 +1,113 @@
+import { HubState } from '../mirror.js';
+/** Races and ball games (the `racing` starter, types `race` and `ball`). */
+export class RacingKit {
+    constructor(runtime, raceType = 'race', ballType = 'ball') {
+        this.runtime = runtime;
+        this.raceType = raceType;
+        this.ballType = ballType;
+        this.races = new Map();
+        this.matches = new Map();
+    }
+    /** The race with key `key`. */
+    race(key) {
+        let r = this.races.get(key);
+        if (!r) {
+            r = new Race(this.runtime, this.raceType, key);
+            this.races.set(key, r);
+        }
+        return r;
+    }
+    /** The ball game with key `key`. */
+    ball(key) {
+        let m = this.matches.get(key);
+        if (!m) {
+            m = new BallMatch(this.runtime, this.ballType, key);
+            this.matches.set(key, m);
+        }
+        return m;
+    }
+}
+/**
+ * One race: a course of gates passed in order, a countdown, laps and splits, places in finishing
+ * order, and a ghost of the winner's run. A client reports where its racer is ({@link pos}, a few
+ * times a second) and the hub times the positions its movement warden kept. `view.onEvent` hears
+ * `go`, `timing` (with its `stage`: `started`, `checkpoint`, `lap`, `finished`), `violation` and
+ * `finished`.
+ */
+export class Race {
+    constructor(runtime, nodeType, key) {
+        this.runtime = runtime;
+        this.nodeType = nodeType;
+        this.key = key;
+        this.view = new HubState(runtime, nodeType, key, 'race');
+    }
+    watch() {
+        return this.view.start();
+    }
+    unwatch() {
+        return this.view.stop();
+    }
+    /** @throws {KitError} `started`, `full`. */
+    join() {
+        return this.runtime.call(this.nodeType, this.key, 'join', null, { action: true });
+    }
+    leave() {
+        return this.runtime.call(this.nodeType, this.key, 'leave', null, { action: true });
+    }
+    /** Starts the countdown (the first to join, or a developer). @throws {KitError} `forbidden`, `started`. */
+    start() {
+        return this.runtime.call(this.nodeType, this.key, 'start', null, { action: true });
+    }
+    /** Reports where the racer is; resolves with the position the hub kept. */
+    pos(x, z) {
+        return this.runtime.call(this.nodeType, this.key, 'pos', { x, z });
+    }
+    /** The winner's run, once there is one. */
+    ghost() {
+        return this.runtime.call(this.nodeType, this.key, 'ghost');
+    }
+}
+/**
+ * One ball game: two teams, a ball the hub moves (passes, shots, friction, the side walls),
+ * possession (claim a loose ball near it, or take it from an opponent whose protection is over), a
+ * goal in each end wall. `view.onEvent` hears `claimed`, `passed`, `shot`, `goal`, `violation` and
+ * `finished`.
+ */
+export class BallMatch {
+    constructor(runtime, nodeType, key) {
+        this.runtime = runtime;
+        this.nodeType = nodeType;
+        this.key = key;
+        this.view = new HubState(runtime, nodeType, key, 'ball');
+    }
+    watch() {
+        return this.view.start();
+    }
+    unwatch() {
+        return this.view.stop();
+    }
+    /** @throws {KitError} `bad_request` (red or blue), `full`, `started`. */
+    join(team) {
+        return this.runtime.call(this.nodeType, this.key, 'join', { team }, { action: true });
+    }
+    /** @throws {KitError} `forbidden`, `not_ready` (each team needs a player), `started`. */
+    start() {
+        return this.runtime.call(this.nodeType, this.key, 'start', null, { action: true });
+    }
+    /** Reports where the player is; resolves with the position the hub kept. */
+    pos(x, z) {
+        return this.runtime.call(this.nodeType, this.key, 'pos', { x, z });
+    }
+    /** Claims the ball. @throws {KitError} `out_of_reach`, `cooldown` (too soon, or its holder's protection), `conflict` (a teammate has it). */
+    claim() {
+        return this.runtime.call(this.nodeType, this.key, 'claim', null, { action: true });
+    }
+    /** Passes to a teammate. @throws {KitError} `conflict` (not the holder), `bad_request` (not a teammate). */
+    pass(to) {
+        return this.runtime.call(this.nodeType, this.key, 'pass', { to: Number(to) }, { action: true });
+    }
+    /** Shoots toward `(x, z)`. @throws {KitError} `conflict` (not the holder). */
+    shoot(x, z) {
+        return this.runtime.call(this.nodeType, this.key, 'shoot', { x, z }, { action: true });
+    }
+}