e2bfa4c
@@ -27,10 +27,13 @@
it: the preview comes up the moment the app answers, and says `live`, or
  positions, emotes and chat cross the wire — a walk is sent once, as a
  target, and every client slides the avatar there itself.
- **A delve** (`/delve/<id>`). Open a table or join one: up to four chefs a
  party. Click to walk, click a monster to swing at it (or `Space`/`J` for
  the nearest), right-click / `Shift`+click / `K` / `Shift` to dodge through
  a hit. WASD or arrows steer. A downed chef gets back up if a friend stands
  over them. Clear five rooms of the day's dungeon to win.
  party. First pick a class in Cheffry's dressing room on the hub — Knight
  (sword, sturdy), Archer (bow, quick), Mage (spellbook, glass cannon) —
  each with its own dodge and a signature move on `E`. Click to walk, click
  a monster to fight it (or `Space`/`J` for the nearest), right-click /
  `Shift`+click / `K` / `Shift` to dodge through a hit. WASD or arrows
  steer. A downed chef gets back up if a friend stands over them. Clear
  five rooms of the day's dungeon to win.
- **Three enemies, three brains** — the Meatball Slime (chases), the
  Baguette Knight (winds up and charges), the Pepper Imp (keeps its distance
  and shoots) — plus Skewer Spikes and chests of coins, truffles, soup and
@@ -70,7 +73,7 @@
decide nothing themselves. `AGENTS.md` says how to add to it.
| file                               | what it is                                                     |
| ---------------------------------- | -------------------------------------------------------------- |
| `src/actions.ts`                   | notes, avatars, delves, heroes, runs; the audit trail, read    |
| `src/sim.ts`                       | the delve: a pure seeded tick — melee, dodge, brains, traps     |
| `src/sim.ts`                       | the delve: a pure seeded tick — classes, shots, abilities, brains  |
| `src/content.ts`, `content/`       | the game as JSON, checked whole at boot                        |
| `src/hub.ts`                       | the square in memory: who stands where, emotes, chat           |
| `src/delves.ts`                    | the live instances, their parties, ticking; runs and ghosts    |
@@ -0,0 +1,1 @@
{"$description":"The classes a chef can delve as, picked in Cheffry's dressing room on the hub. A new class is a new entry here — no code changes — as long as its ability reuses one of the three kinds the sim knows: bulwark (a shield plus a shove), volley (several shots in a spread) or blink (a short teleport). knight is first and is the fallback when a saved class is unknown.","classes":[{"ability":{"cooldownTicks":300,"description":"Raise a pot-lid shield: brief invulnerability, and a shove that sends the room's monsters tumbling.","duration":20,"id":"bulwark","kind":"bulwark","knockback":1.4,"name":"Bulwark","radius":2.2},"cooldown":9,"damage":1,"dodgeCooldown":24,"dodgeSpeed":0.42,"dodgeTicks":6,"hp":8,"id":"knight","invuln":16,"name":"Knight","ranged":false,"reach":1.1,"revive":40,"speed":0.16,"swing":6,"tagline":"Sturdy, straightforward, and legally a knight. The dungeon's original recipe.","weapon":"sword"},{"ability":{"cooldownTicks":240,"count":3,"description":"Loose three arrows in a spread. Table manners not included.","id":"volley","kind":"volley","name":"Volley","spread":0.28},"cooldown":14,"damage":1,"dodgeCooldown":16,"dodgeSpeed":0.55,"dodgeTicks":5,"hp":5,"id":"archer","invuln":12,"name":"Archer","range":6,"ranged":true,"revive":40,"shotSpeed":0.3,"speed":0.16,"swing":4,"tagline":"Fires lunch from across the room. Never does the dishes.","weapon":"bow"},{"ability":{"cooldownTicks":200,"description":"Teleport three tiles forward in a puff of flour, briefly untouchable.","distance":3,"id":"blink","invuln":12,"kind":"blink","name":"Blink"},"cooldown":22,"damage":2,"dodgeCooldown":24,"dodgeSpeed":0.42,"dodgeTicks":6,"hp":4,"id":"mage","invuln":12,"name":"Mage","range":5,"ranged":true,"revive":40,"shotSpeed":0.25,"speed":0.15,"swing":8,"tagline":"A glass cannon. Emphasis on glass. Do not tap.","weapon":"spellbook"}]}
↵
@@ -648,6 +648,9 @@
                "properties": {
                  "delve": {
                    "type": "integer"
                  },
                  "class": {
                    "type": "string"
                  }
                },
                "required": [
@@ -747,13 +750,14 @@
            "application/json": {
              "schema": {
                "type": "object",
                "description": "move: walk to (x, z). attack: fight `target` (a monster's id), or swing where you face. dodge: roll toward (x, z). stop.",
                "description": "move: walk to (x, z). attack: fight `target` (a monster's id), or swing where you face. dodge: roll toward (x, z). ability: your class's signature move. stop.",
                "properties": {
                  "type": {
                    "enum": [
                      "move",
                      "attack",
                      "dodge",
                      "ability",
                      "stop"
                    ]
                  },
@@ -1328,6 +1332,9 @@
                },
                "name": {
                  "type": "string"
                },
                "classId": {
                  "type": "string"
                }
              }
            }
@@ -1385,13 +1392,17 @@
          },
          "author_name": {
            "type": "string"
          },
          "classId": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "delve_id",
          "author_id",
          "author_name"
          "author_name",
          "classId"
        ]
      },
      "Run": {
@@ -503,17 +503,38 @@
export function watchDelve(
 * Open today's dungeon with yourself at the table. Whoever is in another
 * delve leaves it first: a chef cooks in one kitchen at a time.
 */
export const openDelve = (db: Database, who: Who): Result<DelveView> =>
  audited(db, who, "delve", "create", undefined, openOne(db, who));
export const openDelve = (
  db: Database,
  who: Who,
  input: { class?: string } = {},
): Result<DelveView> =>
  audited(db, who, "delve", "create", undefined, openOne(db, who, input));
function openOne(db: Database, who: Who): Result<DelveView> {
/** The class a chef delves as: the dressing room's pick, or the knight. */
function checkClass(input: { class?: string }): Result<string> {
  const classId = input.class ?? "knight";
  if (!game.classes.some((c) => c.id === classId))
    return fail(
      "invalid",
      `No such class: ${classId}. The dressing room offers ${game.classes.map((c) => c.id).join(", ")}.`,
    );
  return ok(classId);
}
function openOne(
  db: Database,
  who: Who,
  input: { class?: string },
): Result<DelveView> {
  if (who.role === "anon" || permit(who, "delve", "create") !== "yes")
    return refuse(who, "Sign in to start a delve.", "You may not start a delve.");
  const picked = checkClass(input);
  if (!picked.ok) return picked;
  const now = Date.now();
  const before = kitchen.heroOfAuthor(who.id);
  if (before !== undefined) kitchen.dismiss(before, now);
  const delve = kitchen.open(who, now, (d) => recordRun(db, d));
  kitchen.enlist(delve, who, now);
  kitchen.enlist(delve, who, now, picked.value);
  emit("delve.opened", { id: delve.id });
  return ok(kitchen.view(delve));
}
@@ -559,11 +580,11 @@
export function getHero(
export const joinDelve = (
  db: Database,
  who: Who,
  input: { delve: number },
  input: { delve: number; class?: string },
): Result<HeroView> =>
  audited(db, who, "hero", "create", undefined, join(who, input));
function join(who: Who, input: { delve: number }): Result<HeroView> {
function join(who: Who, input: { delve: number; class?: string }): Result<HeroView> {
  if (who.role === "anon" || permit(who, "hero", "create") !== "yes")
    return refuse(who, "Sign in to join a party.", "You may not join a party.");
  if (!Number.isInteger(input.delve))
@@ -571,13 +592,15 @@
function join(who: Who, input: { delve: number }): Result<HeroView> {
  const delve = kitchen.delveOf(input.delve);
  if (delve === undefined || delve.ended !== null)
    return fail("not_found", "That delve is over, or never was.");
  const picked = checkClass(input);
  if (!picked.ok) return picked;
  const now = Date.now();
  const before = kitchen.heroOfAuthor(who.id);
  if (before?.delve_id === delve.id) return ok(kitchen.heroView(before));
  if (!kitchen.joinable(delve))
    return fail("invalid", `That party is full: ${kitchen.PARTY_MAX} chefs a table.`);
  if (before !== undefined) kitchen.dismiss(before, now);
  const hero = kitchen.enlist(delve, who, now);
  const hero = kitchen.enlist(delve, who, now, picked.value);
  emit("delve.changed", { id: delve.id });
  return ok(kitchen.heroView(hero));
}
@@ -608,8 +631,9 @@
export function readOrder(
      ? { type: "attack", target: input.target as number }
      : "A target is a monster's id, a whole number.";
  }
  if (type === "ability") return { type: "ability" };
  if (type === "stop") return { type: "stop" };
  return "An order is move, attack, dodge or stop.";
  return "An order is move, attack, dodge, ability or stop.";
}
/** Give your hero an order: move, attack, dodge or stop. */
@@ -0,0 +1,74 @@
/**
 * The classes file, checked like every other content file: bad data names
 * its field, and the app will not start on it.
 */
import { expect, test } from "bun:test";
import { readFileSync } from "node:fs";
import { check } from "./content.ts";
const raw = (name: string): unknown =>
  JSON.parse(readFileSync(new URL(`../content/${name}.json`, import.meta.url), "utf8"));
const files = () => ({
  rules: raw("rules"),
  monsters: raw("monsters"),
  traps: raw("traps"),
  loot: raw("loot"),
  rooms: raw("rooms"),
  hub: raw("hub"),
  classes: raw("classes"),
});
const withClasses = (mutate: (c: any) => void) => {
  const f = files();
  mutate((f.classes as any).classes);
  return check(f);
};
test("the shipped classes are clean", () => {
  expect(check(files())).toEqual([]);
});
test("class ids are unique and one of them is the knight fallback", () => {
  const dup = withClasses((list) => list.push({ ...list[0] }));
  expect(dup.some((p) => p.includes("appears twice"))).toBe(true);
  const noKnight = withClasses((list) => {
    list.splice(0, list.length, ...list.filter((c: any) => c.id !== "knight"));
  });
  expect(noKnight.some((p) => p.includes("knight"))).toBe(true);
});
test("a class names its tagline, weapon and ranged-ness", () => {
  const bad = withClasses((list) => {
    delete list[1].tagline;
    list[1].weapon = "";
    list[1].ranged = "sometimes";
  });
  expect(bad.some((p) => p.includes("tagline is missing"))).toBe(true);
  expect(bad.some((p) => p.includes("weapon is missing"))).toBe(true);
  expect(bad.some((p) => p.includes("ranged must be true or false"))).toBe(true);
});
test("class numbers are positive, and reach or range fits the weapon", () => {
  const bad = withClasses((list) => {
    list[0].hp = 0;
    delete list[0].reach;
    list[1].range = -2;
    delete list[2].shotSpeed;
  });
  expect(bad.some((p) => p.includes("hp must be a positive number"))).toBe(true);
  expect(bad.some((p) => p.includes("reach must be a positive number"))).toBe(true);
  expect(bad.some((p) => p.includes("range must be a positive number"))).toBe(true);
  expect(bad.some((p) => p.includes("shotSpeed must be a positive number"))).toBe(true);
});
test("an ability is named, timed, and of a kind the sim knows", () => {
  const bad = withClasses((list) => {
    list[0].ability.kind = "time-stop";
    list[0].ability.cooldownTicks = 0;
    delete list[1].ability.name;
    delete list[2].ability.distance;
  });
  expect(bad.some((p) => p.includes("kind must be one of"))).toBe(true);
  expect(bad.some((p) => p.includes("cooldownTicks must be a positive number"))).toBe(true);
  expect(bad.some((p) => p.includes("name is missing"))).toBe(true);
  expect(bad.some((p) => p.includes("distance must be a positive number"))).toBe(true);
});
@@ -38,6 +38,7 @@
export interface Game extends Content {
}
const BEHAVIORS = ["chase", "charge", "shoot"];
const ABILITY_KINDS = ["bulwark", "volley", "blink"];
const RESERVED = "#.SEC";
const isObject = (v: unknown): v is Record<string, unknown> =>
@@ -54,6 +55,7 @@
export function check(files: {
  loot: unknown;
  rooms: unknown;
  hub: unknown;
  classes: unknown;
}): string[] {
  const problems: string[] = [];
  const say = (where: string, what: string) => problems.push(`${where}: ${what}`);
@@ -177,6 +179,40 @@
export function check(files: {
  });
  if (finals === 0) say("rooms", "at least one room must be final");
  const classes = listOf(files.classes, "classes");
  ids("classes", classes);
  if (!classes.some((c) => isObject(c) && c.id === "knight"))
    say("classes", 'one class must be the "knight" fallback');
  classes.forEach((c, i) => {
    const where = `classes[${i}]`;
    if (!isObject(c)) return;
    for (const key of ["tagline", "weapon"])
      if (typeof c[key] !== "string" || c[key] === "")
        say(where, `${key} is missing`);
    if (typeof c.ranged !== "boolean") say(where, "ranged must be true or false");
    need(where, c, [
      "hp", "speed", "damage", "swing", "cooldown",
      "dodgeSpeed", "dodgeTicks", "dodgeCooldown", "invuln", "revive",
    ]);
    if (c.ranged === true) need(where, c, ["range", "shotSpeed"]);
    else need(where, c, ["reach"]);
    const a = c.ability;
    const awhere = `${where}.ability`;
    if (!isObject(a)) {
      say(where, "ability is missing");
      return;
    }
    for (const key of ["id", "name", "description"])
      if (typeof a[key] !== "string" || a[key] === "")
        say(awhere, `${key} is missing`);
    if (!positive(a.cooldownTicks)) say(awhere, "cooldownTicks must be a positive number");
    if (!ABILITY_KINDS.includes(String(a.kind)))
      say(awhere, `kind must be one of ${ABILITY_KINDS.join(", ")}`);
    if (a.kind === "bulwark") need(awhere, a, ["duration", "knockback", "radius"]);
    if (a.kind === "volley") need(awhere, a, ["count", "spread"]);
    if (a.kind === "blink") need(awhere, a, ["distance", "invuln"]);
  });
  const paints = new Set(
    tokens.filter((t) => t.name.startsWith("--color-")).map((t) => t.name.slice(8)),
  );
@@ -203,6 +239,7 @@
function load(): Game {
    loot: read("loot"),
    rooms: read("rooms"),
    hub: read("hub"),
    classes: read("classes"),
  };
  const problems = check(files);
  if (problems.length > 0) throw new Error(`content/: ${problems.join("; ")}`);
@@ -214,6 +251,7 @@
function load(): Game {
    traps: f.traps!.traps as Game["traps"],
    loot: f.loot!.loot as Game["loot"],
    rooms: f.rooms!.rooms as Game["rooms"],
    classes: f.classes!.classes as Game["classes"],
    hub: { ...hub, props: f.hub!.props as Prop[] },
  };
}
@@ -46,6 +46,8 @@
export interface HeroRow {
  readonly delve_id: number;
  readonly author_id: string;
  readonly author_name: string;
  /** The class from content/classes.json this chef delves as. */
  readonly classId: string;
  seen: number;
}
@@ -72,7 +74,7 @@
export interface DelveView {
  readonly day: string;
  readonly author_id: string;
  readonly host_name: string;
  readonly party: readonly { id: number; author_id: string; name: string }[];
  readonly party: readonly { id: number; author_id: string; name: string; classId: string }[];
  readonly depth: number;
  readonly rooms: number;
  readonly room: string;
@@ -86,6 +88,7 @@
export interface HeroView {
  readonly delve_id: number;
  readonly author_id: string;
  readonly author_name: string;
  readonly classId: string;
}
const delves = new Map<number, Delve>();
@@ -117,6 +120,7 @@
export const view = (d: Delve): DelveView => ({
    id: h.id,
    author_id: h.author_id,
    name: h.author_name,
    classId: h.classId,
  })),
  depth: d.world.depth,
  rooms: d.world.plan.length,
@@ -131,6 +135,7 @@
export const heroView = (h: HeroRow): HeroView => ({
  delve_id: h.delve_id,
  author_id: h.author_id,
  author_name: h.author_name,
  classId: h.classId,
});
/** Open today's dungeon for a party. `onEnd` is told once, when it is over. */
@@ -167,16 +172,19 @@
export function enlist(
  delve: Delve,
  who: { id: string; name: string },
  now: number,
  classId: string = "knight",
): HeroRow {
  const known = game.classes.some((c) => c.id === classId) ? classId : "knight";
  const row: HeroRow = {
    id: nextHero++,
    delve_id: delve.id,
    author_id: who.id,
    author_name: who.name,
    classId: known,
    seen: now,
  };
  heroes.set(row.id, row);
  addHero(game, delve.world, row.id, who.name);
  addHero(game, delve.world, row.id, who.name, known);
  if (!delve.crew.includes(who.name)) delve.crew.push(who.name);
  send(delve);
  return row;
@@ -189,3 +189,39 @@
test("a finished delve goes on the board with its crew and ghost; an empty one d
  expect(one.ok && one.value.ghost).toBe("0,15,55;0,20,55");
  expect(failed(listRuns(db, anon, { day: "yesterday" }))).toBe("invalid");
});
test("joining names a class; the dressing room's word is law", () => {
  const host = chef();
  const opened = openDelve(db, host, { class: "mage" });
  if (!opened.ok) throw new Error(opened.message);
  const id = opened.value.id;
  expect(opened.value.party[0]!.classId).toBe("mage");
  const guest = chef();
  const joined = joinDelve(db, guest, { delve: id, class: "archer" });
  if (!joined.ok) throw new Error(joined.message);
  expect(joined.value.classId).toBe("archer");
  const table = kitchen.delveOf(id)!;
  expect(table.world.heroes.find((h) => h.id === joined.value.id)!.classId).toBe("archer");
  const party = kitchen.view(table).party;
  expect(party.map((h) => h.classId).sort()).toEqual(["archer", "mage"]);
});
test("an unknown class is refused; no class means knight", () => {
  const host = chef();
  const opened = openDelve(db, host);
  if (!opened.ok) throw new Error(opened.message);
  const id = opened.value.id;
  expect(opened.value.party[0]!.classId).toBe("knight");
  const bogus = joinDelve(db, chef(), { delve: id, class: "paladin" });
  expect(failed(bogus)).toBe("invalid");
  const plain = joinDelve(db, chef(), { delve: id });
  if (!plain.ok) throw new Error(plain.message);
  expect(plain.value.classId).toBe("knight");
});
test("an ability is an order the sim can take", () => {
  expect(readOrder({ type: "ability" }, { w: 10, h: 10 })).toEqual({ type: "ability" });
  expect(readOrder({ type: "dance" }, { w: 10, h: 10 })).toBe(
    "An order is move, attack, dodge, ability or stop.",
  );
});
@@ -30,6 +30,11 @@
const OUTCOME: Record<string, string> = {
  abandoned: "Everyone left the table.",
};
const className = (classId: string): string =>
  game.classes.find((c) => c.id === classId)?.name ?? classId;
const abilityName = (classId: string): string =>
  game.classes.find((c) => c.id === classId)?.ability.name ?? "Ability";
export function delvePage(p: DelvePage): string {
  const { who, delve, hero } = p;
  const path = `/delve/${delve.id}`;
@@ -41,6 +46,7 @@
export function delvePage(p: DelvePage): string {
      : `<div class="pad">
        <button class="button button-big" type="button" data-act="attack">Attack</button>
        <button class="button button-big button-alt" type="button" data-act="dodge">Dodge</button>
        <button class="button button-big" type="button" data-act="ability">${escape(abilityName(hero.classId))}</button>
      </div>`;
  return layout(
    `<h2>${escape(delve.host_name)}'s table <small class="muted mono">${escape(delve.day)}</small></h2>
@@ -75,6 +81,7 @@
export function delvePage(p: DelvePage): string {
        <li><b>Walk</b>: click or tap the floor, or WASD / arrow keys.</li>
        <li><b>Fight</b>: click a monster (your chef keeps swinging), or <kbd>Space</kbd> for the nearest.</li>
        <li><b>Dodge</b>: shift-click or right-click where to roll, or <kbd>K</kbd>. Rolling dodges bites, charges, seeds and spikes.</li>
        <li><b>Ability</b>: <kbd>E</kbd> for your class's signature move — a knight's Bulwark, an archer's Volley, a mage's Blink.</li>
        <li><b>Chests</b> open to the touch. <b>Downed?</b> A teammate standing beside you brings you back.</li>
        <li>Clear a room and the door opens. Five floors, then the Pass.</li>
      </ul>
@@ -91,8 +98,12 @@
export function delvePage(p: DelvePage): string {
function party(p: DelvePage, path: string): string {
  const { who, delve, hero } = p;
  const names = delve.party
    .map((h) => `<li>${escape(h.name)}${h.author_id === delve.author_id ? " <small class=\"muted\">host</small>" : ""}</li>`)
    .map((h) => `<li>${escape(h.name)} <small class="muted">${escape(className(h.classId))}</small>${h.author_id === delve.author_id ? " <small class=\"muted\">host</small>" : ""}</li>`)
    .join("");
  const yours =
    hero === undefined
      ? ""
      : `<p class="callout">You delve as the <b>${escape(className(hero.classId))}</b> — press <kbd>E</kbd> for ${escape(abilityName(hero.classId))}.</p>`;
  let action = "";
  if (delve.over === null) {
    if (who.role === "anon")
@@ -105,6 +116,7 @@
function party(p: DelvePage, path: string): string {
  }
  return `<section class="card">
    <h2>At the table <small class="muted">${delve.party.length} of 4</small></h2>
    ${yours}
    ${names === "" ? `<p class="muted">Nobody left.</p>` : `<ul class="list-plain">${names}</ul>`}
    ${action}
    ${delve.over === null ? `<p class="muted">Bring friends: <code class="share">${escape(publicOrigin + path)}</code></p>` : ""}
@@ -45,6 +45,7 @@
export function hubPage(p: HubPage): string {
  ${controls(p)}
  <div class="grid">
    ${tables(p)}
    ${dressingRoom(p)}
    ${board(p)}
    ${square(p)}
    ${wall(p)}
@@ -73,6 +74,7 @@
function controls(p: HubPage): string {
  return `<section class="card controls">
    ${back}
    <form method="post" action="/delves">
      <input type="hidden" name="class" value="knight" data-class>
      <button class="button button-big">Start today's delve</button>
    </form>
    <form class="row wrap" method="post" action="/hub/emote" data-hub aria-label="Emotes">${emotes}</form>
@@ -93,7 +95,7 @@
function tables(p: HubPage): string {
      const join =
        p.who.role === "anon" || seated || !d.joinable
          ? ""
          : `<form method="post" action="/delves/${d.id}/join"><button class="button">Join</button></form>`;
          : `<form method="post" action="/delves/${d.id}/join"><input type="hidden" name="class" value="knight" data-class><button class="button">Join</button></form>`;
      return `<li class="item">
        <div>
          <p><b>${escape(d.host_name)}'s table</b> · ${escape(roomName(d.room))}</p>
@@ -109,6 +111,26 @@
function tables(p: HubPage): string {
  </section>`;
}
function dressingRoom(p: HubPage): string {
  if (p.who.role === "anon") return "";
  const cards = game.classes
    .map(
      (c, i) => `<label class="class-card">
      <input type="radio" name="pick-class" value="${escape(c.id)}"${i === 0 ? " checked" : ""}>
      <span class="class-name">${escape(c.name)}</span>
      <span class="muted">${escape(c.weapon)}</span>
      <span class="class-tag">${escape(c.tagline)}</span>
      <span class="muted"><b>${escape(c.ability.name)}</b> — ${escape(c.ability.description)}</span>
    </label>`,
    )
    .join("");
  return `<section class="card" id="dressing-room">
    <h2>Cheffry's dressing room</h2>
    <p class="muted">Pick tonight's class. The dungeon won't know what hit it.</p>
    <div class="class-pick" role="radiogroup" aria-label="Choose your class">${cards}</div>
  </section>`;
}
function board(p: HubPage): string {
  const rows = p.runs
    .map(
@@ -187,6 +187,7 @@
export const DELVE: Schema = {
          id: { type: "integer" },
          author_id: { type: "string" },
          name: { type: "string" },
          classId: { type: "string" },
        },
      },
    },
@@ -206,15 +207,16 @@
export const HERO: Schema = {
    delve_id: { type: "integer" },
    author_id: { type: "string" },
    author_name: { type: "string" },
    classId: { type: "string" },
  },
  required: ["id", "delve_id", "author_id", "author_name"],
  required: ["id", "delve_id", "author_id", "author_name", "classId"],
};
const ORDER: Schema = {
  type: "object",
  description:
    "move: walk to (x, z). attack: fight `target` (a monster's id), or swing where you face. dodge: roll toward (x, z). stop.",
    "move: walk to (x, z). attack: fight `target` (a monster's id), or swing where you face. dodge: roll toward (x, z). ability: your class's signature move. stop.",
  properties: {
    type: { enum: ["move", "attack", "dodge", "stop"] },
    type: { enum: ["move", "attack", "dodge", "ability", "stop"] },
    x: { type: "number" },
    z: { type: "number" },
    target: { type: "integer" },
@@ -286,6 +288,16 @@
const done = <T>(result: Result<T>): Response =>
const whole = (value: string | null): number | undefined =>
  value !== null && /^\d+$/.test(value) ? Number(value) : undefined;
/** A form's `class` field, when the request bothered with a form at all. */
const formClass = async (request: Request): Promise<string | undefined> => {
  const type = request.headers.get("content-type") ?? "";
  if (!type.includes("form")) return undefined;
  const form = await readForm(request);
  if (form === undefined) return undefined;
  const v = form.get("class");
  return v === null ? undefined : String(v);
};
// The API's description, read from git once: what the tests hold equal to this table.
const OPENAPI = new URL("../contract/openapi.json", import.meta.url);
const openapi = existsSync(OPENAPI) ? readFileSync(OPENAPI, "utf8") : undefined;
@@ -402,8 +414,8 @@
export const routes: readonly Route[] = [
  {
    method: "POST",
    path: "/delves",
    handle: (c) => {
      const opened = openDelve(c.db, c.who);
    handle: async (c) => {
      const opened = openDelve(c.db, c.who, { class: await formClass(c.request) });
      return opened.ok
        ? back(undefined, `/delve/${opened.value.id}`)
        : back(opened.message);
@@ -412,9 +424,12 @@
export const routes: readonly Route[] = [
  {
    method: "POST",
    path: "/delves/:id/join",
    handle: (c) => {
    handle: async (c) => {
      const id = Number(c.params.id);
      const joined = joinDelve(c.db, c.who, { delve: id });
      const joined = joinDelve(c.db, c.who, {
        delve: id,
        class: await formClass(c.request),
      });
      return joined.ok
        ? back(undefined, `/delve/${joined.value.delve_id}`)
        : back(joined.message, Number.isInteger(id) ? `/delve/${id}` : "/");
@@ -604,8 +619,16 @@
export const routes: readonly Route[] = [
    handle: async (c) => {
      const body = await readJson(c.request);
      if (body === undefined) return json({ error: "too_large" }, 413);
      const f = fields(body);
      return answer(
        joinDelve(c.db, c.who, { delve: Number(fields(body).delve) }),
        joinDelve(
          c.db,
          c.who,
          {
            delve: Number(f.delve),
            ...(f.class === undefined ? {} : { class: String(f.class) }),
          },
        ),
        201,
      );
    },
@@ -613,7 +636,10 @@
export const routes: readonly Route[] = [
      summary: "Take a seat at a table (four a table).",
      body: {
        type: "object",
        properties: { delve: { type: "integer" } },
        properties: {
          delve: { type: "integer" },
          class: { type: "string" },
        },
        required: ["delve"],
      },
      answer: HERO,
@@ -439,3 +439,25 @@
test("the sim and the content are served by content, cached for a year", async (
  const data = (await (await fetch(base + content!)).json()) as { monsters: { id: string }[] };
  expect(data.monsters.map((m) => m.id)).toEqual(["meatball", "baguette", "pepper"]);
});
test("joining names a class by form and by API; a bogus class is refused", async () => {
  const host = as("u61", "host");
  const opened = await api("/api/delves", { method: "POST", ...jsonBody({}) }, host);
  expect(opened.status).toBe(201);
  const delve = (await opened.json()) as { id: number };
  const guest = as("u62", "guest");
  const form = new FormData();
  form.set("class", "mage");
  const joined = await api(`/delves/${delve.id}/join`, { method: "POST", body: form, redirect: "manual" }, guest);
  expect(joined.status).toBe(303);
  const other = as("u63", "other");
  const apiJoined = await api("/api/heroes", { method: "POST", ...jsonBody({ delve: delve.id, class: "archer" }) }, other);
  expect(apiJoined.status).toBe(201);
  expect(((await apiJoined.json()) as { classId: string }).classId).toBe("archer");
  const bogus = await api("/api/heroes", { method: "POST", ...jsonBody({ delve: delve.id, class: "paladin" }) }, as("u64", "bogus"));
  expect(bogus.status).toBe(422);
  const party = (await (await fetch(`${base}/api/delves/${delve.id}`)).json()) as {
    party: { classId: string }[];
  };
  expect(party.party.map((h) => h.classId).sort()).toEqual(["archer", "knight", "mage"]);
});
@@ -137,6 +137,7 @@
test("the Pepper Imp keeps its distance and throws seeds", () => {
  const w = createWorld(c, 1);
  const hero = addHero(c, w, 1, "a");
  hero.invuln = 0;
  const startHp = hero.hp;
  w.monsters[0]!.cd = 0;
  let shots = 0;
  for (let t = 0; t < 80; t++) {
@@ -144,7 +145,7 @@
test("the Pepper Imp keeps its distance and throws seeds", () => {
    shots = Math.max(shots, w.shots.length);
  }
  expect(shots).toBeGreaterThan(0);
  expect(w.heroes[0]!.hp).toBeLessThan(c.rules.hero.hp);
  expect(w.heroes[0]!.hp).toBeLessThan(startHp);
});
test("a chest opens to the touch and the loot is the seed's", () => {
@@ -181,3 +182,123 @@
test("a downed chef is revived by a teammate; a party all down is wiped", () =>
  run(c, w, 2);
  expect(w.over).toBe("wiped");
});
test("a hero delves as their class; an unknown class falls back to knight", () => {
  const c = kitchen(["#######", "#S...E#", "#######"]);
  const w = createWorld(c, 1);
  const archer = addHero(c, w, 1, "a", "archer");
  expect(archer.classId).toBe("archer");
  expect(archer.hp).toBe(5);
  const mage = addHero(c, w, 2, "b", "mage");
  expect(mage.classId).toBe("mage");
  expect(mage.hp).toBe(4);
  const bogus = addHero(c, w, 3, "c", "paladin");
  expect(bogus.classId).toBe("knight");
  expect(bogus.hp).toBe(8);
  expect(snapshot(w).heroes.map((h) => h.classId)).toEqual([
    "archer",
    "mage",
    "knight",
  ]);
});
test("the archer fires arrows from afar; the knight still swings steel", () => {
  const c = kitchen(["#########", "#S..m..E#", "#########"]);
  const w = createWorld(c, 1);
  addHero(c, w, 1, "a", "archer");
  const foe = w.monsters[0]!;
  const startHp = foe.hp;
  order(w, 1, { type: "attack", target: foe.id });
  step(c, w);
  const arrows = w.shots.filter((s) => s.from === "hero");
  expect(arrows.length).toBeGreaterThan(0);
  expect(arrows[0]!.by).toBe(1);
  run(c, w, 60);
  const foeAfter = w.monsters.find((m) => m.id === foe.id);
  expect(foeAfter === undefined || foeAfter.hp < startHp).toBe(true);
  const c2 = kitchen(["#########", "#S..m..E#", "#########"]);
  const w2 = createWorld(c2, 1);
  addHero(c2, w2, 1, "b", "knight");
  order(w2, 1, { type: "attack", target: w2.monsters[0]!.id });
  run(c2, w2, 30);
  expect(w2.shots.filter((s) => s.from === "hero")).toHaveLength(0);
});
test("the mage's bolt hits harder and slower", () => {
  const c = kitchen(["#########", "#S..m..E#", "#########"]);
  const w = createWorld(c, 1);
  const mage = addHero(c, w, 1, "a", "mage");
  order(w, 1, { type: "attack", target: w.monsters[0]!.id });
  step(c, w);
  expect(w.shots.filter((s) => s.from === "hero").length).toBeGreaterThan(0);
  expect(mage.cooldown).toBe(22);
});
test("the archer rolls faster and sooner than the knight", () => {
  const c = kitchen(["#######", "#S...E#", "#######"]);
  const w = createWorld(c, 1);
  const archer = addHero(c, w, 1, "a", "archer");
  order(w, 1, { type: "dodge", x: 5, z: 1.5 });
  step(c, w);
  expect(archer.dodgeCd).toBe(16);
  const w2 = createWorld(c, 2);
  const knight = addHero(c, w2, 1, "b", "knight");
  order(w2, 1, { type: "dodge", x: 5, z: 1.5 });
  step(c, w2);
  expect(knight.dodgeCd).toBe(24);
});
test("bulwark: a pot-lid shield and a shove", () => {
  const c = kitchen(["#########", "#S.m...E#", "#########"]);
  const w = createWorld(c, 1);
  const hero = addHero(c, w, 1, "a", "knight");
  hero.invuln = 0;
  const foe = w.monsters[0]!;
  const beforeX = foe.x;
  order(w, 1, { type: "ability" });
  const seen = step(c, w);
  expect(seen.some((h) => h.type === "ability")).toBe(true);
  expect(hero.invuln).toBeGreaterThanOrEqual(20);
  expect(hero.abilityCd).toBe(300);
  expect(foe.x).toBeGreaterThan(beforeX);
});
test("volley: three arrows in a spread", () => {
  const c = kitchen(["#########", "#S....E##", "#########"]);
  const w = createWorld(c, 1);
  addHero(c, w, 1, "a", "archer");
  order(w, 1, { type: "ability" });
  step(c, w);
  const arrows = w.shots.filter((s) => s.from === "hero");
  expect(arrows).toHaveLength(3);
  const dzs = arrows.map((s) => Math.round(s.dz * 1000));
  expect(new Set(dzs).size).toBe(3);
});
test("blink: three tiles forward in a puff of flour", () => {
  const c = kitchen(["############", "#S.......E#", "############"]);
  const w = createWorld(c, 1);
  const hero = addHero(c, w, 1, "a", "mage");
  hero.invuln = 0;
  const beforeX = hero.x;
  order(w, 1, { type: "ability" });
  step(c, w);
  expect(hero.x).toBeGreaterThan(beforeX + 2);
  expect(hero.x).toBeLessThan(beforeX + 3.5);
  expect(hero.invuln).toBeGreaterThan(0);
  expect(hero.abilityCd).toBe(200);
});
test("an ability on cooldown fizzles quietly", () => {
  const c = kitchen(["#########", "#S....E##", "#########"]);
  const w = createWorld(c, 1);
  addHero(c, w, 1, "a", "archer");
  order(w, 1, { type: "ability" });
  step(c, w);
  const first = w.shots.length;
  order(w, 1, { type: "ability" });
  const seen = step(c, w);
  expect(w.shots.length).toBe(first);
  expect(seen.some((h) => h.type === "ability")).toBe(false);
});
@@ -71,6 +71,46 @@
export interface RoomDef {
  readonly final?: boolean;
  readonly map: readonly string[];
}
/**
 * One playable class, as data. A fourth class is a new entry in
 * `content/classes.json`: the sim only knows the three ability kinds,
 * so an ability reusing one of them needs no code.
 */
export interface ClassAbility {
  readonly id: string;
  readonly name: string;
  readonly description: string;
  readonly cooldownTicks: number;
  readonly kind: "bulwark" | "volley" | "blink";
  readonly duration?: number;
  readonly knockback?: number;
  readonly radius?: number;
  readonly count?: number;
  readonly spread?: number;
  readonly distance?: number;
  readonly invuln?: number;
}
export interface ClassDef {
  readonly id: string;
  readonly name: string;
  readonly tagline: string;
  readonly weapon: string;
  readonly ranged: boolean;
  readonly hp: number;
  readonly speed: number;
  readonly damage: number;
  readonly reach?: number;
  readonly range?: number;
  readonly shotSpeed?: number;
  readonly swing: number;
  readonly cooldown: number;
  readonly dodgeSpeed: number;
  readonly dodgeTicks: number;
  readonly dodgeCooldown: number;
  readonly invuln: number;
  readonly revive: number;
  readonly ability: ClassAbility;
}
export interface Content {
  readonly rules: {
    readonly tickHz: number;
@@ -83,6 +123,7 @@
export interface Content {
  readonly traps: readonly TrapDef[];
  readonly loot: readonly LootDef[];
  readonly rooms: readonly RoomDef[];
  readonly classes: readonly ClassDef[];
}
// ── The world ──
@@ -90,6 +131,8 @@
export interface Content {
export interface Hero {
  readonly id: number;
  readonly name: string;
  /** Which class from content/classes.json this chef delves as. */
  classId: string;
  x: number;
  z: number;
  fx: number;
@@ -100,10 +143,12 @@
export interface Hero {
  target: number | null;
  wantSwing: boolean;
  wantDodge: { x: number; z: number } | null;
  wantAbility: boolean;
  swing: number;
  cooldown: number;
  dodge: number;
  dodgeCd: number;
  abilityCd: number;
  dx: number;
  dz: number;
  invuln: number;
@@ -131,6 +176,9 @@
export interface Shot {
  readonly dz: number;
  ttl: number;
  readonly damage: number;
  /** Who fired it: a hero's shots bite monsters, a monster's bite heroes. */
  readonly from: "hero" | "monster";
  readonly by: number;
}
export interface Chest {
  readonly id: number;
@@ -163,6 +211,7 @@
export type Happening =
  | { readonly type: "revived"; readonly hero: number }
  | { readonly type: "slain"; readonly monster: number; readonly kind: string }
  | { readonly type: "loot"; readonly hero: number; readonly loot: string }
  | { readonly type: "ability"; readonly hero: number; readonly ability: string }
  | { readonly type: "open" }
  | { readonly type: "room"; readonly depth: number; readonly room: string }
  | { readonly type: "over"; readonly outcome: Outcome };
@@ -192,6 +241,7 @@
export type Order =
  | { readonly type: "move"; readonly x: number; readonly z: number }
  | { readonly type: "attack"; readonly target?: number | undefined }
  | { readonly type: "dodge"; readonly x: number; readonly z: number }
  | { readonly type: "ability" }
  | { readonly type: "stop" };
// ── Randomness: mulberry32, its state kept in the world ──
@@ -277,6 +327,33 @@
const roomById = (content: Content, id: string): RoomDef => {
const monsterDef = (content: Content, kind: string): MonsterDef =>
  content.monsters.find((m) => m.id === kind)!;
/** The class a hero delves as: unknown ids fall back to the knight. */
export const classOf = (content: Content, classId: string): ClassDef => {
  const found = content.classes.find((c) => c.id === classId);
  if (found !== undefined) return found;
  return content.classes.find((c) => c.id === "knight") ?? content.classes[0]!;
};
/** A hero's numbers: their class's stats over the shared baseline. */
function heroRules(content: Content, hero: Hero): HeroRules {
  const c = classOf(content, hero.classId);
  const base = content.rules.hero;
  return {
    hp: c.hp,
    radius: base.radius,
    speed: c.speed,
    damage: c.damage,
    reach: c.reach ?? base.reach,
    swing: c.swing,
    cooldown: c.cooldown,
    dodgeSpeed: c.dodgeSpeed,
    dodgeTicks: c.dodgeTicks,
    dodgeCooldown: c.dodgeCooldown,
    invuln: c.invuln,
    revive: c.revive,
  };
}
// ── The world, made and changed ──
export function createWorld(content: Content, seed: number): World {
@@ -356,28 +433,32 @@
export function addHero(
  world: World,
  id: number,
  name: string,
  classId: string = "knight",
): Hero {
  const rules = content.rules.hero;
  const cls = classOf(content, classId);
  const hero: Hero = {
    id,
    name,
    classId: cls.id,
    x: 0,
    z: 0,
    fx: 1,
    fz: 0,
    hp: rules.hp,
    hp: cls.hp,
    power: 0,
    goal: null,
    target: null,
    wantSwing: false,
    wantDodge: null,
    wantAbility: false,
    swing: 0,
    cooldown: 0,
    dodge: 0,
    dodgeCd: 0,
    abilityCd: 0,
    dx: 0,
    dz: 0,
    invuln: rules.invuln,
    invuln: cls.invuln,
    downed: false,
    revive: 0,
  };
@@ -403,6 +484,7 @@
export function order(world: World, heroId: number, o: Order): void {
      hero.goal = null;
    } else hero.wantSwing = true;
  } else if (o.type === "dodge") hero.wantDodge = { x: o.x, z: o.z };
  else if (o.type === "ability") hero.wantAbility = true;
  else {
    hero.goal = null;
    hero.target = null;
@@ -464,10 +546,9 @@
export function step(content: Content, world: World): Happening[] {
  world.happened = [];
  if (world.over !== null) return world.happened;
  world.tick++;
  const rules = content.rules.hero;
  for (const hero of world.heroes) stepHero(content, world, hero, rules);
  for (const hero of world.heroes) stepHero(content, world, hero);
  for (const monster of world.monsters) stepMonster(content, world, monster);
  stepShots(world);
  stepShots(content, world);
  stepTraps(content, world);
  const slain = world.monsters.filter((m) => m.hp <= 0);
@@ -524,14 +605,12 @@
export function finish(world: World, outcome: Outcome): void {
  world.happened.push({ type: "over", outcome });
}
function stepHero(
  content: Content,
  world: World,
  hero: Hero,
  rules: HeroRules,
): void {
function stepHero(content: Content, world: World, hero: Hero): void {
  const rules = heroRules(content, hero);
  const cls = classOf(content, hero.classId);
  if (hero.cooldown > 0) hero.cooldown--;
  if (hero.dodgeCd > 0) hero.dodgeCd--;
  if (hero.abilityCd > 0) hero.abilityCd--;
  if (hero.invuln > 0) hero.invuln--;
  if (hero.swing > 0) hero.swing--;
@@ -573,7 +652,9 @@
function stepHero(
    if (foe === undefined) hero.target = null;
    else {
      const d = dist(hero, foe);
      const reach = rules.reach + monsterDef(content, foe.kind).radius * 0.5;
      const reach = cls.ranged
        ? (cls.range ?? rules.reach)
        : rules.reach + monsterDef(content, foe.kind).radius * 0.5;
      const dir = toward(hero, foe);
      if (dir !== undefined) {
        hero.fx = dir.x;
@@ -603,7 +684,15 @@
function stepHero(
  if (hero.wantSwing) {
    hero.wantSwing = false;
    if (hero.cooldown === 0 && hero.dodge === 0) swing(content, world, hero, rules);
    if (hero.cooldown === 0 && hero.dodge === 0) {
      if (cls.ranged) fireShot(content, world, hero, cls, hero.fx, hero.fz, 0);
      else swing(content, world, hero, rules);
    }
  }
  if (hero.wantAbility) {
    hero.wantAbility = false;
    if (hero.abilityCd === 0 && hero.dodge === 0) useAbility(content, world, hero, cls);
  }
  // Treasure opens to the touch.
@@ -638,6 +727,71 @@
function swing(content: Content, world: World, hero: Hero, rules: HeroRules): vo
  }
}
/**
 * A hero's shot: an arrow, a bolt, whatever the class throws. The spread is
 * a sideways nudge, not an angle — no trigonometry, the same on any engine.
 */
function fireShot(
  content: Content,
  world: World,
  hero: Hero,
  cls: ClassDef,
  dx: number,
  dz: number,
  spread: number,
): void {
  const rules = heroRules(content, hero);
  hero.swing = rules.swing;
  hero.cooldown = rules.cooldown;
  const speed = cls.shotSpeed ?? 0.25;
  const vx = (dx + -dz * spread) * speed;
  const vz = (dz + dx * spread) * speed;
  world.shots.push({
    id: world.nextId++,
    x: hero.x,
    z: hero.z,
    dx: vx,
    dz: vz,
    ttl: Math.ceil(((cls.range ?? 6) + 3) / speed),
    damage: rules.damage + hero.power,
    from: "hero",
    by: hero.id,
  });
}
/** A class's signature move, by kind — the JSON names it, this cooks it. */
function useAbility(content: Content, world: World, hero: Hero, cls: ClassDef): void {
  const a = cls.ability;
  hero.abilityCd = a.cooldownTicks;
  world.happened.push({ type: "ability", hero: hero.id, ability: a.id });
  if (a.kind === "bulwark") {
    hero.invuln = Math.max(hero.invuln, a.duration ?? 20);
    const radius = a.radius ?? 2.2;
    const push = a.knockback ?? 1.2;
    for (const m of world.monsters) {
      if (m.hp <= 0) continue;
      const dir = toward(hero, m);
      if (dir === undefined || dist(hero, m) > radius) continue;
      slide(world, m, dir.x * push, dir.z * push, monsterDef(content, m.kind).radius);
    }
  } else if (a.kind === "volley") {
    const n = a.count ?? 3;
    const spread = a.spread ?? 0.28;
    for (let i = 0; i < n; i++)
      fireShot(content, world, hero, cls, hero.fx, hero.fz, (i - (n - 1) / 2) * spread);
  } else if (a.kind === "blink") {
    const rules = heroRules(content, hero);
    let left = a.distance ?? 3;
    while (left > 0) {
      const hop = Math.min(left, 0.5);
      if (slide(world, hero, hero.fx * hop, hero.fz * hop, rules.radius)) break;
      left -= hop;
    }
    hero.invuln = Math.max(hero.invuln, a.invuln ?? 10);
    hero.goal = null;
  }
}
function roll(content: Content, world: World) {
  const total = content.loot.reduce((sum, l) => sum + l.weight, 0);
  let pick = random(world) * total;
@@ -651,7 +805,7 @@
function roll(content: Content, world: World) {
function hurt(content: Content, world: World, hero: Hero, damage: number): boolean {
  if (hero.downed || hero.invuln > 0 || hero.dodge > 0) return false;
  hero.hp -= damage;
  hero.invuln = content.rules.hero.invuln;
  hero.invuln = heroRules(content, hero).invuln;
  world.happened.push({ type: "hurt", hero: hero.id, damage });
  if (hero.hp <= 0) {
    hero.hp = 0;
@@ -748,26 +902,47 @@
function stepMonster(content: Content, world: World, m: Monster): void {
      dz: dir.z * speed,
      ttl: Math.ceil((range + 3) / speed),
      damage: def.damage,
      from: "monster",
      by: m.id,
    });
    m.cd = def.cooldown ?? 45;
  }
}
function stepShots(world: World): void {
  world.shots = world.shots.filter((s) => {
function stepShots(content: Content, world: World): void {
  for (const s of world.shots) {
    s.x += s.dx;
    s.z += s.dz;
    s.ttl--;
    return s.ttl > 0 && !solid(world, Math.floor(s.x), Math.floor(s.z));
  });
    if (s.ttl <= 0) continue;
    // A hero's shot bites the first monster it reaches.
    if (s.from === "hero") {
      for (const m of world.monsters) {
        if (m.hp <= 0) continue;
        const def = monsterDef(content, m.kind);
        if (dist(s, m) > 0.35 + def.radius) continue;
        const dir = toward(s, m);
        m.hp -= s.damage;
        m.hurt = 4;
        if (dir !== undefined) slide(world, m, dir.x * 0.3, dir.z * 0.3, def.radius);
        world.happened.push({ type: "hit", by: s.by, on: m.id, damage: s.damage });
        s.ttl = 0;
        break;
      }
    }
  }
  world.shots = world.shots.filter(
    (s) => s.ttl > 0 && !solid(world, Math.floor(s.x), Math.floor(s.z)),
  );
}
function stepTraps(content: Content, world: World): void {
  // Shots land here too: one pass over the heroes for everything that bites.
  for (const hero of world.heroes) {
    // A seed splats on whoever it reaches, unless they are rolling through it.
    // A monster's seed splats on whoever it reaches, unless they are rolling through it.
    world.shots = world.shots.filter((s) => {
      if (hero.downed || hero.dodge > 0 || dist(s, hero) > 0.4) return true;
      if (s.from === "hero" || hero.downed || hero.dodge > 0 || dist(s, hero) > 0.4)
        return true;
      hurt(content, world, hero, s.damage);
      return false;
    });
@@ -804,6 +979,7 @@
export function snapshot(world: World) {
    heroes: world.heroes.map((h) => ({
      id: h.id,
      name: h.name,
      classId: h.classId,
      x: round(h.x),
      z: round(h.z),
      fx: round(h.fx),
@@ -423,3 +423,34 @@
kbd {
    animation: none;
  }
}
/* Cheffry's dressing room: the class picker. */
.class-pick {
  display: grid;
  gap: var(--space-3);
  grid-template-columns: repeat(auto-fit, minmax(10rem, 1fr));
}
.class-card {
  display: grid;
  gap: var(--space-1);
  align-content: start;
  padding: var(--space-3);
  border: 1px solid var(--color-line);
  border-radius: var(--radius-md);
  cursor: pointer;
  min-height: var(--size-tap);
}
.class-card:has(input:checked) {
  border-color: var(--color-accent);
  outline: 2px solid var(--color-accent);
}
.class-card input {
  accent-color: var(--color-accent);
}
.class-name {
  font-weight: bold;
}
.class-tag {
  font-size: var(--text-sm);
  color: var(--color-muted);
}
@@ -343,6 +343,9 @@
function listen() {
    } else if (k === "k" || k === "Shift") {
      e.preventDefault();
      dodgeAhead();
    } else if (k === "e") {
      e.preventDefault();
      orderUp({ type: "ability" });
    }
  });
  document.addEventListener("keyup", (e) => {
@@ -351,6 +354,7 @@
function listen() {
  });
  document.querySelector("[data-act=attack]")?.addEventListener("click", attackNearest);
  document.querySelector("[data-act=dodge]")?.addEventListener("click", dodgeAhead);
  document.querySelector("[data-act=ability]")?.addEventListener("click", () => orderUp({ type: "ability" }));
}
// Held keys walk a couple of tiles ahead, again while they stay held.
@@ -201,7 +201,30 @@
function listen() {
    });
}
// Cheffry's dressing room: the picked class is remembered, and every
// join or start form carries it when it goes — even tables that open later.
const CLASS_KEY = "cheffry-class";
function dressingRoom() {
  const radios = [...document.querySelectorAll('input[name="pick-class"]')];
  if (radios.length === 0) return;
  const known = (id) => radios.some((r) => r.value === id);
  const saved = localStorage.getItem(CLASS_KEY);
  if (saved && known(saved))
    radios.find((r) => r.value === saved).checked = true;
  for (const r of radios)
    r.addEventListener("change", () => localStorage.setItem(CLASS_KEY, r.value));
  document.addEventListener("submit", (e) => {
    const form = e.target;
    if (!(form instanceof HTMLFormElement)) return;
    const field = form.querySelector("input[data-class]");
    if (!field) return;
    const picked = document.querySelector('input[name="pick-class"]:checked');
    field.value = picked && known(picked.value) ? picked.value : "knight";
  });
}
async function start() {
  dressingRoom();
  if (!renderer) return;
  root.classList.add("ready");
  game = await (await fetch(root.dataset.content)).json();
		@@ -27,10 +27,13 @@ it: the preview comes up the moment the app answers, and says `live`, or
27	27	positions, emotes and chat cross the wire — a walk is sent once, as a
28	28	target, and every client slides the avatar there itself.
29	29	- A delve (`/delve/<id>`). Open a table or join one: up to four chefs a
30		party. Click to walk, click a monster to swing at it (or `Space`/`J` for
31		the nearest), right-click / `Shift`+click / `K` / `Shift` to dodge through
32		a hit. WASD or arrows steer. A downed chef gets back up if a friend stands
33		over them. Clear five rooms of the day's dungeon to win.
	30	party. First pick a class in Cheffry's dressing room on the hub — Knight
	31	(sword, sturdy), Archer (bow, quick), Mage (spellbook, glass cannon) —
	32	each with its own dodge and a signature move on `E`. Click to walk, click
	33	a monster to fight it (or `Space`/`J` for the nearest), right-click /
	34	`Shift`+click / `K` / `Shift` to dodge through a hit. WASD or arrows
	35	steer. A downed chef gets back up if a friend stands over them. Clear
	36	five rooms of the day's dungeon to win.
34	37	- Three enemies, three brains — the Meatball Slime (chases), the
35	38	Baguette Knight (winds up and charges), the Pepper Imp (keeps its distance
36	39	and shoots) — plus Skewer Spikes and chests of coins, truffles, soup and
		@@ -70,7 +73,7 @@ decide nothing themselves. `AGENTS.md` says how to add to it.
70	73	\| file \| what it is \|
71	74	\| ---------------------------------- \| -------------------------------------------------------------- \|
72	75	\| `src/actions.ts` \| notes, avatars, delves, heroes, runs; the audit trail, read \|
73		\| `src/sim.ts` \| the delve: a pure seeded tick — melee, dodge, brains, traps \|
	76	\| `src/sim.ts` \| the delve: a pure seeded tick — classes, shots, abilities, brains \|
74	77	\| `src/content.ts`, `content/` \| the game as JSON, checked whole at boot \|
75	78	\| `src/hub.ts` \| the square in memory: who stands where, emotes, chat \|
76	79	\| `src/delves.ts` \| the live instances, their parties, ticking; runs and ghosts \|
		@@ -0,0 +1,1 @@
	1	{"$description":"The classes a chef can delve as, picked in Cheffry's dressing room on the hub. A new class is a new entry here — no code changes — as long as its ability reuses one of the three kinds the sim knows: bulwark (a shield plus a shove), volley (several shots in a spread) or blink (a short teleport). knight is first and is the fallback when a saved class is unknown.","classes":[{"ability":{"cooldownTicks":300,"description":"Raise a pot-lid shield: brief invulnerability, and a shove that sends the room's monsters tumbling.","duration":20,"id":"bulwark","kind":"bulwark","knockback":1.4,"name":"Bulwark","radius":2.2},"cooldown":9,"damage":1,"dodgeCooldown":24,"dodgeSpeed":0.42,"dodgeTicks":6,"hp":8,"id":"knight","invuln":16,"name":"Knight","ranged":false,"reach":1.1,"revive":40,"speed":0.16,"swing":6,"tagline":"Sturdy, straightforward, and legally a knight. The dungeon's original recipe.","weapon":"sword"},{"ability":{"cooldownTicks":240,"count":3,"description":"Loose three arrows in a spread. Table manners not included.","id":"volley","kind":"volley","name":"Volley","spread":0.28},"cooldown":14,"damage":1,"dodgeCooldown":16,"dodgeSpeed":0.55,"dodgeTicks":5,"hp":5,"id":"archer","invuln":12,"name":"Archer","range":6,"ranged":true,"revive":40,"shotSpeed":0.3,"speed":0.16,"swing":4,"tagline":"Fires lunch from across the room. Never does the dishes.","weapon":"bow"},{"ability":{"cooldownTicks":200,"description":"Teleport three tiles forward in a puff of flour, briefly untouchable.","distance":3,"id":"blink","invuln":12,"kind":"blink","name":"Blink"},"cooldown":22,"damage":2,"dodgeCooldown":24,"dodgeSpeed":0.42,"dodgeTicks":6,"hp":4,"id":"mage","invuln":12,"name":"Mage","range":5,"ranged":true,"revive":40,"shotSpeed":0.25,"speed":0.15,"swing":8,"tagline":"A glass cannon. Emphasis on glass. Do not tap.","weapon":"spellbook"}]}↵
		@@ -648,6 +648,9 @@
648	648	"properties": {
649	649	"delve": {
650	650	"type": "integer"
	651	},
	652	"class": {
	653	"type": "string"
651	654	}
652	655	},
653	656	"required": [
		@@ -747,13 +750,14 @@
747	750	"application/json": {
748	751	"schema": {
749	752	"type": "object",
750		"description": "move: walk to (x, z). attack: fight `target` (a monster's id), or swing where you face. dodge: roll toward (x, z). stop.",
	753	"description": "move: walk to (x, z). attack: fight `target` (a monster's id), or swing where you face. dodge: roll toward (x, z). ability: your class's signature move. stop.",
751	754	"properties": {
752	755	"type": {
753	756	"enum": [
754	757	"move",
755	758	"attack",
756	759	"dodge",
	760	"ability",
757	761	"stop"
758	762	]
759	763	},
		@@ -1328,6 +1332,9 @@
1328	1332	},
1329	1333	"name": {
1330	1334	"type": "string"
	1335	},
	1336	"classId": {
	1337	"type": "string"
1331	1338	}
1332	1339	}
1333	1340	}
		@@ -1385,13 +1392,17 @@
1385	1392	},
1386	1393	"author_name": {
1387	1394	"type": "string"
	1395	},
	1396	"classId": {
	1397	"type": "string"
1388	1398	}
1389	1399	},
1390	1400	"required": [
1391	1401	"id",
1392	1402	"delve_id",
1393	1403	"author_id",
1394		"author_name"
	1404	"author_name",
	1405	"classId"
1395	1406	]
1396	1407	},
1397	1408	"Run": {
		@@ -503,17 +503,38 @@ export function watchDelve(
503	503	* Open today's dungeon with yourself at the table. Whoever is in another
504	504	* delve leaves it first: a chef cooks in one kitchen at a time.
505	505	*/
506		export const openDelve = (db: Database, who: Who): Result<DelveView> =>
507		audited(db, who, "delve", "create", undefined, openOne(db, who));
	506	export const openDelve = (
	507	db: Database,
	508	who: Who,
	509	input: { class?: string } = {},
	510	): Result<DelveView> =>
	511	audited(db, who, "delve", "create", undefined, openOne(db, who, input));
508	512
509		function openOne(db: Database, who: Who): Result<DelveView> {
	513	/** The class a chef delves as: the dressing room's pick, or the knight. */
	514	function checkClass(input: { class?: string }): Result<string> {
	515	const classId = input.class ?? "knight";
	516	if (!game.classes.some((c) => c.id === classId))
	517	return fail(
	518	"invalid",
	519	`No such class: ${classId}. The dressing room offers ${game.classes.map((c) => c.id).join(", ")}.`,
	520	);
	521	return ok(classId);
	522	}
	523
	524	function openOne(
	525	db: Database,
	526	who: Who,
	527	input: { class?: string },
	528	): Result<DelveView> {
510	529	if (who.role === "anon" \|\| permit(who, "delve", "create") !== "yes")
511	530	return refuse(who, "Sign in to start a delve.", "You may not start a delve.");
	531	const picked = checkClass(input);
	532	if (!picked.ok) return picked;
512	533	const now = Date.now();
513	534	const before = kitchen.heroOfAuthor(who.id);
514	535	if (before !== undefined) kitchen.dismiss(before, now);
515	536	const delve = kitchen.open(who, now, (d) => recordRun(db, d));
516		kitchen.enlist(delve, who, now);
	537	kitchen.enlist(delve, who, now, picked.value);
517	538	emit("delve.opened", { id: delve.id });
518	539	return ok(kitchen.view(delve));
519	540	}
		@@ -559,11 +580,11 @@ export function getHero(
559	580	export const joinDelve = (
560	581	db: Database,
561	582	who: Who,
562		input: { delve: number },
	583	input: { delve: number; class?: string },
563	584	): Result<HeroView> =>
564	585	audited(db, who, "hero", "create", undefined, join(who, input));
565	586
566		function join(who: Who, input: { delve: number }): Result<HeroView> {
	587	function join(who: Who, input: { delve: number; class?: string }): Result<HeroView> {
567	588	if (who.role === "anon" \|\| permit(who, "hero", "create") !== "yes")
568	589	return refuse(who, "Sign in to join a party.", "You may not join a party.");
569	590	if (!Number.isInteger(input.delve))
		@@ -571,13 +592,15 @@ function join(who: Who, input: { delve: number }): Result<HeroView> {
571	592	const delve = kitchen.delveOf(input.delve);
572	593	if (delve === undefined \|\| delve.ended !== null)
573	594	return fail("not_found", "That delve is over, or never was.");
	595	const picked = checkClass(input);
	596	if (!picked.ok) return picked;
574	597	const now = Date.now();
575	598	const before = kitchen.heroOfAuthor(who.id);
576	599	if (before?.delve_id === delve.id) return ok(kitchen.heroView(before));
577	600	if (!kitchen.joinable(delve))
578	601	return fail("invalid", `That party is full: ${kitchen.PARTY_MAX} chefs a table.`);
579	602	if (before !== undefined) kitchen.dismiss(before, now);
580		const hero = kitchen.enlist(delve, who, now);
	603	const hero = kitchen.enlist(delve, who, now, picked.value);
581	604	emit("delve.changed", { id: delve.id });
582	605	return ok(kitchen.heroView(hero));
583	606	}
		@@ -608,8 +631,9 @@ export function readOrder(
608	631	? { type: "attack", target: input.target as number }
609	632	: "A target is a monster's id, a whole number.";
610	633	}
	634	if (type === "ability") return { type: "ability" };
611	635	if (type === "stop") return { type: "stop" };
612		return "An order is move, attack, dodge or stop.";
	636	return "An order is move, attack, dodge, ability or stop.";
613	637	}
614	638
615	639	/** Give your hero an order: move, attack, dodge or stop. */
		@@ -0,0 +1,74 @@
	1	/**
	2	* The classes file, checked like every other content file: bad data names
	3	* its field, and the app will not start on it.
	4	*/
	5	import { expect, test } from "bun:test";
	6	import { readFileSync } from "node:fs";
	7	import { check } from "./content.ts";
	8
	9	const raw = (name: string): unknown =>
	10	JSON.parse(readFileSync(new URL(`../content/${name}.json`, import.meta.url), "utf8"));
	11	const files = () => ({
	12	rules: raw("rules"),
	13	monsters: raw("monsters"),
	14	traps: raw("traps"),
	15	loot: raw("loot"),
	16	rooms: raw("rooms"),
	17	hub: raw("hub"),
	18	classes: raw("classes"),
	19	});
	20	const withClasses = (mutate: (c: any) => void) => {
	21	const f = files();
	22	mutate((f.classes as any).classes);
	23	return check(f);
	24	};
	25
	26	test("the shipped classes are clean", () => {
	27	expect(check(files())).toEqual([]);
	28	});
	29
	30	test("class ids are unique and one of them is the knight fallback", () => {
	31	const dup = withClasses((list) => list.push({ ...list[0] }));
	32	expect(dup.some((p) => p.includes("appears twice"))).toBe(true);
	33	const noKnight = withClasses((list) => {
	34	list.splice(0, list.length, ...list.filter((c: any) => c.id !== "knight"));
	35	});
	36	expect(noKnight.some((p) => p.includes("knight"))).toBe(true);
	37	});
	38
	39	test("a class names its tagline, weapon and ranged-ness", () => {
	40	const bad = withClasses((list) => {
	41	delete list[1].tagline;
	42	list[1].weapon = "";
	43	list[1].ranged = "sometimes";
	44	});
	45	expect(bad.some((p) => p.includes("tagline is missing"))).toBe(true);
	46	expect(bad.some((p) => p.includes("weapon is missing"))).toBe(true);
	47	expect(bad.some((p) => p.includes("ranged must be true or false"))).toBe(true);
	48	});
	49
	50	test("class numbers are positive, and reach or range fits the weapon", () => {
	51	const bad = withClasses((list) => {
	52	list[0].hp = 0;
	53	delete list[0].reach;
	54	list[1].range = -2;
	55	delete list[2].shotSpeed;
	56	});
	57	expect(bad.some((p) => p.includes("hp must be a positive number"))).toBe(true);
	58	expect(bad.some((p) => p.includes("reach must be a positive number"))).toBe(true);
	59	expect(bad.some((p) => p.includes("range must be a positive number"))).toBe(true);
	60	expect(bad.some((p) => p.includes("shotSpeed must be a positive number"))).toBe(true);
	61	});
	62
	63	test("an ability is named, timed, and of a kind the sim knows", () => {
	64	const bad = withClasses((list) => {
	65	list[0].ability.kind = "time-stop";
	66	list[0].ability.cooldownTicks = 0;
	67	delete list[1].ability.name;
	68	delete list[2].ability.distance;
	69	});
	70	expect(bad.some((p) => p.includes("kind must be one of"))).toBe(true);
	71	expect(bad.some((p) => p.includes("cooldownTicks must be a positive number"))).toBe(true);
	72	expect(bad.some((p) => p.includes("name is missing"))).toBe(true);
	73	expect(bad.some((p) => p.includes("distance must be a positive number"))).toBe(true);
	74	});
		@@ -38,6 +38,7 @@ export interface Game extends Content {
38	38	}
39	39
40	40	const BEHAVIORS = ["chase", "charge", "shoot"];
	41	const ABILITY_KINDS = ["bulwark", "volley", "blink"];
41	42	const RESERVED = "#.SEC";
42	43
43	44	const isObject = (v: unknown): v is Record<string, unknown> =>
		@@ -54,6 +55,7 @@ export function check(files: {
54	55	loot: unknown;
55	56	rooms: unknown;
56	57	hub: unknown;
	58	classes: unknown;
57	59	}): string[] {
58	60	const problems: string[] = [];
59	61	const say = (where: string, what: string) => problems.push(`${where}: ${what}`);
		@@ -177,6 +179,40 @@ export function check(files: {
177	179	});
178	180	if (finals === 0) say("rooms", "at least one room must be final");
179	181
	182	const classes = listOf(files.classes, "classes");
	183	ids("classes", classes);
	184	if (!classes.some((c) => isObject(c) && c.id === "knight"))
	185	say("classes", 'one class must be the "knight" fallback');
	186	classes.forEach((c, i) => {
	187	const where = `classes[${i}]`;
	188	if (!isObject(c)) return;
	189	for (const key of ["tagline", "weapon"])
	190	if (typeof c[key] !== "string" \|\| c[key] === "")
	191	say(where, `${key} is missing`);
	192	if (typeof c.ranged !== "boolean") say(where, "ranged must be true or false");
	193	need(where, c, [
	194	"hp", "speed", "damage", "swing", "cooldown",
	195	"dodgeSpeed", "dodgeTicks", "dodgeCooldown", "invuln", "revive",
	196	]);
	197	if (c.ranged === true) need(where, c, ["range", "shotSpeed"]);
	198	else need(where, c, ["reach"]);
	199	const a = c.ability;
	200	const awhere = `${where}.ability`;
	201	if (!isObject(a)) {
	202	say(where, "ability is missing");
	203	return;
	204	}
	205	for (const key of ["id", "name", "description"])
	206	if (typeof a[key] !== "string" \|\| a[key] === "")
	207	say(awhere, `${key} is missing`);
	208	if (!positive(a.cooldownTicks)) say(awhere, "cooldownTicks must be a positive number");
	209	if (!ABILITY_KINDS.includes(String(a.kind)))
	210	say(awhere, `kind must be one of ${ABILITY_KINDS.join(", ")}`);
	211	if (a.kind === "bulwark") need(awhere, a, ["duration", "knockback", "radius"]);
	212	if (a.kind === "volley") need(awhere, a, ["count", "spread"]);
	213	if (a.kind === "blink") need(awhere, a, ["distance", "invuln"]);
	214	});
	215
180	216	const paints = new Set(
181	217	tokens.filter((t) => t.name.startsWith("--color-")).map((t) => t.name.slice(8)),
182	218	);
		@@ -203,6 +239,7 @@ function load(): Game {
203	239	loot: read("loot"),
204	240	rooms: read("rooms"),
205	241	hub: read("hub"),
	242	classes: read("classes"),
206	243	};
207	244	const problems = check(files);
208	245	if (problems.length > 0) throw new Error(`content/: ${problems.join("; ")}`);
		@@ -214,6 +251,7 @@ function load(): Game {
214	251	traps: f.traps!.traps as Game["traps"],
215	252	loot: f.loot!.loot as Game["loot"],
216	253	rooms: f.rooms!.rooms as Game["rooms"],
	254	classes: f.classes!.classes as Game["classes"],
217	255	hub: { ...hub, props: f.hub!.props as Prop[] },
218	256	};
219	257	}
		@@ -46,6 +46,8 @@ export interface HeroRow {
46	46	readonly delve_id: number;
47	47	readonly author_id: string;
48	48	readonly author_name: string;
	49	/** The class from content/classes.json this chef delves as. */
	50	readonly classId: string;
49	51	seen: number;
50	52	}
51	53
		@@ -72,7 +74,7 @@ export interface DelveView {
72	74	readonly day: string;
73	75	readonly author_id: string;
74	76	readonly host_name: string;
75		readonly party: readonly { id: number; author_id: string; name: string }[];
	77	readonly party: readonly { id: number; author_id: string; name: string; classId: string }[];
76	78	readonly depth: number;
77	79	readonly rooms: number;
78	80	readonly room: string;
		@@ -86,6 +88,7 @@ export interface HeroView {
86	88	readonly delve_id: number;
87	89	readonly author_id: string;
88	90	readonly author_name: string;
	91	readonly classId: string;
89	92	}
90	93
91	94	const delves = new Map<number, Delve>();
		@@ -117,6 +120,7 @@ export const view = (d: Delve): DelveView => ({
117	120	id: h.id,
118	121	author_id: h.author_id,
119	122	name: h.author_name,
	123	classId: h.classId,
120	124	})),
121	125	depth: d.world.depth,
122	126	rooms: d.world.plan.length,
		@@ -131,6 +135,7 @@ export const heroView = (h: HeroRow): HeroView => ({
131	135	delve_id: h.delve_id,
132	136	author_id: h.author_id,
133	137	author_name: h.author_name,
	138	classId: h.classId,
134	139	});
135	140
136	141	/** Open today's dungeon for a party. `onEnd` is told once, when it is over. */
		@@ -167,16 +172,19 @@ export function enlist(
167	172	delve: Delve,
168	173	who: { id: string; name: string },
169	174	now: number,
	175	classId: string = "knight",
170	176	): HeroRow {
	177	const known = game.classes.some((c) => c.id === classId) ? classId : "knight";
171	178	const row: HeroRow = {
172	179	id: nextHero++,
173	180	delve_id: delve.id,
174	181	author_id: who.id,
175	182	author_name: who.name,
	183	classId: known,
176	184	seen: now,
177	185	};
178	186	heroes.set(row.id, row);
179		addHero(game, delve.world, row.id, who.name);
	187	addHero(game, delve.world, row.id, who.name, known);
180	188	if (!delve.crew.includes(who.name)) delve.crew.push(who.name);
181	189	send(delve);
182	190	return row;
		@@ -189,3 +189,39 @@ test("a finished delve goes on the board with its crew and ghost; an empty one d
189	189	expect(one.ok && one.value.ghost).toBe("0,15,55;0,20,55");
190	190	expect(failed(listRuns(db, anon, { day: "yesterday" }))).toBe("invalid");
191	191	});
	192
	193	test("joining names a class; the dressing room's word is law", () => {
	194	const host = chef();
	195	const opened = openDelve(db, host, { class: "mage" });
	196	if (!opened.ok) throw new Error(opened.message);
	197	const id = opened.value.id;
	198	expect(opened.value.party[0]!.classId).toBe("mage");
	199	const guest = chef();
	200	const joined = joinDelve(db, guest, { delve: id, class: "archer" });
	201	if (!joined.ok) throw new Error(joined.message);
	202	expect(joined.value.classId).toBe("archer");
	203	const table = kitchen.delveOf(id)!;
	204	expect(table.world.heroes.find((h) => h.id === joined.value.id)!.classId).toBe("archer");
	205	const party = kitchen.view(table).party;
	206	expect(party.map((h) => h.classId).sort()).toEqual(["archer", "mage"]);
	207	});
	208
	209	test("an unknown class is refused; no class means knight", () => {
	210	const host = chef();
	211	const opened = openDelve(db, host);
	212	if (!opened.ok) throw new Error(opened.message);
	213	const id = opened.value.id;
	214	expect(opened.value.party[0]!.classId).toBe("knight");
	215	const bogus = joinDelve(db, chef(), { delve: id, class: "paladin" });
	216	expect(failed(bogus)).toBe("invalid");
	217	const plain = joinDelve(db, chef(), { delve: id });
	218	if (!plain.ok) throw new Error(plain.message);
	219	expect(plain.value.classId).toBe("knight");
	220	});
	221
	222	test("an ability is an order the sim can take", () => {
	223	expect(readOrder({ type: "ability" }, { w: 10, h: 10 })).toEqual({ type: "ability" });
	224	expect(readOrder({ type: "dance" }, { w: 10, h: 10 })).toBe(
	225	"An order is move, attack, dodge, ability or stop.",
	226	);
	227	});
		@@ -30,6 +30,11 @@ const OUTCOME: Record<string, string> = {
30	30	abandoned: "Everyone left the table.",
31	31	};
32	32
	33	const className = (classId: string): string =>
	34	game.classes.find((c) => c.id === classId)?.name ?? classId;
	35	const abilityName = (classId: string): string =>
	36	game.classes.find((c) => c.id === classId)?.ability.name ?? "Ability";
	37
33	38	export function delvePage(p: DelvePage): string {
34	39	const { who, delve, hero } = p;
35	40	const path = `/delve/${delve.id}`;
		@@ -41,6 +46,7 @@ export function delvePage(p: DelvePage): string {
41	46	: `<div class="pad">
42	47	<button class="button button-big" type="button" data-act="attack">Attack</button>
43	48	<button class="button button-big button-alt" type="button" data-act="dodge">Dodge</button>
	49	<button class="button button-big" type="button" data-act="ability">${escape(abilityName(hero.classId))}</button>
44	50	</div>`;
45	51	return layout(
46	52	`<h2>${escape(delve.host_name)}'s table <small class="muted mono">${escape(delve.day)}</small></h2>
		@@ -75,6 +81,7 @@ export function delvePage(p: DelvePage): string {
75	81	<li><b>Walk</b>: click or tap the floor, or WASD / arrow keys.</li>
76	82	<li><b>Fight</b>: click a monster (your chef keeps swinging), or <kbd>Space</kbd> for the nearest.</li>
77	83	<li><b>Dodge</b>: shift-click or right-click where to roll, or <kbd>K</kbd>. Rolling dodges bites, charges, seeds and spikes.</li>
	84	<li><b>Ability</b>: <kbd>E</kbd> for your class's signature move — a knight's Bulwark, an archer's Volley, a mage's Blink.</li>
78	85	<li><b>Chests</b> open to the touch. <b>Downed?</b> A teammate standing beside you brings you back.</li>
79	86	<li>Clear a room and the door opens. Five floors, then the Pass.</li>
80	87	</ul>
		@@ -91,8 +98,12 @@ export function delvePage(p: DelvePage): string {
91	98	function party(p: DelvePage, path: string): string {
92	99	const { who, delve, hero } = p;
93	100	const names = delve.party
94		.map((h) => `<li>${escape(h.name)}${h.author_id === delve.author_id ? " <small class=\"muted\">host</small>" : ""}</li>`)
	101	.map((h) => `<li>${escape(h.name)} <small class="muted">${escape(className(h.classId))}</small>${h.author_id === delve.author_id ? " <small class=\"muted\">host</small>" : ""}</li>`)
95	102	.join("");
	103	const yours =
	104	hero === undefined
	105	? ""
	106	: `<p class="callout">You delve as the <b>${escape(className(hero.classId))}</b> — press <kbd>E</kbd> for ${escape(abilityName(hero.classId))}.</p>`;
96	107	let action = "";
97	108	if (delve.over === null) {
98	109	if (who.role === "anon")
		@@ -105,6 +116,7 @@ function party(p: DelvePage, path: string): string {
105	116	}
106	117	return `<section class="card">
107	118	<h2>At the table <small class="muted">${delve.party.length} of 4</small></h2>
	119	${yours}
108	120	${names === "" ? `<p class="muted">Nobody left.</p>` : `<ul class="list-plain">${names}</ul>`}
109	121	${action}
110	122	${delve.over === null ? `<p class="muted">Bring friends: <code class="share">${escape(publicOrigin + path)}</code></p>` : ""}
		@@ -45,6 +45,7 @@ export function hubPage(p: HubPage): string {
45	45	${controls(p)}
46	46	<div class="grid">
47	47	${tables(p)}
	48	${dressingRoom(p)}
48	49	${board(p)}
49	50	${square(p)}
50	51	${wall(p)}
		@@ -73,6 +74,7 @@ function controls(p: HubPage): string {
73	74	return `<section class="card controls">
74	75	${back}
75	76	<form method="post" action="/delves">
	77	<input type="hidden" name="class" value="knight" data-class>
76	78	<button class="button button-big">Start today's delve</button>
77	79	</form>
78	80	<form class="row wrap" method="post" action="/hub/emote" data-hub aria-label="Emotes">${emotes}</form>
		@@ -93,7 +95,7 @@ function tables(p: HubPage): string {
93	95	const join =
94	96	p.who.role === "anon" \|\| seated \|\| !d.joinable
95	97	? ""
96		: `<form method="post" action="/delves/${d.id}/join"><button class="button">Join</button></form>`;
	98	: `<form method="post" action="/delves/${d.id}/join"><input type="hidden" name="class" value="knight" data-class><button class="button">Join</button></form>`;
97	99	return `<li class="item">
98	100	<div>
99	101	<p><b>${escape(d.host_name)}'s table</b> · ${escape(roomName(d.room))}</p>
		@@ -109,6 +111,26 @@ function tables(p: HubPage): string {
109	111	</section>`;
110	112	}
111	113
	114	function dressingRoom(p: HubPage): string {
	115	if (p.who.role === "anon") return "";
	116	const cards = game.classes
	117	.map(
	118	(c, i) => `<label class="class-card">
	119	<input type="radio" name="pick-class" value="${escape(c.id)}"${i === 0 ? " checked" : ""}>
	120	<span class="class-name">${escape(c.name)}</span>
	121	<span class="muted">${escape(c.weapon)}</span>
	122	<span class="class-tag">${escape(c.tagline)}</span>
	123	<span class="muted"><b>${escape(c.ability.name)}</b> — ${escape(c.ability.description)}</span>
	124	</label>`,
	125	)
	126	.join("");
	127	return `<section class="card" id="dressing-room">
	128	<h2>Cheffry's dressing room</h2>
	129	<p class="muted">Pick tonight's class. The dungeon won't know what hit it.</p>
	130	<div class="class-pick" role="radiogroup" aria-label="Choose your class">${cards}</div>
	131	</section>`;
	132	}
	133
112	134	function board(p: HubPage): string {
113	135	const rows = p.runs
114	136	.map(