@nano133/nanoterra 0.7.1 → 0.8.1

package/dist/admin/conformance.js

@@ -40,7 +40,7 @@ async function read(res) {
 /** A refusal carries words and a reason and nothing else: no data of the game. */
 const REFUSAL_KEYS = new Set(["error", "reason", "signedInAs"]);
 /** Words of the game's data that a refusal or an answer to a visitor must never hold. */
-const DATA_WORDS = /"orders"|"players"|"totals"|"counts"|"character"|"signin"|"friends"|"warnings"/;
+const DATA_WORDS = /"orders"|"players"|"totals"|"counts"|"character"|"signin"|"friends"|"emotes"|"warnings"/;
 export function adminConformance(host) {
     const cases = [];
     const add = (name, run) => cases.push({ name, run });
@@ -264,7 +264,7 @@ export function adminStoreConformance(make) {
     const order = (id, over) => ({ id, player: A, lookId: "mint-cap", usd: "0.25", amountRaw: rawOf(0.25), status: "paid", createdAt: NOW - 1000, expiresAt: NOW + 1000, paidAt: NOW - 500, payer: A, hash: `H${id}`, ...over });
     add("a new store has no settings of its own", async ({ store }) => {
         const s = await store.readSettings();
-        check(s.character === undefined && s.signin === undefined && s.friends === undefined, `expected no settings, got ${JSON.stringify(s)}`);
+        check(s.character === undefined && s.signin === undefined && s.friends === undefined && s.emotes === undefined, `expected no settings, got ${JSON.stringify(s)}`);
     });
     add("the friends list is kept as its own setting: each of its three words, and a patch of it leaves the other two", async ({ store }) => {
         await store.saveSettings({ signin: "none", character: "own" }, NOW);
@@ -274,6 +274,14 @@ export function adminStoreConformance(make) {
             check(s.friends === friends && s.signin === "none" && s.character === "own", `after friends ${friends}: ${JSON.stringify(s)}`);
         }
     });
+    add("the emotes switch is kept as its own setting: off and on, and a patch of it leaves the other three", async ({ store }) => {
+        await store.saveSettings({ signin: "none", character: "own", friends: "off" }, NOW);
+        for (const [i, emotes] of ["off", "on"].entries()) {
+            await store.saveSettings({ emotes }, NOW + 1 + i);
+            const s = await store.readSettings();
+            check(s.emotes === emotes && s.signin === "none" && s.character === "own" && s.friends === "off", `after emotes ${emotes}: ${JSON.stringify(s)}`);
+        }
+    });
     add("a patch saves only what it names; the next patch keeps the rest", async ({ store }) => {
         await store.saveSettings({ signin: "none" }, NOW);
         let s = await store.readSettings();
@@ -288,12 +296,12 @@ export function adminStoreConformance(make) {
     add("an empty patch writes nothing and does not fail", async ({ store }) => {
         await store.saveSettings({}, NOW);
         const s = await store.readSettings();
-        check(s.character === undefined && s.signin === undefined && s.friends === undefined, "an empty patch must save nothing");
+        check(s.character === undefined && s.signin === undefined && s.friends === undefined && s.emotes === undefined, "an empty patch must save nothing");
     });
     add("saving changes nothing but the settings: no order, no owned look, no other meta row", async (h) => {
         await h.seed({ orders: [order("1", {}), order("2", { status: "open" })], owned: [{ player: A, lookId: "mint-cap", at: NOW }], rate: { value: JSON.stringify({ usd: 1.2, sources: ["x"] }), at: NOW } });
         const before = await h.snapshot();
-        await h.store.saveSettings({ character: "own", signin: "none", friends: "off" }, NOW + 5);
+        await h.store.saveSettings({ character: "own", signin: "none", friends: "off", emotes: "off" }, NOW + 5);
         check((await h.snapshot()) === before, "the rows of the game changed after saving the settings");
     });
     add("the summary counts the orders by status, reads an open order past its expiry as expired, and totals the money", async ({ store, seed }) => {

package/dist/admin/handler.d.ts

@@ -59,5 +59,5 @@ export declare const ADMIN_LIMITS: {
     readonly gameBodyMax: 512;
 };
 export declare function createAdminHandler(options: AdminHandlerOptions): AdminHandler;
-/** The settings as the game's own routes need them (the listing file, the character, the friends list): the stored words, or the game's defaults. A fault in the store gives the defaults. */
+/** The settings as the game's own routes need them (the listing file, the character, the friends list, the emotes): the stored words, or the game's defaults. A fault in the store gives the defaults. */
 export declare function loadGameSettings(store: Pick<AdminStore, "readSettings">, defaults: GameSettings): Promise<GameState>;

package/dist/admin/handler.js

@@ -2,7 +2,7 @@
 //
 //   GET  {base}/summary   the numbers: status, orders, the looks that players own
 //   GET  {base}/game      the game switches
-//   POST {base}/game      a press: { character }, { signin } or { friends } (only the known words)
+//   POST {base}/game      a press: { character }, { signin }, { friends } or { emotes } (only the known words)
 //   POST {base}/check     the payment check, when the game gives one
 //
 // EVERY request under the base goes through `adminAccess` first, before the route is even looked up: a visitor who is not the owner gets 401 or 403
@@ -159,7 +159,7 @@ export function createAdminHandler(options) {
     }
     return { routes, basePath: options.basePath ?? "/api/admin", handle };
 }
-/** The settings as the game's own routes need them (the listing file, the character, the friends list): the stored words, or the game's defaults. A fault in the store gives the defaults. */
+/** The settings as the game's own routes need them (the listing file, the character, the friends list, the emotes): the stored words, or the game's defaults. A fault in the store gives the defaults. */
 export async function loadGameSettings(store, defaults) {
     try {
         return mergeSettings(await store.readSettings(), defaults);

package/dist/admin/index.d.ts

@@ -9,5 +9,5 @@ export type { AdminLogin, AdminOrder, AdminPlayer, AdminStatus, AdminStore, Admi
 export { ORDERS_SHOWN, moneyOf, parseRate, shapeOrders, shapePlayers, statusOf, summarize } from "./summary.js";
 export type { OrderRow } from "./summary.js";
 export { RAW_PER_XNO, xnoText } from "./amount.js";
-export { CHARACTER_NEEDS_SIGNIN, CHARACTER_SIGNIN_OFF, DEFAULT_FRIENDS, FRIENDS_CHOICES, FRIENDS_TITLE, REVIEW_LINK, REVIEW_NOTE, SWITCHES, isCharacter, isFriends, isSignin, isSigninChoice, mergeSettings, parsePatch, pressOf, signinOn, stateOf } from "./switches.js";
-export type { Character, Friends, GamePatch, GameSettings, GameState, Signin, SwitchId } from "./switches.js";
+export { CHARACTER_NEEDS_SIGNIN, CHARACTER_SIGNIN_OFF, DEFAULT_EMOTES, DEFAULT_FRIENDS, FRIENDS_CHOICES, FRIENDS_TITLE, REVIEW_LINK, REVIEW_NOTE, SWITCHES, isCharacter, isEmotes, isFriends, isSignin, isSigninChoice, mergeSettings, parsePatch, pressOf, signinOn, stateOf } from "./switches.js";
+export type { Character, Emotes, Friends, GamePatch, GameSettings, GameState, Signin, SwitchId } from "./switches.js";

package/dist/admin/index.js

@@ -11,4 +11,4 @@ export { createMemoryStore } from "./memory.js";
 export { ADMIN_LOGINS_SHOWN } from "./store.js";
 export { ORDERS_SHOWN, moneyOf, parseRate, shapeOrders, shapePlayers, statusOf, summarize } from "./summary.js";
 export { RAW_PER_XNO, xnoText } from "./amount.js";
-export { CHARACTER_NEEDS_SIGNIN, CHARACTER_SIGNIN_OFF, DEFAULT_FRIENDS, FRIENDS_CHOICES, FRIENDS_TITLE, REVIEW_LINK, REVIEW_NOTE, SWITCHES, isCharacter, isFriends, isSignin, isSigninChoice, mergeSettings, parsePatch, pressOf, signinOn, stateOf } from "./switches.js";
+export { CHARACTER_NEEDS_SIGNIN, CHARACTER_SIGNIN_OFF, DEFAULT_EMOTES, DEFAULT_FRIENDS, FRIENDS_CHOICES, FRIENDS_TITLE, REVIEW_LINK, REVIEW_NOTE, SWITCHES, isCharacter, isEmotes, isFriends, isSignin, isSigninChoice, mergeSettings, parsePatch, pressOf, signinOn, stateOf } from "./switches.js";

package/dist/admin/memory.js

@@ -14,7 +14,7 @@ export function createMemoryStore(seed = {}) {
         pendingAdminRequests: 0,
         pendingGameRequests: 0,
         async readSettings() {
-            return { character: store.rows.get("setting:character"), signin: store.rows.get("setting:signin"), friends: store.rows.get("setting:friends") };
+            return { character: store.rows.get("setting:character"), signin: store.rows.get("setting:signin"), friends: store.rows.get("setting:friends"), emotes: store.rows.get("setting:emotes") };
         },
         async saveSettings(patch) {
             if (patch.character)
@@ -23,6 +23,8 @@ export function createMemoryStore(seed = {}) {
                 store.rows.set("setting:signin", patch.signin);
             if (patch.friends)
                 store.rows.set("setting:friends", patch.friends);
+            if (patch.emotes)
+                store.rows.set("setting:emotes", patch.emotes);
             store.writes++;
         },
         async summary(now) {

package/dist/admin/panel/dom.d.ts

@@ -1,6 +1,8 @@
 type Attrs = Record<string, string | number | boolean | undefined | ((e: Event) => void)>;
 type Child = Node | string | null | undefined | false;
 export declare function h<K extends keyof HTMLElementTagNameMap>(tag: K, attrs?: Attrs, ...children: Child[]): HTMLElementTagNameMap[K];
+/** Takes the keyboard focus out of `within` (to the page), so a game's own keys reach the game again. */
+export declare function releaseFocus(within: Element): void;
 /** "nano_1abc…wxyz" */
 export declare const shortAddress: (a: string) => string;
 export declare function copy(text: string, button: HTMLButtonElement): Promise<void>;

package/dist/admin/panel/dom.js

@@ -18,6 +18,12 @@ export function h(tag, attrs = {}, ...children) {
             el.append(c);
     return el;
 }
+/** Takes the keyboard focus out of `within` (to the page), so a game's own keys reach the game again. */
+export function releaseFocus(within) {
+    const now = document.activeElement;
+    if (now instanceof HTMLElement && within.contains(now))
+        now.blur();
+}
 /** "nano_1abc…wxyz" */
 export const shortAddress = (a) => `${a.slice(0, 10)}…${a.slice(-6)}`;
 export async function copy(text, button) {

package/dist/admin/panel/gameCard.js

@@ -1,7 +1,7 @@
-// The "Game" card of /admin: two switches, "Players can play as their Nanoterra character" and "Players can sign in with Nanoterra", and one three-way
-// choice, "Friends list: Nanoterra / The game's own / Off". A press saves at once (POST {api}/game, behind the same admin guard as every admin call) and
-// the game reads the setting at run time, so the creator pushes and deploys nothing. The words are in ../switches.ts. The card changes ONLY these three
-// settings: never a look, a price or an order.
+// The "Game" card of /admin: two switches, "Players can play as their Nanoterra character" and "Players can sign in with Nanoterra", one three-way
+// choice, "Friends list: Nanoterra / The game's own / Off", and the switch "Allow Nanoterra emotes". A press saves at once (POST {api}/game, behind the
+// same admin guard as every admin call) and the game reads the setting at run time, so the creator pushes and deploys nothing. The words are in
+// ../switches.ts. The card changes ONLY these four settings: never a look, a price or an order.
 import { CHARACTER_NEEDS_SIGNIN, CHARACTER_SIGNIN_OFF, FRIENDS_CHOICES, FRIENDS_TITLE, REVIEW_LINK, REVIEW_NOTE, SWITCHES, pressOf, signinOn, stateOf } from "../switches.js";
 import { ApiError } from "./api.js";
 import { h } from "./dom.js";
@@ -15,7 +15,7 @@ export function gameCard(api, initial, defaultsFile = "the game's own settings",
     /** Under the character switch: it works only through sign-in, so it says so, and says what a player gets while sign-in is Off. */
     const needs = h("p", { class: "fine switch-needs" });
     const card = h("section", { class: "admin-card game-card", "aria-labelledby": "game-title" }, h("div", { class: "card-head" }, h("h2", { id: "game-title" }, "Game")));
-    card.append(h("p", { class: "fine card-intro" }, `Three choices about your game. A press saves at once: you push nothing and deploy nothing. They start from ${defaultsFile}, and a press here wins.`));
+    card.append(h("p", { class: "fine card-intro" }, `Four choices about your game. A press saves at once: you push nothing and deploy nothing. They start from ${defaultsFile}, and a press here wins.`));
     /** The friends choice: a radio group of three keys (arrow keys move between them, as a radio group does). */
     const friendsKeys = new Map();
     const friendsNote = h("p", { class: "switch-note", id: "switch-friends-note" });
@@ -75,7 +75,8 @@ export function gameCard(api, initial, defaultsFile = "the game's own settings",
             row.button.disabled = false;
         }
     };
-    for (const id of ["character", "signin"]) {
+    /** A switch's row: its title, the On/Off key, the sentence for its state and the save status. */
+    const switchRow = (id) => {
         const label = h("span", { class: "switch-title", id: `switch-${id}-label` }, SWITCHES[id].title);
         const button = h("button", { class: "switch", type: "button", role: "switch", "aria-checked": "false", "aria-labelledby": `switch-${id}-label`, "aria-describedby": `switch-${id}-note` }, h("span", { class: "switch-word" }, "Off"), h("span", { class: "switch-knob", "aria-hidden": "true" }));
         const sentence = h("p", { class: "switch-note", id: `switch-${id}-note` });
@@ -83,10 +84,11 @@ export function gameCard(api, initial, defaultsFile = "the game's own settings",
         button.addEventListener("click", () => void press(id));
         rows.set(id, { button, sentence, status });
         card.append(h("div", { class: "switch-row" }, h("div", { class: "switch-head" }, label, button), sentence, id === "character" ? needs : null, status));
-        // The sign-in word is part of the listing file: Nanoterra's review decides what Nanoterra shows. This page cannot see that review.
-        if (id === "signin")
-            card.append(h("p", { class: "fine switch-review" }, REVIEW_NOTE, " ", h("a", { href: REVIEW_LINK, target: "_blank", rel: "noopener noreferrer" }, "Open the launch page")));
-    }
+    };
+    switchRow("character");
+    switchRow("signin");
+    // The sign-in word is part of the listing file: Nanoterra's review decides what Nanoterra shows. This page cannot see that review.
+    card.append(h("p", { class: "fine switch-review" }, REVIEW_NOTE, " ", h("a", { href: REVIEW_LINK, target: "_blank", rel: "noopener noreferrer" }, "Open the launch page")));
     const order = Object.keys(FRIENDS_CHOICES);
     const group = h("div", { class: "seg friends-choice", role: "radiogroup", "aria-labelledby": "switch-friends-label", "aria-describedby": "switch-friends-note" });
     for (const id of order) {
@@ -105,6 +107,7 @@ export function gameCard(api, initial, defaultsFile = "the game's own settings",
         group.append(key);
     }
     card.append(h("div", { class: "switch-row friends-row" }, h("div", { class: "switch-head" }, h("span", { class: "switch-title", id: "switch-friends-label" }, FRIENDS_TITLE), group), friendsNote, friendsStatus));
+    switchRow("emotes");
     draw();
     return card;
 }

package/dist/admin/panel/icons.d.ts

@@ -129,9 +129,26 @@ declare const SHAPES: {
         d: string;
         fill: string;
     }])[];
+    gear: ([string, {
+        d: string;
+    }] | [string, {
+        cx: number;
+        cy: number;
+        r: number;
+    }])[];
     sparkle: [string, {
         d: string;
     }][];
+    smile: ([string, {
+        cx: number;
+        cy: number;
+        r: number;
+    }] | [string, {
+        d: string;
+    }] | [string, {
+        d: string;
+        "stroke-width": number;
+    }])[];
 };
 export type IconName = keyof typeof SHAPES;
 /** An icon of `size` CSS pixels (default 20). */

package/dist/admin/panel/icons.js

@@ -27,7 +27,10 @@ const SHAPES = {
     sun: [["circle", { cx: 12, cy: 12, r: 4 }], ["path", { d: "M12 2.5v2.2M12 19.3v2.2M2.5 12h2.2M19.3 12h2.2M5.3 5.3l1.6 1.6M17.1 17.1l1.6 1.6M5.3 18.7l1.6-1.6M17.1 6.9l1.6-1.6" }]],
     moon: [["path", { d: "M20 14.5A8.5 8.5 0 1 1 9.5 4a6.8 6.8 0 0 0 10.5 10.5Z" }]],
     device: [["circle", { cx: 12, cy: 12, r: 8.5 }], ["path", { d: "M12 3.5a8.5 8.5 0 0 1 0 17Z", fill: "currentColor" }]],
+    // A gear of 8 teeth (the options key): the settings icon above reads as a sun at 20 px.
+    gear: [["path", { d: "M19.23 9.65 21.77 9.86V14.14L19.23 14.35 18.77 15.45 20.42 17.39 17.39 20.42 15.45 18.77 14.35 19.23 14.14 21.77H9.86L9.65 19.23 8.55 18.77 6.61 20.42 3.58 17.39 5.23 15.45 4.77 14.35 2.23 14.14V9.86L4.77 9.65 5.23 8.55 3.58 6.61 6.61 3.58 8.55 5.23 9.65 4.77 9.86 2.23H14.14L14.35 4.77 15.45 5.23 17.39 3.58 20.42 6.61 18.77 8.55Z" }], ["circle", { cx: 12, cy: 12, r: 3.2 }]],
     sparkle: [["path", { d: "M12 3v4M12 17v4M3 12h4M17 12h4M6 6l2.5 2.5M15.5 15.5 18 18M6 18l2.5-2.5M15.5 8.5 18 6" }]],
+    smile: [["circle", { cx: 12, cy: 12, r: 9 }], ["path", { d: "M8.2 14.2a4.6 4.6 0 0 0 7.6 0" }], ["path", { d: "M9 9.6h.01M15 9.6h.01", "stroke-width": 2.6 }]],
 };
 /** An icon of `size` CSS pixels (default 20). */
 export function icon(name, size = 20) {

package/dist/admin/panel/overview.js

@@ -31,7 +31,7 @@ export function overviewView(looks, colourOf, go) {
     const el = h("div", { class: "overview" }, main, side);
     const linkKey = (words, to) => h("button", { class: "btn btn-small btn-quiet link-key", type: "button", onclick: to }, words, h("span", { "aria-hidden": "true" }, "→"));
     function drawGame() {
-        const rows = ["character", "signin"].map((id) => {
+        const rows = ["character", "signin", "emotes"].map((id) => {
             const on = game ? stateOf(id, game) : null;
             return h("li", {}, h("span", {}, SWITCHES[id].title), on === null ? h("span", { class: "pill" }, "Unknown") : h("span", { class: `pill ${on ? "pill-on" : "pill-off"}` }, on ? "On" : "Off"));
         });

package/dist/admin/store.d.ts

@@ -71,7 +71,7 @@ export type AdminLogin = {
 /** How many sign-ins the panel lists. */
 export declare const ADMIN_LOGINS_SHOWN = 10;
 /**
- * The game's database, as the handler needs it. An adapter writes ONLY what these calls say: the three settings and, when the game turns it on, the deletion of the admin sessions
+ * The game's database, as the handler needs it. An adapter writes ONLY what these calls say: the four settings and, when the game turns it on, the deletion of the admin sessions
  * (`signOutEverywhere`). Nothing else.
  * (There is no call that writes a look, a price or an order: the Shelf gives text to copy, and a change of looks is a change of the repository.)
  */
@@ -81,6 +81,7 @@ export interface AdminStore {
         character?: unknown;
         signin?: unknown;
         friends?: unknown;
+        emotes?: unknown;
     }>;
     /** Saves a checked patch: all of it or none of it. */
     saveSettings(patch: GamePatch, now: number): Promise<void>;

package/dist/admin/switches.d.ts

@@ -7,35 +7,44 @@ export type Signin = "exchange" | "ticket" | "none";
  * A three-way choice, not an On/Off switch.
  */
 export type Friends = "nanoterra" | "own" | "off";
-/** The game's own words for the switches. `friends` may be left out: it is "nanoterra" then (on by default). */
+/** Whether the game shows Nanoterra's emotes ("@nano133/nanoterra/emotes"): the wheel's Nanoterra emotes and the other players' on their characters. Off leaves the game's own emotes. */
+export type Emotes = "on" | "off";
+/** The game's own words for the switches. `friends` and `emotes` may be left out: "nanoterra" and "on" then (on by default). */
 export type GameSettings = {
     character: Character;
     signin: Signin;
     friends?: Friends;
+    emotes?: Emotes;
 };
 /** What a press can set: sign-in is on ("exchange": a game with a server) or off ("none"). */
 export type GamePatch = {
     character?: Character;
     signin?: "exchange" | "none";
     friends?: Friends;
+    emotes?: Emotes;
 };
 /** The settings as they are now, and which ones /admin has set (the others still have the game's default). */
 export type GameState = {
     character: Character;
     signin: Signin;
     friends: Friends;
+    emotes: Emotes;
     fromAdmin: {
         character: boolean;
         signin: boolean;
         friends: boolean;
+        emotes: boolean;
     };
 };
 export declare const isCharacter: (v: unknown) => v is Character;
 export declare const isSigninChoice: (v: unknown) => v is "exchange" | "none";
 export declare const isSignin: (v: unknown) => v is Signin;
 export declare const isFriends: (v: unknown) => v is Friends;
+export declare const isEmotes: (v: unknown) => v is Emotes;
 /** The friends list a game shows while neither its own words nor /admin say: Nanoterra's. */
 export declare const DEFAULT_FRIENDS: Friends;
+/** Nanoterra's emotes are on while neither the game's own words nor /admin say. */
+export declare const DEFAULT_EMOTES: Emotes;
 /** The sign-in switch is on for any way but "none". */
 export declare const signinOn: (s: Signin) => boolean;
 /** A request body for a press: only the two known words, at least one. Anything else is refused, with the reason in words. */
@@ -51,6 +60,7 @@ export declare function mergeSettings(stored: {
     character?: unknown;
     signin?: unknown;
     friends?: unknown;
+    emotes?: unknown;
 }, defaults: GameSettings): GameState;
 /** The friends choice of the card: its title, and for each choice its short name (the card's three keys) and one plain sentence. Nanoterra's is the default. */
 export declare const FRIENDS_TITLE = "Friends list";
@@ -59,7 +69,7 @@ export declare const FRIENDS_CHOICES: Record<Friends, {
     note: string;
 }>;
 /** One switch of the card: its title, and one plain sentence for each state. */
-export type SwitchId = "character" | "signin";
+export type SwitchId = "character" | "signin" | "emotes";
 export declare const SWITCHES: Record<SwitchId, {
     title: string;
     on: string;
@@ -77,4 +87,4 @@ export declare const REVIEW_NOTE = "Your choice is saved here at once. The sign-
 export declare const REVIEW_LINK = "https://nano133.com/build/nanoterra/launch";
 /** The state of a switch from the settings, and the patch that a press sends (the other state). */
 export declare const stateOf: (id: SwitchId, s: GameSettings) => boolean;
-export declare const pressOf: (id: SwitchId, s: GameSettings) => GamePatch;
+export declare function pressOf(id: SwitchId, s: GameSettings): GamePatch;

package/dist/admin/switches.js

@@ -1,17 +1,20 @@
 // The switches of the "Game" card in /admin, and the words that say what each does. The handler checks a press with `parsePatch`; the panel
-// draws the card from `SWITCHES` and `FRIENDS_CHOICES`. A switch changes ONLY these three settings; never a look, a price or an order.
+// draws the card from `SWITCHES` and `FRIENDS_CHOICES`. A switch changes ONLY these four settings; never a look, a price or an order.
 export const isCharacter = (v) => v === "nanoterra" || v === "own";
 export const isSigninChoice = (v) => v === "exchange" || v === "none";
 export const isSignin = (v) => v === "exchange" || v === "ticket" || v === "none";
 export const isFriends = (v) => v === "nanoterra" || v === "own" || v === "off";
+export const isEmotes = (v) => v === "on" || v === "off";
 /** The friends list a game shows while neither its own words nor /admin say: Nanoterra's. */
 export const DEFAULT_FRIENDS = "nanoterra";
+/** Nanoterra's emotes are on while neither the game's own words nor /admin say. */
+export const DEFAULT_EMOTES = "on";
 /** The sign-in switch is on for any way but "none". */
 export const signinOn = (s) => s !== "none";
 /** A request body for a press: only the two known words, at least one. Anything else is refused, with the reason in words. */
 export function parsePatch(body) {
     if (!body || typeof body !== "object" || Array.isArray(body))
-        return { ok: false, error: 'Send an object with "character", "signin" or "friends".' };
+        return { ok: false, error: 'Send an object with "character", "signin", "friends" or "emotes".' };
     const patch = {};
     for (const [key, value] of Object.entries(body)) {
         if (key === "character" && isCharacter(value))
@@ -20,8 +23,12 @@ export function parsePatch(body) {
             patch.signin = value;
         else if (key === "friends" && isFriends(value))
             patch.friends = value;
+        else if (key === "emotes" && isEmotes(value))
+            patch.emotes = value;
         else if (key === "friends")
             return { ok: false, error: '"friends" must be "nanoterra", "own" or "off".' };
+        else if (key === "emotes")
+            return { ok: false, error: '"emotes" must be "on" or "off".' };
         else if (key === "character")
             return { ok: false, error: '"character" must be "nanoterra" or "own".' };
         else if (key === "signin")
@@ -30,7 +37,7 @@ export function parsePatch(body) {
             return { ok: false, error: `"${key}" is not a game switch.` };
     }
     if (!Object.keys(patch).length)
-        return { ok: false, error: 'Send "character", "signin" or "friends".' };
+        return { ok: false, error: 'Send "character", "signin", "friends" or "emotes".' };
     return { ok: true, patch };
 }
 /** The settings from what the store kept and the game's defaults. A stored value that is not one of the known words is ignored. */
@@ -39,7 +46,8 @@ export function mergeSettings(stored, defaults) {
         character: isCharacter(stored.character) ? stored.character : defaults.character,
         signin: isSigninChoice(stored.signin) ? stored.signin : defaults.signin,
         friends: isFriends(stored.friends) ? stored.friends : isFriends(defaults.friends) ? defaults.friends : DEFAULT_FRIENDS,
-        fromAdmin: { character: isCharacter(stored.character), signin: isSigninChoice(stored.signin), friends: isFriends(stored.friends) },
+        emotes: isEmotes(stored.emotes) ? stored.emotes : isEmotes(defaults.emotes) ? defaults.emotes : DEFAULT_EMOTES,
+        fromAdmin: { character: isCharacter(stored.character), signin: isSigninChoice(stored.signin), friends: isFriends(stored.friends), emotes: isEmotes(stored.emotes) },
     };
 }
 /** The friends choice of the card: its title, and for each choice its short name (the card's three keys) and one plain sentence. Nanoterra's is the default. */
@@ -66,6 +74,11 @@ export const SWITCHES = {
         on: "On: this game's listing file says players can sign in with Nanoterra, and the game accepts that sign-in.",
         off: "Off: the listing file says no sign-in, and the game refuses it: a link made before still signs nobody in.",
     },
+    emotes: {
+        title: "Allow Nanoterra emotes",
+        on: "On: players can play Nanoterra's emotes (Wave, Dance, Sit and more) from the Emotes wheel, and see the other players' emotes.",
+        off: "Off: the game shows no Nanoterra emote. The game's own emotes, if it has any, stay on the wheel.",
+    },
 };
 /**
  * The character comes through the sign-in: only a player who signs in from Nanoterra brings one. So the character switch is shown with its dependency. With sign-in Off the
@@ -78,5 +91,11 @@ export const CHARACTER_SIGNIN_OFF = "Sign-in from Nanoterra is Off, so every pla
 export const REVIEW_NOTE = "Your choice is saved here at once. The sign-in word is part of your listing file, and Nanoterra's review decides what Nanoterra shows for a game that is listed. This page cannot see that review. Check it on Nanoterra's launch page (step 6).";
 export const REVIEW_LINK = "https://nano133.com/build/nanoterra/launch";
 /** The state of a switch from the settings, and the patch that a press sends (the other state). */
-export const stateOf = (id, s) => (id === "character" ? s.character === "nanoterra" : signinOn(s.signin));
-export const pressOf = (id, s) => (id === "character" ? { character: s.character === "nanoterra" ? "own" : "nanoterra" } : { signin: signinOn(s.signin) ? "none" : "exchange" });
+export const stateOf = (id, s) => (id === "character" ? s.character === "nanoterra" : id === "emotes" ? (s.emotes ?? DEFAULT_EMOTES) === "on" : signinOn(s.signin));
+export function pressOf(id, s) {
+    if (id === "character")
+        return { character: s.character === "nanoterra" ? "own" : "nanoterra" };
+    if (id === "emotes")
+        return { emotes: stateOf("emotes", s) ? "off" : "on" };
+    return { signin: signinOn(s.signin) ? "none" : "exchange" };
+}

package/dist/character/create.js

@@ -2,6 +2,7 @@ import * as THREE from "three";
 import { assemble } from "./assemble.js";
 import { BASE_SPECS } from "./bases/index.js";
 import { HEIGHTS } from "./lists.js";
+import { poseLayerOf } from "./layer.js";
 import { assertLook, recordProblem } from "./look.js";
 import { buildWith, paintCharacter } from "./make.js";
 import { makePose, MAX_DT } from "./pose.js";
@@ -136,7 +137,7 @@ export function createCharacter(options = {}) {
             r.made.hull.dispose();
         r.a.skeleton.dispose();
     };
-    return {
+    const self = {
         object,
         get record() {
             return frozen(record);
@@ -159,7 +160,9 @@ export function createCharacter(options = {}) {
                 return;
             time += step;
             rig.pose.step(step, motion ?? {}, reducedMotion);
-            // The body's own moving parts (a tail, wings, long hair) follow what the pose did.
+            // A layer over the pose (an emote: layer.ts), then the body's own moving parts (a tail, wings, long hair) follow what the pose did.
+            const state = rig.pose.state;
+            poseLayerOf(self)?.(rig.a.bones, { dt: step, speed: state.speed, airborne: state.air, reducedMotion });
             rig.a.mover?.(step, time, rig.pose.state.speed, reducedMotion);
         },
         wave() {
@@ -228,4 +231,5 @@ export function createCharacter(options = {}) {
             ramp.dispose();
         },
     };
+    return self;
 }

package/dist/character/layer.d.ts

@@ -0,0 +1,14 @@
+import type * as THREE from "three";
+import type { BoneName } from "./skeleton.js";
+/** What the pose did this frame: the step it took (s), its eased speed (m/s), whether it is in the air, and the reduced-motion setting. */
+export type PoseFrame = {
+    dt: number;
+    speed: number;
+    airborne: boolean;
+    reducedMotion: boolean;
+};
+export type PoseLayer = (bones: Readonly<Record<BoneName, THREE.Bone>>, frame: PoseFrame) => void;
+/** Gives a character its layer (null takes it off). */
+export declare function setPoseLayer(character: object, layer: PoseLayer | null): void;
+/** The character's layer, if it has one. */
+export declare const poseLayerOf: (character: object) => PoseLayer | undefined;

package/dist/character/layer.js

@@ -0,0 +1,10 @@
+const layers = new WeakMap();
+/** Gives a character its layer (null takes it off). */
+export function setPoseLayer(character, layer) {
+    if (layer)
+        layers.set(character, layer);
+    else
+        layers.delete(character);
+}
+/** The character's layer, if it has one. */
+export const poseLayerOf = (character) => layers.get(character);

package/dist/emotes/clip.d.ts

@@ -0,0 +1,79 @@
+import * as THREE from "three";
+/** One clip as the file holds it: whole numbers, each bone's first frame then each frame's change (`q`: the bone's index, then 4 numbers a frame). */
+export type RawClip = {
+    n: number;
+    loop: boolean;
+    from?: number;
+    kind: "full" | "upper";
+    hold: number;
+    label: string;
+    q: number[][];
+    p?: number[];
+};
+export type RawClips = {
+    v: number;
+    fps: number;
+    bones: string[];
+    clips: Record<string, RawClip>;
+};
+export type Clip = {
+    /** Frames (a loop's last frame is its first, so it is not among them). */
+    n: number;
+    loop: boolean;
+    /** The frame a loop goes back to (0: the whole clip loops; more: an opening that plays once, then the loop). */
+    from: number;
+    kind: "full" | "upper";
+    hold: number;
+    /** A one-shot's length in seconds. */
+    seconds: number;
+    turns: {
+        bone: string;
+        q: Float32Array;
+    }[];
+    /** The hips' place from their rest place, three numbers a frame (or one place), or null. */
+    hips: Float32Array | null;
+};
+/** Fades, in seconds: in at the start, out at a one-shot's end, and out when a move stops it. */
+export declare const FADE_IN = 0.12;
+export declare const FADE_END = 0.22;
+export declare const FADE_STOP = 0.18;
+/**
+ * Loads the clips, once (about 84 kB, 19 kB gzipped). Call it when the wheel first opens; a clip that plays before calls it too, and starts when they
+ * arrive. A failed load (the network) may be tried again.
+ */
+export declare function loadEmotes(): Promise<void>;
+/** True once the clips are loaded. */
+export declare const emotesLoaded: () => boolean;
+/** A loaded clip by its id, or null. */
+export declare const emoteClip: (id: string) => Clip | null;
+export declare function decodeClips(raw: RawClips): Map<string, Clip>;
+/** What one character keeps between frames: the clip on show, its age (s), when a move or `stop` stopped it (its age then, or -1), and why it ended. */
+export type ClipRun = {
+    id: string | null;
+    age: number;
+    stopAge: number;
+    stopWhy: "move" | "stop";
+    waiting: boolean;
+    ended: "end" | "move" | "stop" | null;
+};
+export declare const newRun: () => ClipRun;
+/**
+ * Starts a clip on a run, `age` seconds in (a remote player's emote that began a little before). A loop already on show, and not stopping, goes on
+ * through its own repeat: a player's loop is sent again for those who come later.
+ */
+export declare function startClip(run: ClipRun, id: string, age?: number): void;
+/** Stops the clip on show with its fade (`stop` from the game). */
+export declare function stopClip(run: ClipRun): void;
+export type ClipFrame = {
+    /** The step (s). */
+    dt: number;
+    moving: boolean;
+    air: boolean;
+    swim: boolean;
+    calm: boolean;
+};
+/**
+ * One frame of the clip on a character: `bones` by name, already posed by the solver. Returns whether the clip showed. When it ends (its end, a move,
+ * the water or `stopClip`), `run.id` goes back to null and `run.ended` says why.
+ */
+export declare function stepClip(run: ClipRun, bones: Readonly<Record<string, THREE.Bone>>, o: ClipFrame): boolean;