@indiegems/gem-web-sdk 15.2.0 → 15.3.1

package/docs/inventory-and-catalogs.md

@@ -551,8 +551,8 @@ nobody else can touch them. The arcade also has currencies that span every game,
 That changes what a shop can be. A player earns in someone else's game and spends in yours.
 
 There are two such currencies, and they are not interchangeable: **Gems** (`GEMS`) buy progress and
-**Coins** (`ARCADE_TICKETS`) buy cosmetics only. [arcade-economy.md](arcade-economy.md) says which
-to use for what.
+**Coins** (`ARCADE_TICKETS`) buy cosmetics, and play items too where Coins' spend scope allows.
+[arcade-economy.md](arcade-economy.md) says which to use for what.
 
 ### Awarding one
 
@@ -829,14 +829,15 @@ that looks like the arcade's purchase sheet or wallet. A game screen shaped like
 chrome is an imitation of it. Your Buy button is yours; asking a player to add currency or pay is
 the arcade's alone.
 
-### Coins buy cosmetics; Gems buy anything
+### What Coins and Gems may buy: the spend scope
 
 The arcade has two currencies a player spends: **Gems**, for progress, and **Coins**
-(`ARCADE_TICKETS`), for cosmetics. The platform holds that line with two settings: each platform
-currency's **spend scope**, which the platform sets, and each of your items' **category**, which you
-set.
+(`ARCADE_TICKETS`), earned by play, for cosmetics and, since 25 Oct 2026, play items too. What
+each may price is decided by two settings: each platform currency's **spend scope**, which the
+platform sets, and each of your items' **category**, which you set.
 
-- A currency whose spend scope is **`cosmetic_only`** may price cosmetics only. Coins' is.
+- A currency whose spend scope is **`cosmetic_only`** may price cosmetics only. Coins' is, until
+  the platform moves it to `any` to let Coins price play items.
 - A currency whose spend scope is **`any`** may price anything. Gems' is.
 
 The platform owns each currency's scope and can change it, so do not hard-code which is which: a
@@ -884,7 +885,8 @@ purchase catalog stops listing that currency's price on anything the scope does
 purchase naming such a price is refused `not_purchasable` before anything is charged.
 
 The category is a declaration the platform takes at your word, and the release review checks it.
-Labelling something that affects play `cosmetic` so it can be sold for Coins breaks platform policy.
+Labelling something that affects play `cosmetic` so it can be sold for Coins breaks platform policy,
+whatever the scope: a play item sold for Coins keeps `category: progression`.
 
 **To sell a cosmetic that needs game progress first, sell it through a recipe.** An item's own
 `platform_prices` cannot carry prerequisites; a recipe's can. Grant the cosmetic from a recipe that

package/docs/manifest.json

@@ -23,8 +23,8 @@
     },
     {
       "file": "arcade-economy.md",
-      "sha256": "2a73e2cb4e82de78a9d57c614da67bfd6a79537163deca551c5beeb8e9693c56",
-      "updated": "2026-10-21T19:36:16Z"
+      "sha256": "1ebae3aeff2480722b09bc15d8a997656238133e757c9588a0eaa9479b990270",
+      "updated": "2026-10-25T19:46:22Z"
     },
     {
       "file": "async-opponents.md",
@@ -33,13 +33,13 @@
     },
     {
       "file": "brand-art.md",
-      "sha256": "151ece62736136e0acd5c4e3e2dd7e33eb6936923c89340670844452d34acf02",
-      "updated": "2026-10-21T19:36:16Z"
+      "sha256": "6d51ae596f6b43fb79058412ab8b10922829dd4e37631ca42f9063d5f43b5029",
+      "updated": "2026-10-25T16:18:07Z"
     },
     {
       "file": "changelog.md",
-      "sha256": "217ded43a6673898df38afa5bec79eb36699ced76bf66f95ccdb0339bd5ee10c",
-      "updated": "2026-10-23T12:36:30Z"
+      "sha256": "2d316c2f527103a2d909128ae35dbde2f5d884ab9d8439bb0451a598552c23e0",
+      "updated": "2026-10-26T11:09:11Z"
     },
     {
       "file": "daily-challenges.md",
@@ -63,18 +63,18 @@
     },
     {
       "file": "game-economy-tutorial.md",
-      "sha256": "5f921001150ea47a92d97e943282988826ea27506107c71846e5ff79f0d26f15",
-      "updated": "2026-10-21T19:36:16Z"
+      "sha256": "c037a74f206f094392f09e0f7b292271145a4d72b631b93f878705171e52475a",
+      "updated": "2026-10-25T19:46:22Z"
     },
     {
       "file": "getting-started.md",
-      "sha256": "bf26d4cd2aa5af0f43948676ba00e301f36bcbcb41af36f55f667f5daff3fd40",
-      "updated": "2026-10-23T12:36:30Z"
+      "sha256": "fd19aa41161ecbfa31aadcf5737bebc50b8c4eaa1686ec50cd4252c224ccbf2a",
+      "updated": "2026-10-26T11:09:11Z"
     },
     {
       "file": "inventory-and-catalogs.md",
-      "sha256": "e3968af5f3af88122db84ac372afd82e39c04c98cf6661f83e429243837ee6ff",
-      "updated": "2026-10-21T19:36:16Z"
+      "sha256": "4295b4a12770584a80d94a94d95e464553569d7318229413cdfbb604b6e1f9d8",
+      "updated": "2026-10-25T19:46:22Z"
     },
     {
       "file": "leaderboards.md",
@@ -128,8 +128,8 @@
     },
     {
       "file": "server-bundles.md",
-      "sha256": "29eb70141c2647bc2396ab28b7ff5a77b81a698b35a41d1b7ba28e0bcd6a4c4f",
-      "updated": "2026-10-23T12:36:30Z"
+      "sha256": "57dcaa21a1f9f00910c20bdf0d3aa92500e1f829fffd40ab8477706cf2d107d8",
+      "updated": "2026-10-26T11:09:11Z"
     },
     {
       "file": "serverless-functions-js.md",
@@ -153,8 +153,8 @@
     },
     {
       "file": "what-a-game-must-do.md",
-      "sha256": "adf491ea310b7e76516d542a7a1be6efdf5537ef2f54e34ad37c678cfd884678",
-      "updated": "2026-10-23T12:10:37Z"
+      "sha256": "c449db410f2d7d9b1c7cfb305754103a1f4f03fb62781d9a1dc1e7dfb3fa459c",
+      "updated": "2026-10-23T22:49:46Z"
     }
   ]
 }

package/docs/server-bundles.md

@@ -80,8 +80,8 @@ To check the download yourself: the package npm serves is, byte for byte, the fi
 also publishes on its download host, with the hash beside it:
 
 ```bash
-curl -fsSL -O https://downloads.gemarcade.com/sdk/v15.2.0/gem-web-sdk.tgz
-curl -fsSL https://downloads.gemarcade.com/sdk/v15.2.0/gem-web-sdk.tgz.sri
+curl -fsSL -O https://downloads.gemarcade.com/sdk/v15.3.1/gem-web-sdk.tgz
+curl -fsSL https://downloads.gemarcade.com/sdk/v15.3.1/gem-web-sdk.tgz.sri
 openssl dgst -sha384 -binary gem-web-sdk.tgz | openssl base64 -A
 ```
 

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

@@ -1076,19 +1076,20 @@ The player sets their defaults once, in the Arcade's Settings, separately for ea
 and a television can say different things. They reach your game as `gem.prefs.recommended`, in the
 same push as `muted` and `reducedMotion`, and again whenever the player changes one:
 
-| Field                    | Values                          | What it suggests                                                                                                                 |
-| ------------------------ | ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
-| `volume`                 | `0` to `100`                    | Your master volume's starting level, as a percentage — divide by 100 for a gain. A level, never a mute.                          |
-| `batterySaver`           | `true` / `false`                | Spend less power: a lower frame rate, fewer effects, a lower resolution.                                                         |
-| `keyboardLayout`         | `'wasd'` / `'arrows'`           | Which keys move by default.                                                                                                      |
-| `gamepadConfirm`         | `'south'` / `'east'`            | Which face button confirms, by position: the bottom one (A on an Xbox controller) or the right one (B). The other one goes back. |
-| `vibration`              | `true` / `false`                | Your vibration toggle's starting state ([if your game vibrates](#if-your-game-vibrates)).                                        |
-| `lookSensitivity`        | `20` to `400`                   | Look speed for touch, mouse and pen, as a percentage of the base speeds: `100` is 1×.                                            |
-| `gamepadLookSensitivity` | `20` to `400`                   | Look speed for a gamepad stick, as a percentage: `100` is 1×.                                                                    |
-| `invertLookY`            | `true` / `false`                | Up/down look inverted: pushing up or dragging up looks down. Pitch only, never yaw.                                              |
-| `touchMovement`          | `'floating'` / `'fixed'`        | On a touch screen, a movement stick that appears where the thumb lands, or one fixed in place.                                   |
-| `graphicsQuality`        | `'low'` / `'medium'` / `'high'` | The graphics quality to start at on this device.                                                                                 |
-| `graphicsQualityAuto`    | `true` / `false`                | `true`: the Arcade picked that tier for this device, so you may adapt from it. `false`: the player picked it, so hold it.        |
+| Field                    | Values                          | What it suggests                                                                                                                     |
+| ------------------------ | ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
+| `volume`                 | `0` to `100`                    | Your master volume's starting level, as a percentage — divide by 100 for a gain. A level, never a mute.                              |
+| `batterySaver`           | `true` / `false`                | Spend less power: a lower frame rate, fewer effects, a lower resolution.                                                             |
+| `keyboardLayout`         | `'wasd'` / `'arrows'`           | Which keys move by default.                                                                                                          |
+| `gamepadConfirm`         | `'south'` / `'east'`            | Which face button confirms, by position: the bottom one (A on an Xbox controller) or the right one (B). The other one goes back.     |
+| `vibration`              | `true` / `false`                | Your vibration toggle's starting state ([if your game vibrates](#if-your-game-vibrates)).                                            |
+| `lookSensitivity`        | `20` to `400`                   | Look speed for touch, mouse and pen, as a percentage of the base speeds: `100` is 1×.                                                |
+| `gamepadLookSensitivity` | `20` to `400`                   | Look speed for a gamepad stick, as a percentage: `100` is 1×.                                                                        |
+| `invertLookY`            | `true` / `false`                | Up/down look inverted: pushing up or dragging up looks down. Pitch only, never yaw.                                                  |
+| `touchMovement`          | `'floating'` / `'fixed'`        | On a touch screen, a movement stick that appears where the thumb lands, or one fixed in place.                                       |
+| `graphicsQuality`        | `'low'` / `'medium'` / `'high'` | The graphics quality to start at on this device.                                                                                     |
+| `graphicsQualityAuto`    | `true` / `false`                | `true`: the Arcade picked that tier for this device, so you may adapt from it. `false`: the player picked it, so hold it.            |
+| `colorHelp`              | `true` / `false` / `null`       | Color help: start your colour-blind aids (patterns or symbols beside colours, a colour-blind palette) on, or off. `null`: no advice. |
 
 `lookSensitivity` to `touchMovement` are the camera and controls settings: see
 [camera and look controls](#camera-and-look-controls) for `gem.controls.look()`, which applies the
@@ -1098,7 +1099,15 @@ older Arcade sends `recommended` without them; the SDK then fills each with its
 [graphics quality](#graphics-quality-the-arcade-picks-the-start-your-game-adapts). An older Arcade
 sends neither; the SDK then fills `graphicsQuality` from `batterySaver` (`'low'` when it is on,
 `'medium'` otherwise) and `graphicsQualityAuto` with `true`, and reads a tier it does not know as
-`'medium'`. So whenever `recommended` is not `null`, all eleven fields are there.
+`'medium'`. So whenever `recommended` is not `null`, those eleven fields are there.
+
+`colorHelp` is the player's **Color help** default, and the one field the SDK does not fill: an
+older Arcade omits it and you read `null`, which means the Arcade made **no recommendation** — not
+`false`. Keep your own default then. A game that offers colour-blind aids starts them from it, on
+first run or while the player has not chosen in your game, and never lets it override the player's
+own choice; it is the natural start for the `toggle` you declare with `icon: 'eye'`
+([the Arcade's quick row](#mirror-your-settings-into-the-arcades-menu-gemsettings)). A game with
+no such aids ignores it.
 
 **They are recommendations, and the player's own choice in your game always wins:**
 
@@ -1126,6 +1135,7 @@ const DEFAULTS = {
   invertLookY: false,
   touchMovement: 'floating',
   graphicsQuality: 'medium',
+  colorHelp: false, // your own default; `recommended.colorHelp` is null when the Arcade said nothing
 };
 let chosen = {}; // ONLY what the player picked in your settings screen
 

package/package.json

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

package/schema/bridge.v1.json

@@ -972,10 +972,11 @@
             "The player's ARCADE-WIDE DEFAULTS for this device, which the Arcade",
             "keeps in its own Settings: a starting volume, battery saver, a keyboard",
             "layout, the gamepad's confirm button, vibration, the camera and",
-            "controls settings and a starting graphics quality. RECOMMENDATIONS",
-            "ONLY. The game's own saved settings win: a game starts a setting from",
-            "here only while the player has made no choice of their own in that",
-            "game, and never overwrites one the player made because this changed.",
+            "controls settings, a starting graphics quality and Color help.",
+            "RECOMMENDATIONS ONLY. The game's own saved settings win: a game starts",
+            "a setting from here only while the player has made no choice of their",
+            "own in that game, and never overwrites one the player made because",
+            "this changed.",
             "A game may ignore it entirely.",
             "",
             "OPTIONAL because it is additive: a parent that predates it sends the",
@@ -1002,6 +1003,10 @@
             "(`low` when it is on, `medium` otherwise) and `graphicsQualityAuto`",
             "with true, so on the game side both are present whenever the object is.",
             "",
+            "`colorHelp` IS OPTIONAL INSIDE IT AND STAYS ABSENT (owner decision",
+            "2026-10-23): the SDK does NOT fill it. An older parent omits it and the",
+            "game reads `null`, \"no recommendation\", never false.",
+            "",
             "`muted`, `reducedMotion` and `showFrameStats` stay where they are, at",
             "the top of this message, and keep their meaning: they are the Arcade's",
             "own state the frame acts on, not a recommendation. The Arcade starts",
@@ -1103,6 +1108,25 @@
               "kind": "boolean",
               "optional": true,
               "$comment": "True when the Arcade detected `graphicsQuality` for this device (the player left Graphics on Auto), so the game may step its quality up or down from there as it measures frames; false when the player picked it by hand, so the game holds it and changes it only when the player does (in the Arcade or in the game's own settings). Default true when absent."
+            },
+            "colorHelp": {
+              "kind": "boolean",
+              "optional": true,
+              "$comment": [
+                "The player's Arcade-wide Color help default for this device (owner",
+                "decision 2026-10-23): true asks a game that offers colour-blind aids",
+                "-- patterns or symbols beside colours, a colour-blind palette -- to",
+                "start with them ON; false asks it to start with them off. A DEFAULT",
+                "ONLY, like every field here: a game applies it on first run, or",
+                "while the player has made no choice of their own in that game, and",
+                "never overrides the player's in-game choice. A game with no such",
+                "aids ignores it.",
+                "",
+                "ABSENT IS NOT FALSE. A parent built against an older SDK omits it,",
+                "and that absence means the Arcade made no recommendation: the SDK",
+                "reports `null` and the game keeps its own default. Unlike the",
+                "camera and controls fields there is no neutral value to invent."
+              ]
             }
           }
         }