@indiegems/gem-web-sdk 7.7.0 → 7.8.1

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

@@ -328,11 +328,11 @@ orientations:
     landscape: partial
 ```
 
-| Value | What the player gets |
-| --- | --- |
-| `full` | nothing — the game plays this way round |
-| `partial` | a dismissible hint, once, if the other way is `full` |
-| `none` | a panel over the paused game asking them to rotate, with "play anyway" |
+| Value     | What the player gets                                                   |
+| --------- | ---------------------------------------------------------------------- |
+| `full`    | nothing — the game plays this way round                                |
+| `partial` | a dismissible hint, once, if the other way is `full`                   |
+| `none`    | a panel over the paused game asking them to rotate, with "play anyway" |
 
 Three consequences worth knowing before you hit them:
 
@@ -508,10 +508,14 @@ them**, so the whole migration for a stylesheet is one declaration per edge:
 
 ```css
 /* before */
-#hud { top: env(safe-area-inset-top, 0px); }
+#hud {
+  top: env(safe-area-inset-top, 0px);
+}
 
 /* after — right in the arcade, and unchanged everywhere else */
-#hud { top: var(--gem-safe-top, env(safe-area-inset-top, 0px)); }
+#hud {
+  top: var(--gem-safe-top, env(safe-area-inset-top, 0px));
+}
 ```
 
 The `env()` fallback is not decoration. Under a parent that has not sent the message — an older
@@ -541,9 +545,7 @@ the `var()` above, or read `gem.viewport`. The release checklist looks for the b
 On a phone your game is full-bleed, and the arcade keeps one row of its own across the top of it,
 with the middle left open for a centred camera:
 
-- **Top-left: the Back tab** — the Gem Arcade wordmark, always there. **Do not put a back arrow of
-  your own top-left**: it would sit under the arcade's tab, which leaves the game, while yours would
-  mean something else.
+- **Top-left: the Back tab** — the Gem Arcade wordmark, always there.
 - **Top-right: the player's wallets** (Gems, Tickets, their achievement score) while your screen
   [shows them](#the-arcades-wallet-show-it-never-draw-it). Put your own settings, pause or menu
   button top-right **below** them, at `top: var(--gem-reserved-tr-height, …)` — and when gameplay
@@ -805,6 +807,25 @@ pauseMenu.onOpen = () => gem.setWalletVisible(true);
 - **`false` means nobody is listening** — no connection yet, or an embedder that draws no wallet.
   Do nothing in its place.
 
+## No accidental text selection
+
+**You write nothing for this.** A long press on a phone, a double-click on a button, a drag across
+your HUD: on an ordinary page each selects text, raises the copy menu or flashes a tap highlight,
+and in a game none of them is something the player meant. So at start-up the SDK turns all three
+off across your document.
+
+- **Your CSS always wins.** The SDK's rule has zero specificity, so any rule you write overrides it.
+  To make one element copyable — a room code, a share link — give it
+  `-webkit-user-select: text; user-select: text;`.
+- **Inputs, text areas and editable content are untouched.** They still take typing, still select
+  and still paste.
+- **It is a stylesheet the SDK adopts, not a `<style>` element**, so a strict `style-src` in your
+  own CSP does not block it. On iOS before 16.4, which lacks that API, the SDK sets the same
+  properties on `<html>` itself instead, all but the copy menu, which has no safe way to be handed
+  back to your inputs there.
+- **To keep the browser's default instead** — a game that is mostly text the player should be able
+  to copy — pass `createGem({ selectableText: true })`.
+
 ## The Arcade's FPS overlay
 
 The Arcade has a frame-rate toggle beside your game, and **you do not have to write anything for it
@@ -876,15 +897,15 @@ player (`gem.player`), room members, leaderboard rows, friends, profiles, showca
 async opponent you read through the raw client, once you pass the row through `mapIdentity`. One
 renderer serves all of them.
 
-| Field | What it is | Type |
-| ----- | ---------- | ---- |
-| `playerId` | The player's id. **Absent on an anonymous row** | `string` |
-| `displayName` | The name the player chose | `PlayerText` |
-| `discriminator` | The digits that tell two same-named players apart — `0001`, no `#` | `string` |
-| `displayTag` | The precomposed `Name#0001` | `PlayerText` |
-| `avatarIconId` | The portrait item's id | `string` |
-| `avatarIconUrl` | The portrait's thumbnail | `string` |
-| `badges` | Equipped badges in display order, each `{ itemId, iconUrl }` — always a list, empty for now | array |
+| Field           | What it is                                                                                  | Type         |
+| --------------- | ------------------------------------------------------------------------------------------- | ------------ |
+| `playerId`      | The player's id. **Absent on an anonymous row**                                             | `string`     |
+| `displayName`   | The name the player chose                                                                   | `PlayerText` |
+| `discriminator` | The digits that tell two same-named players apart — `0001`, no `#`                          | `string`     |
+| `displayTag`    | The precomposed `Name#0001`                                                                 | `PlayerText` |
+| `avatarIconId`  | The portrait item's id                                                                      | `string`     |
+| `avatarIconUrl` | The portrait's thumbnail                                                                    | `string`     |
+| `badges`        | Equipped badges in display order, each `{ itemId, iconUrl }` — always a list, empty for now | array        |
 
 **The name and the tag are player-authored, so both are `PlayerText`** on every surface, not only
 some. Convert with `text.toPlain()` where you render, never before.
@@ -937,11 +958,11 @@ While it lasts the player earns Gems and Tickets faster (never achievement point
 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.
 
-| Field | What it is | Type |
-| ----- | ---------- | ---- |
-| `boost.active` | Whether any currency earns faster than 1× right now | `boolean` |
-| `boost.multipliers` | One `{ currencyId, currencySlug, multiplier }` per boostable currency — `multiplier` is `2` for 2×, `1` when not boosted; a currency not listed is 1× | array |
-| `boost.expiresInDays` | Whole days until the soonest boosted currency drops back, rounded up and **capped at 7** — `7` means "7 or more"; absent when nothing is boosted | `number` |
+| Field                 | What it is                                                                                                                                            | Type      |
+| --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | --------- |
+| `boost.active`        | Whether any currency earns faster than 1× right now                                                                                                   | `boolean` |
+| `boost.multipliers`   | One `{ currencyId, currencySlug, multiplier }` per boostable currency — `multiplier` is `2` for 2×, `1` when not boosted; a currency not listed is 1× | array     |
+| `boost.expiresInDays` | Whole days until the soonest boosted currency drops back, rounded up and **capped at 7** — `7` means "7 or more"; absent when nothing is boosted      | `number`  |
 
 `boost` is always present on `gem.player`. When the Arcade has not said — an older Arcade, a
 backend without boosts, a read that has not landed yet — it reads as **not boosted**, exactly like a

package/package.json

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