@indiegems/gem-web-sdk 15.2.0 → 15.3.0

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."
+              ]
             }
           }
         }