@nano133/nanoterra 0.9.0 → 0.10.0

package/dist/shop/panel/mount.d.ts

@@ -1,5 +1,6 @@
 import { type Look } from "../../looks/look.js";
 import { type SlotWords } from "./looks.js";
+import { type ShopWords } from "./words.js";
 export type ShopMountOptions = {
     /** The game's looks (looks.json as it was read). The server decides every price; these are for the list. */
     looks: unknown;
@@ -10,6 +11,16 @@ export type ShopMountOptions = {
     signedIn(): boolean;
     /** The game's sign-in: true when a player is signed in after it. With none, Buy asks the player to sign in and stops. */
     signIn?: () => Promise<boolean>;
+    /**
+     * The game's own Buy (`buy(lookId)`) asked for a sign-in, and the player closed it without signing in: the game shows its own looks sheet again.
+     * The kit's list does not open then (the kit's sheet closes if it was open). A Buy in the kit's own list goes back to that list, as before.
+     */
+    onSignInCancel?: (lookId: string, look: Look) => void;
+    /**
+     * The server refused an order with 401: the player's session ended, though `signedIn()` said yes. The game marks the player signed out. The sheet's
+     * "Sign in" key then calls `signIn()` without asking `signedIn()` first, so a stale "yes" cannot post the same refused order again.
+     */
+    onSessionEnd?: () => void;
     /** Whether the player wears this look now. */
     worn(look: Look): boolean;
     /** Wear a look the player owns. */
@@ -24,8 +35,10 @@ export type ShopMountOptions = {
     picture?: (look: Look) => HTMLElement | null;
     /** Words for the tabs of the wear slots. */
     slots?: Record<string, SlotWords>;
-    /** The sheet's title. Default "Looks". */
+    /** The sheet's title. Default: `words.title` ("Looks"). */
     title?: string;
+    /** The game's words for the two sheets, over the defaults (SHOP_WORDS): `{ buyTitle: (look) => look, sendExactly: "Pay exactly" }`. */
+    words?: Partial<ShopWords>;
     /** Draw the Looks key. Default true; false: the game calls `open()` from its own key. */
     key?: boolean;
     /** "light", "dark", or "device" (the default): the page's `data-n133-theme` when it has one, else the device's setting. */
@@ -41,7 +54,10 @@ export type MountedShop = {
     /** Opens the sheet on the looks. */
     open(): void;
     close(): void;
-    /** Opens the sheet on Buy for one look (the game's own "Buy" elsewhere). */
+    /**
+     * Opens the sheet on Buy for one look (the game's own "Buy" elsewhere), on the next frame: close the game's own <dialog> first. A sign-in closed
+     * without a sign-in calls `onSignInCancel` and opens nothing.
+     */
     buy(lookId: string): void;
     /** Draws the looks again (after the player signed in, or wore something). */
     refresh(): void;

package/dist/shop/panel/mount.js

@@ -4,15 +4,21 @@
 //   owned()      the looks the player owns (the game's GET /api/me gives them)    signedIn()  whether a player is signed in
 //   signIn()     the game's own sign-in (the kit's sign-in path, or the game's): true when the player is signed in after it. The shop draws no sign-in.
 //   worn/wear    what the player wears; `onOwned(lookId)` when a paid order gave a look (wear it)
+//   onSignInCancel(lookId)  the game's own Buy (`buy(lookId)`) asked for a sign-in and the player closed it: the game shows its own sheet again
 //
-// `key: false` draws no key: the game opens the sheet from its own key with `open()`, as the options panel allows. The sheet is a <dialog>: it rises from
-// the bottom on a phone held upright and stands in the middle on a wide screen; on a phone held sideways the pay sheet puts the QR code beside the words.
+// `key: false` draws no key: the game opens the sheet from its own key with `open()`, as the options panel allows. `buy(lookId)` starts on the next frame:
+// a game's own <dialog> that closed just before has had its `close` event by then (Chromium fires it at the frame), so its handler cannot take the focus.
+// The sheet is a <dialog>: it rises from the bottom on a phone held upright and stands in the middle on a wide screen; on a phone held sideways the pay
+// sheet puts the QR code beside the words. Phone first: text 16 px, every key 48 px or more each way.
+//
+// `words` changes any word of the two sheets (./words.ts: SHOP_WORDS are the defaults), for a game's own words or language.
 import { ApiError, createApi } from "../../admin/panel/api.js";
 import { h, releaseFocus } from "../../admin/panel/dom.js";
 import { icon } from "../../admin/panel/icons.js";
 import { checkLooks, wearOf } from "../../looks/look.js";
 import { looksView, slotsOf } from "./looks.js";
 import { payPanel } from "./pay.js";
+import { shopWords } from "./words.js";
 export function mountShop(root, options) {
     const looks = checkLooks(options.looks);
     const api = createApi(options.base ?? "/api/orders", options.fetch);
@@ -21,11 +27,13 @@ export function mountShop(root, options) {
     let stopPay = null;
     let destroyed = false;
     const cleanup = [];
+    const words = shopWords(options.words);
+    const sheetTitle = options.title ?? words.title;
     const title = h("h2", { class: "n133s-title", tabindex: "-1" });
-    const closeKey = h("button", { class: "n133s-close", type: "button", "aria-label": "Close" }, icon("close", 20));
+    const closeKey = h("button", { class: "n133s-close", type: "button", "aria-label": words.close }, icon("close", 20));
     const body = h("div", { class: "n133s-body" });
-    const dialog = h("dialog", { class: "n133s-sheet", "aria-label": options.title ?? "Looks" }, h("header", { class: "n133s-head" }, title, closeKey), body);
-    const key = options.key === false ? null : h("button", { class: "n133s-key", type: "button", "aria-haspopup": "dialog" }, icon("shirt", 20), h("span", { class: "n133s-key-word" }, options.title ?? "Looks"));
+    const dialog = h("dialog", { class: "n133s-sheet", "aria-label": sheetTitle }, h("header", { class: "n133s-head" }, title, closeKey), body);
+    const key = options.key === false ? null : h("button", { class: "n133s-key", type: "button", "aria-haspopup": "dialog" }, icon("shirt", 20), h("span", { class: "n133s-key-word" }, sheetTitle));
     const wrap = h("div", { class: "n133-shop" }, key, dialog);
     root.append(wrap);
     // The theme: the game's word, or the page's (data-n133-theme), or the device's setting.
@@ -96,7 +104,7 @@ export function mountShop(root, options) {
     function showLooks() {
         if (destroyed)
             return;
-        show(options.title ?? "Looks", looksView({
+        show(sheetTitle, looksView({
             looks,
             owned: ownedNow(),
             signedIn: options.signedIn(),
@@ -111,9 +119,10 @@ export function mountShop(root, options) {
                     showLooks();
                 }
                 : undefined,
-            buy: (l) => void buy(l),
+            buy: (l) => void buy(l, false),
             picture: options.picture,
             slots: options.slots,
+            words,
             tab,
             onTab: (s) => {
                 tab = s;
@@ -122,14 +131,18 @@ export function mountShop(root, options) {
             },
         }));
     }
-    const back = (message, extra) => h("div", { class: "n133s-message" }, h("p", { class: "n133s-status" }, message), extra ?? null, h("button", { class: "n133s-btn n133s-wide", type: "button", onclick: () => showLooks() }, "Back to looks"));
-    async function buy(look) {
+    const back = (message, extra) => h("div", { class: "n133s-message" }, h("p", { class: "n133s-status" }, message), extra ?? null, h("button", { class: "n133s-btn n133s-wide", type: "button", onclick: () => showLooks() }, words.back));
+    /**
+     * `game`: the game's own Buy started it (`buy(lookId)`), not the kit's list: a closed sign-in goes back to the game, not to the list.
+     * `ended`: the server said the session ended (401): sign in again whatever `signedIn()` says.
+     */
+    async function buy(look, game, ended = false) {
         if (destroyed)
             return;
         tab = slotsOf(looks).length > 1 ? wearOf(look) : undefined;
-        if (!options.signedIn()) {
+        if (ended || !options.signedIn()) {
             if (!options.signIn)
-                return show(`Buy ${look.name}`, back("To buy a look, sign in with Nano first: your looks belong to your Nano address."));
+                return show(words.buyTitle(look.name), back(words.signInFirst));
             let ok = false;
             try {
                 ok = await options.signIn();
@@ -137,11 +150,15 @@ export function mountShop(root, options) {
             catch {
                 ok = false;
             }
-            if (!ok || !options.signedIn())
-                return showLooks();
+            if (!ok || !options.signedIn()) {
+                if (!game)
+                    return showLooks();
+                close();
+                return options.onSignInCancel?.(look.id, look);
+            }
         }
         const box = h("div", { class: "n133s-turnstile", hidden: true });
-        show(`Buy ${look.name}`, h("div", {}, h("p", { class: "n133s-status" }, "Making your order…"), box));
+        show(words.buyTitle(look.name), h("div", {}, h("p", { class: "n133s-status" }, words.making), box));
         try {
             const turnstile = options.personCheck ? await options.personCheck(box) : null;
             const order = await api.post("", { lookId: look.id, turnstile });
@@ -150,19 +167,23 @@ export function mountShop(root, options) {
             const pay = payPanel(order, {
                 lookName: look.name,
                 check: (id) => api.post(`/${id}/check`),
-                errorText: (e) => (e instanceof ApiError ? e.message : null),
+                errorText: (e) => (e instanceof ApiError ? words.refusal(e.message, e.status) : null),
+                words,
                 onPaid: () => {
                     bought.add(look.id);
                     options.onOwned?.(look.id, look);
                 },
             });
-            show(`Buy ${look.name}`, pay.node);
+            show(words.buyTitle(look.name), pay.node);
             stopPay = pay.stop;
         }
         catch (e) {
-            const message = e instanceof ApiError ? e.message : e instanceof Error && e.message ? e.message : "The order did not start. Try again.";
-            const again = e instanceof ApiError && e.status === 401 && options.signIn ? h("button", { class: "n133s-btn n133s-primary n133s-wide", type: "button", onclick: () => void buy(look) }, "Sign in") : null;
-            show(`Buy ${look.name}`, back(message, again));
+            const message = e instanceof ApiError ? words.refusal(e.message, e.status) : e instanceof Error && e.message ? words.refusal(e.message, 0) : words.orderFailed;
+            const gone = e instanceof ApiError && e.status === 401;
+            if (gone)
+                options.onSessionEnd?.();
+            const again = gone && options.signIn ? h("button", { class: "n133s-btn n133s-primary n133s-wide", type: "button", onclick: () => void buy(look, game, true) }, words.signIn) : null;
+            show(words.buyTitle(look.name), back(message, again));
         }
     }
     return {
@@ -170,8 +191,14 @@ export function mountShop(root, options) {
         close,
         buy(lookId) {
             const look = looks.find((l) => l.id === lookId);
-            if (look)
-                void buy(look);
+            // On the next frame (rAF; a hidden page has none): a <dialog> of the game's that closed just before has had its `close` event by then.
+            if (!look)
+                return;
+            const go = () => void buy(look, true);
+            if (typeof requestAnimationFrame === "function" && !globalThis.document?.hidden)
+                requestAnimationFrame(go);
+            else
+                setTimeout(go, 0);
         },
         refresh() {
             if (isOpen() && body.querySelector(".n133s-looks-view"))

package/dist/shop/panel/pay.d.ts

@@ -1,4 +1,5 @@
 import type { PayView } from "../handler.js";
+import { type ShopWords } from "./words.js";
 export declare const PAY_TIMING: {
     readonly pollMs: 5000;
     readonly checkForMs: number;
@@ -14,6 +15,8 @@ export type PayOptions = {
     errorText?(e: unknown): string | null;
     /** The time now in ms (a test gives its own). */
     now?: () => number;
+    /** The game's words (./words.ts): the keys it leaves out keep the defaults. */
+    words?: Partial<ShopWords>;
 };
 export type PayPanel = {
     node: HTMLElement;

package/dist/shop/panel/pay.js

@@ -3,10 +3,11 @@
 //
 // TEST MODE: the server sends no address and no link, and this sheet shows a large "TEST MODE: DO NOT PAY" stamp where the QR code would be, with the
 // wallet key off. Never change that: a payment to an address that nobody holds the key for is lost for good. The sheet decides it from the ORDER (its
-// `test`, a missing `uri` or a missing `address`), never from a setting of the page.
-import { copy, h } from "../../admin/panel/dom.js";
+// `test`, a missing `uri` or a missing `address`), never from a setting of the page. The stamp's words are not among the game's words (./words.ts).
+import { h } from "../../admin/panel/dom.js";
 import { usdText } from "../../looks/look.js";
 import { qrSvg } from "./qr.js";
+import { priceLine, shopWords } from "./words.js";
 export const PAY_TIMING = { pollMs: 5000, checkForMs: 2 * 60_000 };
 /** True when this order must show the test stamp: the server said test mode, or it sent no address or no link. */
 export const isTestOrder = (o) => o.test || !o.uri || !o.address;
@@ -17,27 +18,40 @@ export function payPanel(start, options) {
     let timer;
     let clockTimer;
     let checkingUntil = 0;
-    const status = h("p", { class: "n133s-status", role: "status", "aria-live": "polite" });
-    const again = h("button", { class: "n133s-btn n133s-wide", type: "button", hidden: true }, "Check again");
-    const left = h("span", { class: "n133s-time-left" });
-    const amount = h("div", { class: "n133s-amount" }, h("strong", {}, `${order.xno} XNO`), h("span", {}, ` = ${usdText(Number(order.usd))}`));
+    const w = shopWords(options.words);
+    const test = isTestOrder(order);
+    /** The order's state. In test mode nothing is checked, so it has nothing to say and takes no room. */
+    const status = h("p", { class: "n133s-status", role: "status", "aria-live": "polite", hidden: test });
+    const again = h("button", { class: "n133s-btn n133s-wide", type: "button", hidden: true }, w.checkAgain);
+    /** The time left, live only: in test mode nothing is paid, so nothing waits for the end. */
+    const ends = h("p", { class: "n133s-fine n133s-time-left", hidden: test });
+    const amount = h("div", { class: "n133s-amount" }, test ? null : h("span", { class: "n133s-exact" }, w.sendExactly), h("strong", {}, w.amount(order.xno)), h("span", {}, w.usd(usdText(Number(order.usd)))));
+    const copyKey = (value) => {
+        const key = h("button", { class: "n133s-btn n133s-small", type: "button" }, w.copy);
+        key.addEventListener("click", async () => {
+            try {
+                await navigator.clipboard.writeText(value);
+                key.textContent = w.copied;
+            }
+            catch {
+                key.textContent = w.copyFailed;
+            }
+            setTimeout(() => (key.textContent = w.copy), 1500);
+        });
+        return key;
+    };
     let payArea;
     /** The main key (the wallet link; off in test mode): it stands in a foot that stays in view, so a phone on its side never hides it. */
     let wallet;
-    const test = isTestOrder(order);
     if (test) {
-        payArea = h("div", { class: "n133s-test-pay" }, h("div", { class: "n133s-qr n133s-qr-blocked", "aria-hidden": "true" }, h("div", { class: "n133s-qr-fake" })), h("div", { class: "n133s-stamp", role: "alert" }, h("span", {}, "TEST MODE:"), " ", h("span", {}, "DO NOT PAY")), h("p", { class: "n133s-fine" }, "This game is in test mode, so nothing can be paid here. To sell for real, the creator sets their own receive address and turns test mode off."));
-        wallet = h("button", { class: "n133s-btn n133s-primary n133s-wide", type: "button", disabled: true }, "Open wallet (off in test mode)");
+        payArea = h("div", { class: "n133s-test-pay" }, h("div", { class: "n133s-qr n133s-qr-blocked", "aria-hidden": "true" }, h("div", { class: "n133s-qr-fake" })), h("div", { class: "n133s-stamp", role: "alert" }, h("span", {}, "TEST MODE:"), " ", h("span", {}, "DO NOT PAY")), h("p", { class: "n133s-fine" }, w.testNote));
+        wallet = h("button", { class: "n133s-btn n133s-primary n133s-wide", type: "button", disabled: true }, w.walletOff);
     }
     else {
-        const copyAmount = h("button", { class: "n133s-btn n133s-small", type: "button" }, "Copy");
-        copyAmount.addEventListener("click", () => copy(order.xno, copyAmount));
-        const copyAddress = h("button", { class: "n133s-btn n133s-small", type: "button" }, "Copy");
-        copyAddress.addEventListener("click", () => copy(order.address, copyAddress));
-        payArea = h("div", { class: "n133s-live-pay" }, h("div", { class: "n133s-qr" }, qrSvg(order.uri, `QR code to pay ${order.xno} XNO`)), h("details", { class: "n133s-by-hand" }, h("summary", {}, "Enter it by hand"), h("div", { class: "n133s-row" }, h("span", { class: "n133s-label" }, "Amount"), h("code", {}, `${order.xno} XNO`), copyAmount), h("div", { class: "n133s-row" }, h("span", { class: "n133s-label" }, "To"), h("code", { class: "n133s-address" }, order.address), copyAddress), h("p", { class: "n133s-fine" }, "Send exactly this amount, with every digit. Another amount does not match this order.")));
-        wallet = h("a", { class: "n133s-btn n133s-primary n133s-wide", href: order.uri }, "Open wallet");
+        payArea = h("div", { class: "n133s-live-pay" }, h("div", { class: "n133s-qr" }, qrSvg(order.uri, w.qrLabel(order.xno))), h("details", { class: "n133s-by-hand" }, h("summary", {}, w.byHand), h("div", { class: "n133s-row" }, h("span", { class: "n133s-label" }, w.amountLabel), h("code", {}, w.amount(order.xno)), copyKey(order.xno)), h("div", { class: "n133s-row" }, h("span", { class: "n133s-label" }, w.toLabel), h("code", { class: "n133s-address" }, order.address), copyKey(order.address)), h("p", { class: "n133s-fine" }, w.byHandNote)));
+        wallet = h("a", { class: "n133s-btn n133s-primary n133s-wide", href: order.uri }, w.wallet);
     }
-    const node = h("div", { class: `n133s-pay${test ? " n133s-is-test" : ""}` }, h("div", { class: "n133s-pay-main" }, h("p", { class: "n133s-pay-what" }, `${options.lookName}: a look for your character. It changes how you look, not how you play.`), amount, payArea), h("div", { class: "n133s-pay-side" }, h("p", { class: "n133s-fine" }, "This order ends in ", left, "."), status, again, h("p", { class: "n133s-fine n133s-prices" }, `Price in XNO from ${order.prices.join(", ")}. Powered by CoinGecko.`), h("div", { class: "n133s-foot" }, wallet)));
+    const node = h("div", { class: `n133s-pay${test ? " n133s-is-test" : ""}` }, h("div", { class: "n133s-pay-main" }, h("p", { class: "n133s-pay-what" }, w.lookLine(options.lookName)), amount, payArea), h("div", { class: "n133s-pay-side" }, ends, status, again, h("p", { class: "n133s-fine n133s-prices" }, priceLine(w, order.prices)), h("div", { class: "n133s-foot" }, wallet)));
     const stop = () => {
         stopped = true;
         if (timer)
@@ -50,7 +64,7 @@ export function payPanel(start, options) {
         const ms = Math.max(0, order.expiresAt - now());
         const m = Math.floor(ms / 60_000);
         const s = Math.floor((ms % 60_000) / 1000);
-        left.textContent = `${m}:${String(s).padStart(2, "0")}`;
+        ends.textContent = w.endsIn(`${m}:${String(s).padStart(2, "0")}`);
     };
     tick();
     clockTimer = setInterval(tick, 1000);
@@ -58,7 +72,7 @@ export function payPanel(start, options) {
         order = o;
         if (o.status === "paid") {
             stop();
-            payArea.replaceChildren(h("div", { class: "n133s-paid" }, h("strong", {}, "Paid. Thank you!"), h("p", {}, `${options.lookName} is yours now.`)));
+            payArea.replaceChildren(h("div", { class: "n133s-paid" }, h("strong", {}, w.paid), h("p", {}, w.paidLine(options.lookName))));
             wallet.hidden = true;
             status.textContent = "";
             again.hidden = true;
@@ -67,13 +81,13 @@ export function payPanel(start, options) {
         }
         if (o.status === "paid_late") {
             stop();
-            status.textContent = "This payment came after the order ended. The look was not given. The creator sees it and can send it back.";
+            status.textContent = w.paidLate;
             again.hidden = true;
             return true;
         }
         if (o.status === "expired") {
             stop();
-            status.textContent = "This order ended. If you already paid, wait here: a payment sent in time still counts.";
+            status.textContent = w.expired;
             again.hidden = false;
             return false;
         }
@@ -87,15 +101,15 @@ export function payPanel(start, options) {
             if (show(o))
                 return;
             if (o.status === "open")
-                status.textContent = test ? "Test mode: the game does not wait for a payment." : "Waiting for your payment…";
+                status.textContent = test ? "" : w.waiting;
         }
         catch (e) {
-            status.textContent = options.errorText?.(e) ?? "No connection. Trying again…";
+            status.textContent = options.errorText?.(e) ?? w.noConnection;
         }
         if (now() < checkingUntil)
             timer = setTimeout(poll, PAY_TIMING.pollMs);
         else if (!stopped) {
-            status.textContent = "Still waiting. Already paid? Press Check again.";
+            status.textContent = w.stillWaiting;
             again.hidden = false;
         }
     }
@@ -107,9 +121,8 @@ export function payPanel(start, options) {
         void poll();
     }
     again.addEventListener("click", startChecking);
+    // Test mode makes no checks: nothing can be paid, so nothing is waited for.
     if (!test)
         startChecking();
-    else
-        status.textContent = "Test mode: the game does not wait for a payment.";
     return { node, stop };
 }

package/dist/shop/panel/words.d.ts

@@ -0,0 +1,89 @@
+import type { Hat } from "../../looks/look.js";
+export type ShopWords = {
+    /** The sheet's title, the Looks key's word and the sheet's name for a screen reader. The option `title` wins over it. */
+    title: string;
+    /** The close key's name for a screen reader. */
+    close: string;
+    /** The tabs' name for a screen reader. */
+    kinds: string;
+    /** The outfits' tab. */
+    outfits: string;
+    /** The tab of a wear slot of the game's own ("shovel"). The option `slots` wins over it. */
+    slotTab: (slot: string) => string;
+    /** The plain choice of a wear slot ("No shovel"). The option `slots` wins over it. */
+    slotPlain: (slot: string) => string;
+    /** The line under an outfit: what it changes (its hat, or the colour only). */
+    outfitLine: (hat: Hat | null) => string;
+    /** The line under an item of a wear slot. */
+    itemLine: (slot: string) => string;
+    /** Added to the line of a free look, and the plain choice's line. */
+    free: string;
+    /** Added to the line of a look the player owns. */
+    yours: string;
+    wear: string;
+    wearing: string;
+    /** The Buy key, with the look's price ("$0.25"). */
+    buy: (price: string) => string;
+    /** Under the list. */
+    looksNote: string;
+    /** Under the list and at Buy, while nobody is signed in. */
+    signInFirst: string;
+    /** The title of Buy and of the pay sheet. */
+    buyTitle: (look: string) => string;
+    making: string;
+    /** An order that did not start, with no words from the server. */
+    orderFailed: string;
+    /** The words of a refusal: the server's own (`text`, in English) and its HTTP status (0: no answer). Default: the server's words. */
+    refusal: (text: string, status: number) => string;
+    /** The key back to the looks. */
+    back: string;
+    /** The key that signs in again after "Sign in first." (401). */
+    signIn: string;
+    /** The line under the title. */
+    lookLine: (look: string) => string;
+    /** The amount in XNO, large ("0.25 XNO"). */
+    amount: (xno: string) => string;
+    /** The amount in dollars, beside it ("= $0.25"). */
+    usd: (usd: string) => string;
+    /** Above the amount, live only: the player must send this exact amount. */
+    sendExactly: string;
+    /** Under the stamp in test mode: nothing can be paid here. */
+    testNote: string;
+    /** The wallet key in test mode, off, with its reason. */
+    walletOff: string;
+    /** The wallet key (live). */
+    wallet: string;
+    /** The QR code's name for a screen reader. */
+    qrLabel: (xno: string) => string;
+    /** The fold with the amount and the address to type by hand. */
+    byHand: string;
+    amountLabel: string;
+    /** The address's label in the fold. */
+    toLabel: string;
+    /** In the fold: another amount does not match the order. */
+    byHandNote: string;
+    copy: string;
+    copied: string;
+    copyFailed: string;
+    /** The time left (live only): the order ends then. */
+    endsIn: (time: string) => string;
+    waiting: string;
+    noConnection: string;
+    stillWaiting: string;
+    checkAgain: string;
+    paid: string;
+    paidLine: (look: string) => string;
+    /** A payment after the order ended: it gives no look, and the creator sends it back. */
+    paidLate: string;
+    /** The order ended: a payment sent in time still counts. */
+    expired: string;
+    /** The price's sources ("CoinGecko", "Kraken", "KuCoin"). "Powered by CoinGecko" is added when CoinGecko is one and the words leave it out. */
+    prices: (sources: readonly string[]) => string;
+};
+/** CoinGecko's words: its API terms ask for them wherever its price shows. */
+export declare const COINGECKO_CREDIT = "Powered by CoinGecko";
+export declare const SHOP_WORDS: ShopWords;
+/** The game's words over the defaults. A key the game leaves out, or gives as undefined, keeps its default. */
+export declare function shopWords(over?: Partial<ShopWords>): ShopWords;
+/** The price's line: the game's words, with "Powered by CoinGecko" added when CoinGecko is a source and the words leave it out. */
+export declare function priceLine(words: ShopWords, sources: readonly string[]): string;

package/dist/shop/panel/words.js

@@ -0,0 +1,79 @@
+// Every word that the shop's sheets show: the looks sheet, Buy and the pay sheet. A game gives `words` to `mountShop` (or to `looksView` and `payPanel`)
+// with the keys it wants to change, in its own words or language; the rest stay these. A text with a value in it is a function of that value.
+//
+// Two things a game cannot change, because a player's money depends on them: the stamp "TEST MODE: DO NOT PAY" (it is not a key), and the words
+// "Powered by CoinGecko" while CoinGecko is one of the price feeds (CoinGecko's API terms ask for them: `priceLine` adds them when `prices` leaves
+// them out).
+//
+// The defaults are short on purpose (Wes, 2026-11-01: fewer words): the pay sheet shows at most 30 words, and no sentence has more than 10.
+const HATS = { cap: "with a cap", beanie: "with a beanie", crown: "with a crown", tophat: "with a top hat" };
+const spaced = (slot) => slot.replace(/-/g, " ");
+/** CoinGecko's words: its API terms ask for them wherever its price shows. */
+export const COINGECKO_CREDIT = "Powered by CoinGecko";
+export const SHOP_WORDS = {
+    title: "Looks",
+    close: "Close",
+    kinds: "Kinds of looks",
+    outfits: "Outfits",
+    slotTab: (slot) => spaced(slot.charAt(0).toUpperCase() + slot.slice(1)),
+    slotPlain: (slot) => `No ${spaced(slot)}`,
+    outfitLine: (hat) => (hat ? HATS[hat] : "colour only"),
+    itemLine: (slot) => spaced(slot),
+    free: "free",
+    yours: "yours",
+    wear: "Wear",
+    wearing: "Wearing",
+    buy: (price) => `Buy ${price}`,
+    looksNote: "Looks never change play. Pay in Nano, straight to the creator.",
+    signInFirst: "Sign in first to buy a look.",
+    buyTitle: (look) => `Buy ${look}`,
+    making: "Making your order…",
+    orderFailed: "The order did not start. Try again.",
+    refusal: (text) => text,
+    back: "Back",
+    signIn: "Sign in",
+    lookLine: () => "It never changes play.",
+    amount: (xno) => `${xno} XNO`,
+    usd: (usd) => `= ${usd}`,
+    sendExactly: "Send exactly",
+    testNote: "Nothing can be paid here.",
+    walletOff: "Wallet off: test mode",
+    wallet: "Open wallet",
+    qrLabel: (xno) => `QR code to pay ${xno} XNO`,
+    byHand: "Enter by hand",
+    amountLabel: "Amount",
+    toLabel: "To",
+    byHandNote: "Another amount does not match.",
+    copy: "Copy",
+    copied: "Copied",
+    copyFailed: "Copy failed",
+    endsIn: (time) => `Ends in ${time}.`,
+    waiting: "Waiting for payment…",
+    noConnection: "No connection. Trying again…",
+    stillWaiting: "Still waiting. Already paid? Press Check again.",
+    checkAgain: "Check again",
+    paid: "Paid. Thank you!",
+    paidLine: (look) => `${look} is yours.`,
+    paidLate: "Paid after the order ended, so no look. The creator sends it back.",
+    expired: "This order ended. Paid in time? Wait here: it still counts.",
+    prices: (sources) => {
+        const others = sources.filter((s) => s !== "CoinGecko");
+        const credit = sources.includes("CoinGecko") ? ` ${COINGECKO_CREDIT}.` : "";
+        return others.length ? `Price: ${others.join(", ")}.${credit}` : credit.trim();
+    },
+};
+/** The game's words over the defaults. A key the game leaves out, or gives as undefined, keeps its default. */
+export function shopWords(over) {
+    const out = { ...SHOP_WORDS };
+    for (const [k, v] of Object.entries(over ?? {}))
+        if (v !== undefined && k in SHOP_WORDS)
+            out[k] = v;
+    return out;
+}
+/** The price's line: the game's words, with "Powered by CoinGecko" added when CoinGecko is a source and the words leave it out. */
+export function priceLine(words, sources) {
+    const line = words.prices(sources).trim();
+    if (!sources.includes("CoinGecko") || line.includes(COINGECKO_CREDIT))
+        return line;
+    return `${line}${line ? " " : ""}${COINGECKO_CREDIT}.`;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nano133/nanoterra",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "Nanoterra for a creator's game, in one package: the player's sign-in ticket, the player's character (a toon body on the island's skeleton), the looks ladder, the admin, the friends list, an options menu, emotes, the player's sign-in (a passkey or a wallet app) and a shop that sells looks for Nano with no key on the server.",
   "type": "module",
   "main": "dist/index.js",

package/src/admin/amount.ts

@@ -12,3 +12,9 @@ export function xnoText(raw: string): string {
 
 /** A raw amount that can be added: digits only, at most 39 of them. Anything else is not counted (a bad row must not break the summary). */
 export const isRawText = (s: unknown): s is string => typeof s === "string" && /^[0-9]{1,39}$/.test(s);
+
+/** Dollars as plain decimals, as an order keeps them: at least 2 decimals and at most 4, "0.25", "1.00", "0.005", "0.0125". */
+export const usdDecimals = (usd: number): string => usd.toFixed(4).replace(/(\.\d\d\d*?)0+$/, "$1");
+
+/** "$0.25", "$1.00", "$0.005". */
+export const usdText = (usd: number): string => `$${usdDecimals(usd)}`;

package/src/admin/panel/dom.ts

@@ -1,5 +1,7 @@
 // A tiny helper to build page elements without innerHTML (safe for any text, and fine under a strict CSP). The panel runs in a browser.
 
+import { usdText } from "../amount.js";
+
 type Attrs = Record<string, string | number | boolean | undefined | ((e: Event) => void)>;
 type Child = Node | string | null | undefined | false;
 
@@ -67,5 +69,5 @@ export function ago(ms: number, now = Date.now()): string {
 /** "3 orders", "1 order" */
 export const plural = (n: number, word: string): string => `${n} ${word}${n === 1 ? "" : "s"}`;
 
-/** "$1.25" from cents. */
-export const dollars = (cents: number): string => `$${(cents / 100).toFixed(2)}`;
+/** "$1.25" from cents, "$0.005" from half a cent. */
+export const dollars = (cents: number): string => usdText(cents / 100);

package/src/admin/panel/shelf.ts

@@ -503,7 +503,7 @@ export function shelfView(first: ShelfData, looks: readonly Look[], picture: (l:
       sync();
     } });
 
-    const priceInput = h("input", { class: "input input-num", type: "number", step: 0.01, min: 0, max: 1000, inputmode: "decimal", value: Number.isFinite(l.priceUsd) ? l.priceUsd : "", "aria-label": `Price in US dollars of ${l.name}`, oninput: (e: Event) => {
+    const priceInput = h("input", { class: "input input-num", type: "number", step: 0.0001, min: 0, max: 1000, inputmode: "decimal", value: Number.isFinite(l.priceUsd) ? l.priceUsd : "", "aria-label": `Price in US dollars of ${l.name}`, oninput: (e: Event) => {
       const v = (e.target as HTMLInputElement).value;
       l.priceUsd = v === "" ? Number.NaN : Number(v);
       sync();

package/src/admin/panel/shelfData.ts

@@ -2,7 +2,7 @@
 // here comes from the game's own database (the admin summary) and from looks.json; nothing is sent anywhere.
 
 import type { LooksDiff } from "../../looks/change.js";
-import { ID_PATTERN, type Look } from "../../looks/look.js";
+import { ID_PATTERN, usdText, type Look } from "../../looks/look.js";
 
 export type ShelfOrder = { lookId: string; status: string; usd: string };
 export type ShelfPlayer = { looks: { id: string }[] };
@@ -20,8 +20,8 @@ export type LookStats = {
 
 const none = (): LookStats => ({ owners: 0, paid: 0, paidCents: 0, late: 0 });
 
-/** "0.25" is 25 cents. */
-export const centsOf = (usd: string): number => Math.round(Number(usd) * 100) || 0;
+/** "0.25" is 25 cents; "0.005" is half a cent (cents keep 2 decimals: a price has at most 4). */
+export const centsOf = (usd: string): number => Math.round(Number(usd) * 10_000) / 100 || 0;
 
 /** The stats for each look id that appears in the orders or in a player's looks. */
 export function shelfStats(orders: readonly ShelfOrder[], players: readonly ShelfPlayer[]): Map<string, LookStats> {
@@ -31,7 +31,7 @@ export function shelfStats(orders: readonly ShelfOrder[], players: readonly Shel
     if (o.status === "paid") {
       const s = of(o.lookId);
       s.paid++;
-      s.paidCents += centsOf(o.usd);
+      s.paidCents = Math.round((s.paidCents + centsOf(o.usd)) * 100) / 100;
     } else if (o.status === "paid_late") of(o.lookId).late++;
   }
   for (const p of players) for (const l of new Set(p.looks.map((x) => x.id))) of(l).owners++;
@@ -53,7 +53,7 @@ export function changeText(d: LooksDiff): string {
 /** What to say when a player's money is in a look: "3 sold, $0.75, 3 owners", or "Not sold yet". */
 export function soldText(s: LookStats | undefined): string {
   if (!s || (!s.paid && !s.owners)) return "Not sold yet";
-  return `${s.paid} sold, $${(s.paidCents / 100).toFixed(2)}, ${plural(s.owners, "owner")}`;
+  return `${s.paid} sold, ${usdText(s.paidCents / 100)}, ${plural(s.owners, "owner")}`;
 }
 
 /**
@@ -76,7 +76,7 @@ export function aiPrompt(text: string, diff: LooksDiff, owned: readonly string[]
     diff.changed.length ? `Changed: ${names(diff.changed.map((c) => c.after))}.` : "",
     "",
     `Looks that players own and that must stay in the file with the same id: ${ownedOk.length ? quote(ownedOk) : "none yet"}${odd ? ` (and ${odd} more with an id that is not a valid look id: do not remove any look)` : ""}.`,
-    `Rules: keep one free outfit (priceUsd 0, no "wear"), prices in US dollars with at most 2 decimals, never change or remove the id of a look that someone owns, never change the wear slot or the slots of a look that someone owns (a look with "wear" is an item of that slot, such as a shovel, and has no "change"; slots are words and #rrggbb colours that the game reads, at most 8 on a look), and a look never changes a score or a rule. (The file had ${before.length} looks before.)`,
+    `Rules: keep one free outfit (priceUsd 0, no "wear"), prices in US dollars with at most 4 decimals (0.005 is half a cent), never change or remove the id of a look that someone owns, never change the wear slot or the slots of a look that someone owns (a look with "wear" is an item of that slot, such as a shovel, and has no "change"; slots are words and #rrggbb colours that the game reads, at most 8 on a look), and a look never changes a score or a rule. (The file had ${before.length} looks before.)`,
     "",
     "looks.json:",
     "```json",