@indiegems/gem-web-sdk 14.0.1 → 14.0.3

package/docs/what-a-game-must-do.md

@@ -507,7 +507,7 @@ unlock_celebration: arcade
   always get the Arcade's card, whatever you declare.
 - **Only the store page on `release` is read**, and it takes effect when that page is
   promoted. It is display-only, and it needs no `schema_version` change.
-- **Gems or Tickets paid in the same moment** still go through `gem.cueReward`, with
+- **Gems or Coins paid in the same moment** still go through `gem.cueReward`, with
   no flight of your own.
 
 How your game learns an unlock happened, and the field's full rules, are in
@@ -618,7 +618,7 @@ there is no route by which the frame could request one. `createGem` forwards all
   player would mind losing there, and never hold it back for a terminate warning that may not come.
 
   **Re-read on resume.** Your game is told that it was paused and resumed, never why, and never
-  what the player did in the meantime. Their Gems and Tickets can change while you are paused, so
+  what the player did in the meantime. Their Gems and Coins can change while you are paused, so
   if your game keeps anything worked out from a balance, such as a Buy button it greyed out or a
   "not enough Gems" line, read `gem.platform.currencies.get()` again on every `onPause(false)`
   rather than trusting what it read before the pause
@@ -731,10 +731,10 @@ game, a framed or full-window game on a desktop, a tablet or a TV in native full
 
 - **The Gem button**, the Gem Arcade's gem, always there (a 44px square touch target), in
   the **top-left corner** unless your game [asks for another](#moving-the-gem-gemsetgemcorner). It
-  opens [the Arcade's menu](#the-arcades-menu): Return to the Arcade, the player's Gems, Tickets and
+  opens [the Arcade's menu](#the-arcades-menu): Return to the Arcade, the player's Gems, Coins and
   achievement score, mute, the player's Arcade-wide settings and the rest. Not your settings: those
   are [your own button](#game-settings).
-- **Nothing else.** The player's wallets (Gems, Tickets, their achievement score) are **not** drawn
+- **Nothing else.** The player's wallets (Gems, Coins, their achievement score) are **not** drawn
   over your game: the player opens the Gem menu to see them, and every platform-currency payout
   flies into the Gem button ([the Arcade's wallet](#the-arcades-wallet-in-the-gem-menu-never-drawn-by-you)).
   When the player switches the frame-rate readout on, it sits beside the gem and is reserved the
@@ -1387,7 +1387,7 @@ What it does, so you know what to expect:
 
 The Arcade keeps one button over every game, on every device: the Gem, top-left unless your game
 [asks for another corner](#moving-the-gem-gemsetgemcorner). Its menu is
-how a player leaves (**Return to the Arcade**), sees their Gems, Tickets and achievement score, mutes,
+how a player leaves (**Return to the Arcade**), sees their Gems, Coins and achievement score, mutes,
 goes fullscreen, reports a problem and changes their Arcade-wide settings — the ones that reach you as [`gem.prefs.recommended`](#game-settings). You can add up to
 four entries of your own:
 
@@ -1532,13 +1532,13 @@ and the release checklist checks that it does.
 
 ## The Arcade's wallet: in the Gem menu, never drawn by you
 
-The player's platform balances — Gems, Tickets (`ARCADE_TICKETS`) and their achievement score —
+The player's platform balances — Gems, Coins (`ARCADE_TICKETS`) and their achievement score —
 belong to the Arcade. **Your game never draws one**, and never shows a pending state for one: the
 Arcade takes every figure from the platform and shows them itself.
 
 **The Gem Arcade draws no wallet over your game** (since 2026-10-11). Nothing of it sits in your top
 row, at rest or when a balance moves. The player opens the Gem menu — the Gem button, in whichever
-corner it sits — to see their Gems, Tickets and achievement score, and every payout
+corner it sits — to see their Gems, Coins and achievement score, and every payout
 [`gem.cueReward`](inventory-and-catalogs.md#showing-the-reward-land-in-the-arcades-wallet) announces
 flies into the Gem button. A payout you do not cue flies too, from the middle of your frame, so cue
 the ones the player earns on screen and the flight starts where they are looking.
@@ -1825,7 +1825,7 @@ first:
 ### The signed-in player's Boost: show it, never gate on it
 
 `gem.player` also carries **`boost`** — the player's Boost, which the Arcade sells for real money.
-While it lasts the player earns Gems and Tickets faster (never achievement points), and the
+While it lasts the player earns Gems and Coins faster (never achievement points), and the
 platform raises their earning limits to match. The platform does all of that on its own side when
 it pays; your game does nothing to make a boost work.
 
@@ -1840,8 +1840,8 @@ backend without boosts, a read that has not landed yet — it reads as **not boo
 player who has no boost.
 
 ```js
-const tickets = gem.player?.boost.multipliers.find((m) => m.currencySlug === 'ARCADE_TICKETS');
-if (tickets && tickets.multiplier > 1) rewardScreen.showBadge(`${tickets.multiplier}× Tickets`);
+const coins = gem.player?.boost.multipliers.find((m) => m.currencySlug === 'ARCADE_TICKETS');
+if (coins && coins.multiplier > 1) rewardScreen.showBadge(`${coins.multiplier}× Coins`);
 ```
 
 ⚠️ **It is for display, and only for display** — a "2×" badge on a reward screen. Never gate

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indiegems/gem-web-sdk",
-  "version": "14.0.1",
+  "version": "14.0.3",
   "description": "postMessage bridge contract between gem-web and browser-playable games",
   "license": "UNLICENSED",
   "type": "module",

package/schema/bridge.v1.json

@@ -774,7 +774,7 @@
             "The player's Boost, FOR DISPLAY ONLY — a platform rule, not advice. A",
             "Boost is something the Arcade sells for real money: it",
             "multiplies what the player EARNS in platform currencies (Gems and",
-            "Tickets) and raises their earning limits. It never touches achievement",
+            "Coins) and raises their earning limits. It never touches achievement",
             "points.",
             "",
             "ADVISORY. It may lag: it is pushed on connect and again when the",
@@ -1678,7 +1678,7 @@
           "kind": "string",
           "maxLength": 64,
           "optional": true,
-          "$comment": "Why a ticket ended without a match: `timed_out`, `heartbeat_lapsed`, `requested`, `party_changed`, `handoff_failed`. Open, so a reason added later reaches the game."
+          "$comment": "Why a ticket ended without a match: `timed_out`, `heartbeat_lapsed`, `requested`, `party_changed`, `handoff_failed`, `no_capacity`. Open, so a reason added later reaches the game."
         },
         "roomId": {
           "kind": "string",
@@ -2737,9 +2737,9 @@
         "other, `gem.cueReward` returns false and the game does NOTHING. There is",
         "no fallback celebration: Gems display belongs to the arcade (the",
         "creator's ruling, 2026-09-24), so a game draws no Gems flight, counter or",
-        "celebration of its own. The same holds for Tickets (`ARCADE_TICKETS`):",
+        "celebration of its own. The same holds for Coins (`ARCADE_TICKETS`):",
         "`currencySlug` decides what flies and which total moves. `origin` is the",
-        "centre of the game's icon for that currency — its gem, or its ticket."
+        "centre of the game's icon for that currency — its gem, or its coin."
       ],
       "fields": {
         "currencySlug": { "kind": "string", "maxLength": 32 },
@@ -2761,7 +2761,7 @@
       "direction": "frameToParent",
       "transport": "port",
       "$comment": [
-        "Whether the arcade shows the player's platform wallets (Gems, Tickets, the",
+        "Whether the arcade shows the player's platform wallets (Gems, Coins, the",
         "achievement score) over the game right now — and, optionally, which of them.",
         "",
         "OPT-OUT. With no message at all, the parent shows EVERY wallet: a game that",
@@ -2775,7 +2775,7 @@
         "",
         "The narrowing is in force when EITHER optional field is present, and is",
         "ignored while `visible` is false. It is for a screen about one currency (a",
-        "ticket store); leaving it out is always safe. `currencies` are platform",
+        "Coins store); leaving it out is always safe. `currencies` are platform",
         "currency slugs (`GEMS`, `ARCADE_TICKETS`), matched exactly and",
         "case-sensitively against the wallets the parent draws; a slug it does not",
         "draw is ignored. `score` is its own field so it can never collide with a slug.",
@@ -3677,14 +3677,14 @@
         "  `unknown_currency` or `currency_not_in_game_payable`. Resolve it EXACTLY,",
         "  with no",
         "  alias table of your own: the retired `TICKETS` meant GEMS, and resolving",
-        "  it charged Gems to games that meant Tickets. An item may carry prices in",
+        "  it charged Gems to games that meant Coins. An item may carry prices in",
         "  more than one payable currency, so",
         "  the frame does choose which wallet pays; the prompt names that currency",
         "  and its price from platform records, which keeps the choice the player's.",
         "",
         "  A PAYABLE CURRENCY MAY BE ONE THE PLAYER BOUGHT. This shipped on the",
         "  argument that a payable currency is only ever EARNED: short of Gems or",
-        "  Tickets the answer was to go and play, and neither was sold for money.",
+        "  Coins the answer was to go and play, and neither was sold for money.",
         "  That is no longer true of Gems. The arcade's own store sells them, and",
         "  bought Gems stay payable in games (owner decision, 2026-10-06). So",
         "  where a balance came from protects",