@idosgames/mcp 0.1.27 → 0.1.29

package/registry/host.json

@@ -15,7 +15,7 @@
     },
     {
       "path": "IDOS.md",
-      "content": "# IDOS.md — project guide\n\nEvery AI agent working on this game reads this file first: the platform's AI editor loads it into\ncontext on every run, and external agents reach it through `AGENTS.md` / `CLAUDE.md`. Keep it short\nand evergreen — what the game is, how the project is laid out, rules that hold for all of it. The\nhistory of individual features does NOT belong here (see \"Feature history\" at the end).\n\n## This game\n\n<!-- 2–4 lines, filled in once the direction is clear: genre, core loop, target platform, tone.\n     Update it when the concept changes — not with every feature. -->\n\n_Not described yet._\n\n## Installed modules\n\nMirror of the `modules` array in `src/modules.ts` (the source of truth), maintained by the\nplatform — do not edit by hand.\n\n<!-- idos:modules:start -->\n\n_None yet._\n<!-- idos:modules:end -->\n\n## How the project is built\n\n**The base + modules** on the iDosGames SDK. The base is sign-in and the lobby; everything else — the\nsystems (shop, heroes, leaderboards…) and the games — is a module. Two kinds of game:\n\n- a game whose route says `inLobby: true` (idle-rpg) lives INSIDE the lobby: after sign-in the player\n  lands in it, the lobby's balances and profile on top, its tabs at the bottom, \"Play\" is the game\n  itself, any other tab opens that system's screen (`src/base/lobby/GameFrame.tsx` — the host's\n  `header`/`footer` panel slots lay the game out between them);\n- any other game (voxelcraft, board-game) takes the whole screen: sign-in → the lobby, \"Play\" launches\n  it, a small button over the game returns to the lobby (`src/base/lobby/BackToLobby.tsx`).\n\n- `src/main.tsx` — creates ONE `IDosGamesClient` and calls `mountHost(...)` with the base first, then\n  the modules. The host signs the player in before any module runs; modules never create a client or\n  log in themselves.\n- `src/base/` — **the base**, ordinary code of this project: `login/` (the sign-in and play-access\n  screens), `lobby/` (tabs, balances, wallet, profile, \"Play\"), `module.ts` (`baseModule`). It takes\n  the shared-UI roles `currency-bar`, `wallet`, `account`, `menu`, `modes`, so a game hides its own\n  balances and wallet by itself (`ctx.sharedUi.shouldDraw`) — don't edit games for that.\n- `src/app.config.ts` — what happens after sign-in (`start`: `\"game\"` — straight into the game, the\n  default; `\"lobby\"`; or a game's mode id) and the order of the lobby's tabs. The look, animations and sounds of the WHOLE app — sign-in included:\n  `src/ui.config.ts` (the only file a restyle edits; see the `idosgames-ui-kit` skill).\n- `src/modules.ts` — the composition list. **Regenerated by the platform** whenever modules are\n  installed or removed, so it holds only the imports and the `modules` array — nothing else. It is\n  also the list of what the app has: remove a system here and its tab is gone.\n- `src/modules/<id>/` — one folder per module: the catalog's systems and games and the game's own\n  modules alike. A system registers its screen with `ctx.features.register` (a lobby tab) and hides it\n  while the title has nothing for it (`available: false` + `ctx.features.setAvailable`); a game\n  registers a route (`ctx.registerRoute`) and gets a \"Play\" button.\n- `src/shared/` — created when needed: code two or more of this game's modules share.\n- `src/idos.title.ts` — **generated, do not edit.** The project's identity: which Title's data this\n  game reads and writes, baked in so a packaged mobile build or an iframe embed still knows it.\n- `src/config.ts` — **platform-owned, do not edit** (the build packs the platform's copy over it).\n  Resolves the effective title and environment: identity from `src/idos.title.ts`, DEV vs PROD from\n  the address (`{id}-dev.idos.games` vs `{id}.idos.games`) — never from the link's query. Never read\n  the title from the URL yourself: use `client.titleID`, or `ctx.titleId` inside a module's `setup()`.\n- `src/env.ts` — build-time values from `.env.local` (local development only).\n- `src/walletLogin.tsx` — the wallet sign-in button, generated for web3 titles; safe to edit.\n- `idos.modules.lock.json` — **platform-owned, do not edit.** Which modules came from the catalog,\n  their versions and file fingerprints — so updating a module never silently overwrites your edits.\n\n## Where new code goes\n\nFull standard: the `idosgames-project-structure` skill — load it before creating a module, touching\n`src/shared/`, or moving code around.\n\n- A catalog module already does it (a shop, heroes, leaderboards, rewards, …) → install that module\n  instead of rebuilding it.\n- It extends an existing module → change that module. The lobby, sign-in, balances, wallet and\n  profile → change `src/base/`.\n- It is its own mode, screen or system → a NEW module `src/modules/<feature-id>/` (kebab-case):\n  `index.ts` exporting `<camelCaseId>Module`, `module.ts`, `module.meta.json`, and as needed\n  `components/` (React UI), `game/` (engine & simulation), `data/` (static tables), `react/` (hooks,\n  context). Register it in `src/modules.ts`. A screen → `ctx.features.register` (it becomes a lobby\n  tab); a mode of its own → `ctx.registerRoute` (it gets a \"Play\" button).\n- To open another system's screen from your code: `ctx.features.open(\"store\")` — never import it. To\n  switch modes: `ctx.navigate(\"lobby\")` or a game's mode id. Other UI shown over every mode → a panel\n  with `activeOnly: false`.\n- Modules never reach into each other: a module imports only its own folder, `src/shared/` and npm\n  packages — never another module's files or host files. Durable shared state lives in the SDK\n  client; live signals go through `ctx.events` with typed topics\n  (`defineTopic(\"<module-id>:<event>@1\", shape({…}))`) declared in the module's `module.meta.json`;\n  to listen to another module, copy its topic, never import it.\n- `src/shared/` holds code TWO or more modules need (code one module needs stays inside it), by\n  purpose — `shared/ui/`, `shared/types/`, `shared/utils/`: types, constants, UI, pure helpers; no\n  game state or logic. It never imports a module.\n- When a change adds a new responsibility to a file past ~400 lines, put that part in its own file.\n\n## The SDK is npm packages — its source is NOT in this project\n\n`@idosgames/core`, `@idosgames/react`, `@idosgames/module-sdk`, `@idosgames/app-shell` are\ndependencies in `package.json`. There is no `node_modules` to read and no `.d.ts` to inspect here,\nso **you cannot discover the SDK's API by reading files in this project.**\n\n1. **Load the matching skill first.** Skills are the authoritative recipes for this SDK — one per\n   service (store, currency, item, quest, leaderboard, auth, blockchain, …).\n2. Then copy the patterns from the modules already in `src/modules/`.\n3. Never invent an SDK method, hook, or type name — it looks plausible and fails the build.\n\n`client.<service>.<action>()` returns `OperationResult<T>` (check `isOk` / `isFail`; it does not\nthrow). In React, reach the client with `useIDosGamesClient()` and player state with\n`useUserState()` from `@idosgames/react`.\n\n## Backend features live in the Title configuration, not in this repo\n\nCurrencies, items, characters, store offers, quests, lootboxes, leaderboards and seasons are\nconfigured per environment in the platform. There is **no config file in this project** — do not\ncreate `config/*.json`; it would be ignored. Write code against ids that exist in the title; if a\nfeature needs an entity that is not configured yet, name exactly what has to be added instead of\ninventing ids.\n\n## Stack & running\n\n- React 19 + TypeScript (strict) + Vite 8. Game engines (three.js, Phaser) arrive with the modules\n  that use them.\n- In the platform's AI editor there is no terminal and no package install: the project is built on\n  the server after each turn and shown in the live preview. Use only what `package.json` lists.\n- Locally (exported project or an external agent): `npm install`, then `npm run dev`,\n  `npm run build`, `npm run typecheck`.\n- Client code ships to players: never put secrets, keys or tokens in any file here.\n- Assets are not stored in the project — generated images/audio/3D are CDN URLs; reference those.\n\n## Feature history — how this project remembers\n\nThis file stays short on purpose: it is loaded on every run, so every paragraph here is paid for\nby all future work. When a game system or feature is done and something about it is worth\nremembering that the code does not show — why it is designed this way, a non-obvious constraint,\na decision the user made — write it to `docs/feature-history/<slug>.md` (one file per system;\nupdate that file when the system changes) and add ONE line to `docs/feature-history/README.md`:\n`- [Title](slug.md) — one-line gist`. Never append a feature write-up to this file. Those entries\nare not loaded automatically: open the relevant one before changing that system.\n"
+      "content": "# IDOS.md — project guide\n\nEvery AI agent working on this game reads this file first: the platform's AI editor loads it into\ncontext on every run, and external agents reach it through `AGENTS.md` / `CLAUDE.md`. Keep it short\nand evergreen — what the game is, how the project is laid out, rules that hold for all of it. The\nhistory of individual features does NOT belong here (see \"Feature history\" at the end).\n\n## This game\n\n<!-- 2–4 lines, filled in once the direction is clear: genre, core loop, target platform, tone.\n     Update it when the concept changes — not with every feature. -->\n\n_Not described yet._\n\n## Installed modules\n\nMirror of the `modules` array in `src/modules.ts` (the source of truth), maintained by the\nplatform — do not edit by hand.\n\n<!-- idos:modules:start -->\n\n_None yet._\n<!-- idos:modules:end -->\n\n## How the project is built\n\n**The base + modules** on the iDosGames SDK. The base is sign-in and the lobby; everything else — the\nsystems (shop, heroes, leaderboards…) and the games — is a module. Two kinds of game:\n\n- a game whose route says `inLobby: true` (idle-rpg) lives INSIDE the lobby: after sign-in the player\n  lands in it, the lobby's balances and profile on top, its tabs at the bottom, \"Play\" is the game\n  itself, any other tab opens that system's screen (the base's game frame - the host's\n  `header`/`footer` panel slots lay the game out between them);\n- any other game (voxelcraft, board-game) takes the whole screen: sign-in → the lobby, \"Play\" launches\n  it, a small button over the game returns to the lobby.\n\n- `src/main.tsx` — creates ONE `IDosGamesClient` and calls `mountHost(...)` with the base first, then\n  the modules. The host signs the player in before any module runs; modules never create a client or\n  log in themselves.\n- **The base** — sign-in, the play-access screen and the lobby (tabs, balances, wallet, profile, \"Play\") —\n  is NOT project code: it lives in `@idosgames/app-shell` (`createBaseModule`, `DefaultLoginScreen`,\n  `DefaultPlayAccessScreen`) and `src/main.tsx` mounts it. You configure it: `src/app.config.ts`,\n  `src/ui.config.ts`, and the wallet stack in `src/walletLogin.tsx` / `src/walletButton.tsx`. It takes\n  the shared-UI roles `currency-bar`, `wallet`, `account`, `menu`, `modes`, so a game hides its own\n  balances and wallet by itself (`ctx.sharedUi.shouldDraw`) — don't edit games for that.\n- `src/app.config.ts` — what happens after sign-in (`start`: `\"game\"` — straight into the game, the\n  default; `\"lobby\"`; or a game's mode id) and the order of the lobby's tabs. The look, animations and sounds of the WHOLE app — sign-in included:\n  `src/ui.config.ts` (the only file a restyle edits; see the `idosgames-ui-kit` skill).\n- `src/modules.ts` — the composition list. **Regenerated by the platform** whenever modules are\n  installed or removed, so it holds only the imports and the `modules` array — nothing else. It is\n  also the list of what the app has: remove a system here and its tab is gone.\n- `src/modules/<id>/` — one folder per module: the catalog's systems and games and the game's own\n  modules alike. A system registers its screen with `ctx.features.register` (a lobby tab) and hides it\n  while the title has nothing for it (`available: false` + `ctx.features.setAvailable`); a game\n  registers a route (`ctx.registerRoute`) and gets a \"Play\" button.\n- `src/shared/` — created when needed: code two or more of this game's modules share.\n- `src/idos.title.ts` — **generated, do not edit.** The project's identity: which Title's data this\n  game reads and writes, baked in so a packaged mobile build or an iframe embed still knows it.\n- `src/config.ts` — **platform-owned, do not edit** (the build packs the platform's copy over it).\n  Resolves the effective title and environment: identity from `src/idos.title.ts`, DEV vs PROD from\n  the address (`{id}-dev.idos.games` vs `{id}.idos.games`) — never from the link's query. Never read\n  the title from the URL yourself: use `client.titleID`, or `ctx.titleId` inside a module's `setup()`.\n- `src/env.ts` — build-time values from `.env.local` (local development only).\n- `src/walletLogin.tsx` — the wallet sign-in button, generated for web3 titles; safe to edit.\n- `idos.modules.lock.json` — **platform-owned, do not edit.** Which modules came from the catalog,\n  their versions and file fingerprints — so updating a module never silently overwrites your edits.\n\n## Where new code goes\n\nFull standard: the `idosgames-project-structure` skill — load it before creating a module, touching\n`src/shared/`, or moving code around.\n\n- A catalog module already does it (a shop, heroes, leaderboards, rewards, …) → install that module\n  instead of rebuilding it.\n- It extends an existing module → change that module. The lobby, sign-in, balances, wallet and\n  profile are the SDK's base - configure it (`src/app.config.ts`, `src/ui.config.ts`), do not rebuild it.\n- It is its own mode, screen or system → a NEW module `src/modules/<feature-id>/` (kebab-case):\n  `index.ts` exporting `<camelCaseId>Module`, `module.ts`, `module.meta.json`, and as needed\n  `components/` (React UI), `game/` (engine & simulation), `data/` (static tables), `react/` (hooks,\n  context). Register it in `src/modules.ts`. A screen → `ctx.features.register` (it becomes a lobby\n  tab); a mode of its own → `ctx.registerRoute` (it gets a \"Play\" button).\n- To open another system's screen from your code: `ctx.features.open(\"store\")` — never import it. To\n  switch modes: `ctx.navigate(\"lobby\")` or a game's mode id. Other UI shown over every mode → a panel\n  with `activeOnly: false`.\n- Modules never reach into each other: a module imports only its own folder, `src/shared/` and npm\n  packages — never another module's files or host files. Durable shared state lives in the SDK\n  client; live signals go through `ctx.events` with typed topics\n  (`defineTopic(\"<module-id>:<event>@1\", shape({…}))`) declared in the module's `module.meta.json`;\n  to listen to another module, copy its topic, never import it.\n- `src/shared/` holds code TWO or more modules need (code one module needs stays inside it), by\n  purpose — `shared/ui/`, `shared/types/`, `shared/utils/`: types, constants, UI, pure helpers; no\n  game state or logic. It never imports a module.\n- When a change adds a new responsibility to a file past ~400 lines, put that part in its own file.\n\n## The SDK is npm packages — its source is NOT in this project\n\n`@idosgames/core`, `@idosgames/react`, `@idosgames/module-sdk`, `@idosgames/app-shell` are\ndependencies in `package.json`. There is no `node_modules` to read and no `.d.ts` to inspect here,\nso **you cannot discover the SDK's API by reading files in this project.**\n\n1. **Load the matching skill first.** Skills are the authoritative recipes for this SDK — one per\n   service (store, currency, item, quest, leaderboard, auth, blockchain, …).\n2. Then copy the patterns from the modules already in `src/modules/`.\n3. Never invent an SDK method, hook, or type name — it looks plausible and fails the build.\n\n`client.<service>.<action>()` returns `OperationResult<T>` (check `isOk` / `isFail`; it does not\nthrow). In React, reach the client with `useIDosGamesClient()` and player state with\n`useUserState()` from `@idosgames/react`.\n\n## Backend features live in the Title configuration, not in this repo\n\nCurrencies, items, characters, store offers, quests, lootboxes, leaderboards and seasons are\nconfigured per environment in the platform. There is **no config file in this project** — do not\ncreate `config/*.json`; it would be ignored. Write code against ids that exist in the title; if a\nfeature needs an entity that is not configured yet, name exactly what has to be added instead of\ninventing ids.\n\n## Stack & running\n\n- React 19 + TypeScript (strict) + Vite 8. Game engines (three.js, Phaser) arrive with the modules\n  that use them.\n- In the platform's AI editor there is no terminal and no package install: the project is built on\n  the server after each turn and shown in the live preview. Use only what `package.json` lists.\n- Locally (exported project or an external agent): `npm install`, then `npm run dev`,\n  `npm run build`, `npm run typecheck`.\n- Client code ships to players: never put secrets, keys or tokens in any file here.\n- Assets are not stored in the project — generated images/audio/3D are CDN URLs; reference those.\n\n## Feature history — how this project remembers\n\nThis file stays short on purpose: it is loaded on every run, so every paragraph here is paid for\nby all future work. When a game system or feature is done and something about it is worth\nremembering that the code does not show — why it is designed this way, a non-obvious constraint,\na decision the user made — write it to `docs/feature-history/<slug>.md` (one file per system;\nupdate that file when the system changes) and add ONE line to `docs/feature-history/README.md`:\n`- [Title](slug.md) — one-line gist`. Never append a feature write-up to this file. Those entries\nare not loaded automatically: open the relevant one before changing that system.\n"
     },
     {
       "path": "index.html",
@@ -23,7 +23,7 @@
     },
     {
       "path": "package.json",
-      "content": "{\n  \"name\": \"@idosgames/base-template\",\n  \"version\": \"0.0.0\",\n  \"private\": true,\n  \"type\": \"module\",\n  \"description\": \"The base every AI Coder project starts from: sign-in and the lobby (src/base/) on the host shell. The systems (shop, heroes, leaderboards…) and the games are modules plugged in via src/modules.ts.\",\n  \"scripts\": {\n    \"dev\": \"vite\",\n    \"build\": \"vite build\",\n    \"preview\": \"vite preview\",\n    \"typecheck\": \"tsc --noEmit -p tsconfig.json\"\n  },\n  \"//\": \"Versions are pinned exactly: this is a seed for AI Coder projects, which build offline against a dependency allowlist baked at these versions (see scripts/pack-builder.mjs). Modules bring their own engine deps (three/phaser) when added.\",\n  \"dependencies\": {\n    \"@idosgames/app-shell\": \"0.12.0\",\n    \"@idosgames/core\": \"0.21.1\",\n    \"@idosgames/module-sdk\": \"0.10.0\",\n    \"@idosgames/react\": \"0.4.4\",\n    \"@idosgames/wallet\": \"0.6.2\",\n    \"@reown/appkit\": \"1.8.23\",\n    \"@reown/appkit-adapter-wagmi\": \"1.8.23\",\n    \"@tanstack/react-query\": \"5.101.2\",\n    \"react\": \"19.2.7\",\n    \"react-dom\": \"19.2.7\",\n    \"wagmi\": \"3.7.2\"\n  },\n  \"devDependencies\": {\n    \"@types/react\": \"19.2.17\",\n    \"@types/react-dom\": \"19.2.3\",\n    \"@vitejs/plugin-react\": \"6.0.4\",\n    \"typescript\": \"5.9.3\",\n    \"vite\": \"8.1.5\"\n  }\n}\n"
+      "content": "{\n  \"name\": \"@idosgames/base-template\",\n  \"version\": \"0.0.0\",\n  \"private\": true,\n  \"type\": \"module\",\n  \"description\": \"The base every AI Coder project starts from: sign-in and the lobby (both from @idosgames/app-shell) on the host shell. The systems (shop, heroes, leaderboards…) and the games are modules plugged in via src/modules.ts.\",\n  \"scripts\": {\n    \"dev\": \"vite\",\n    \"build\": \"vite build\",\n    \"preview\": \"vite preview\",\n    \"typecheck\": \"tsc --noEmit -p tsconfig.json\"\n  },\n  \"//\": \"Versions are pinned exactly: this is a seed for AI Coder projects, which build offline against a dependency allowlist baked at these versions (see scripts/pack-builder.mjs). Modules bring their own engine deps (three/phaser) when added.\",\n  \"dependencies\": {\n    \"@idosgames/app-shell\": \"0.12.2\",\n    \"@idosgames/core\": \"0.21.3\",\n    \"@idosgames/module-sdk\": \"0.10.0\",\n    \"@idosgames/react\": \"0.4.5\",\n    \"@idosgames/wallet\": \"0.6.3\",\n    \"@reown/appkit\": \"1.8.23\",\n    \"@reown/appkit-adapter-wagmi\": \"1.8.23\",\n    \"@tanstack/react-query\": \"5.101.2\",\n    \"react\": \"19.2.7\",\n    \"react-dom\": \"19.2.7\",\n    \"wagmi\": \"3.7.2\"\n  },\n  \"devDependencies\": {\n    \"@types/react\": \"19.2.17\",\n    \"@types/react-dom\": \"19.2.3\",\n    \"@vitejs/plugin-react\": \"6.0.4\",\n    \"typescript\": \"5.9.3\",\n    \"vite\": \"8.1.5\"\n  }\n}\n"
     },
     {
       "path": "public/sw.js",
@@ -31,67 +31,7 @@
     },
     {
       "path": "src/app.config.ts",
-      "content": "import { defineAppConfig } from \"./base/app-config\";\n\n// What happens after sign-in and how the lobby is ordered. The look, animations and sounds are in\n// ./ui.config.ts. Which systems (shop, heroes, leaderboards…) and games the app has is\n// ./modules.ts: remove a module there and its tab is gone. A tab whose system has nothing configured\n// on the title yet (no store offers, no heroes…) stays hidden from players by itself.\n//\n// Everything is optional; uncomment and edit.\nexport default defineAppConfig({\n  // \"game\" — sign-in → straight into a game that lives inside the lobby (idle-rpg); an app whose\n  // games take the whole screen (voxelcraft, board-game) starts in the lobby. \"lobby\" — always\n  // sign-in → lobby → \"Play\". The mode id of a game (\"voxelcraft\") starts in that one.\n  start: \"game\",\n  lobby: {\n    // order: [\"play\", \"store\", \"character\"], // these tabs first, in this order\n    // primary: [\"season\"],                    // also a main tab rather than under \"More\"\n  },\n});\n"
-    },
-    {
-      "path": "src/base/app-config.ts",
-      "content": "// The shape of src/app.config.ts and its defaults.\n//\n// app.config.ts says what happens after sign-in and how the lobby is ordered. It does NOT list which\n// systems the app has — that is src/modules.ts: every installed module (shop, heroes, a game…) brings\n// its own tab or mode, and removing it there removes it from the app.\n\n/** The mode id of the lobby. Every other mode is a module's route (a game). */\nexport const LOBBY_MODE = \"lobby\";\n\n/** `start` value: the game that lives inside the lobby (its route says `inLobby`); none — the lobby. */\nexport const GAME_START = \"game\";\n\nexport interface AppConfig {\n  /**\n   * Where the player lands after sign-in: `\"game\"` (the default) — straight into the game that lives\n   * inside the lobby (idle-rpg), or the lobby when the app's games take the whole screen (voxelcraft,\n   * board-game); `\"lobby\"`; or the mode id of a particular game. From a game the lobby stays one tap\n   * away.\n   */\n  start: string;\n  lobby: {\n    /** These tabs first, in this order (feature ids: \"play\", \"store\", \"character\"…). */\n    order: readonly string[];\n    /** Also shown as main tabs rather than under \"More\" (feature ids). */\n    primary: readonly string[];\n  };\n}\n\nexport interface AppConfigInput {\n  start?: string;\n  lobby?: {\n    order?: readonly string[];\n    primary?: readonly string[];\n  };\n}\n\n/** Fills in the defaults — every field of app.config.ts is optional. */\nexport function defineAppConfig(input: AppConfigInput = {}): AppConfig {\n  const start = input.start?.trim();\n  return {\n    start: start ? start : GAME_START,\n    lobby: {\n      order: input.lobby?.order ?? [],\n      primary: input.lobby?.primary ?? [],\n    },\n  };\n}\n"
-    },
-    {
-      "path": "src/base/index.ts",
-      "content": "// The base of the app: sign-in (./login, rendered by the host) and the lobby (./module.ts, installed\n// by main.tsx before the modules of src/modules.ts).\n\nexport { baseModule, createBaseModule, type BaseWeb3 } from \"./module\";\nexport { LoginScreen, type LoginScreenExtras } from \"./login/LoginScreen\";\nexport { PlayAccessScreen } from \"./login/PlayAccessScreen\";\nexport {\n  defineAppConfig,\n  GAME_START,\n  LOBBY_MODE,\n  type AppConfig,\n  type AppConfigInput,\n} from \"./app-config\";\n"
-    },
-    {
-      "path": "src/base/lobby/Account.tsx",
-      "content": "import { useState, type CSSProperties, type ReactNode } from \"react\";\nimport type { FeatureRegistry } from \"@idosgames/module-sdk\";\nimport { useIDosGamesClient } from \"@idosgames/react\";\nimport {\n  Button,\n  Icon,\n  outlined,\n  Popup,\n  useGameLayout,\n  useUiKit,\n  v,\n  well,\n} from \"@idosgames/react/ui\";\nimport { t } from \"./i18n\";\n\n// The player's corner of the lobby header. With the profile module installed (and available) the\n// button opens its screen; otherwise a small popup with the player ID (tap to copy) and \"Log out\".\n// The base takes the \"account\" role, so the host never floats its own copy over the tabs.\n\nexport function Account({\n  features,\n}: {\n  features: FeatureRegistry;\n}): ReactNode {\n  const client = useIDosGamesClient();\n  const kit = useUiKit();\n  const layout = useGameLayout();\n  const [open, setOpen] = useState(false);\n  const [copied, setCopied] = useState(false);\n  const userID = client.auth.context?.userID ?? null;\n  const hasProfile = features.get(\"profile\")?.available === true;\n\n  const copy = (): void => {\n    if (!userID) return;\n    void (async () => {\n      try {\n        await navigator.clipboard.writeText(userID);\n      } catch {\n        const area = document.createElement(\"textarea\");\n        area.value = userID;\n        document.body.appendChild(area);\n        area.select();\n        document.execCommand(\"copy\");\n        area.remove();\n      }\n      setCopied(true);\n      window.setTimeout(() => setCopied(false), 1500);\n    })();\n  };\n  const logout = (): void => void client.auth.logout();\n  const shortID =\n    userID && userID.length > 12\n      ? `${userID.slice(0, 5)}…${userID.slice(-5)}`\n      : userID;\n  const onProfile = (): void => {\n    kit.play(\"click\");\n    if (hasProfile) features.open(\"profile\");\n    else setOpen(true);\n  };\n\n  return (\n    <>\n      <button\n        type=\"button\"\n        className=\"idos-press\"\n        aria-label={t(\"profile\")}\n        onClick={onProfile}\n        style={chip}\n        data-tutorial-anchor=\"lobby:profile\"\n      >\n        <Icon glyph=\"user\" size={layout === \"phone\" ? 30 : 24} />\n        {layout !== \"phone\" && shortID ? (\n          <span\n            style={{\n              fontFamily: \"ui-monospace, Consolas, monospace\",\n              fontSize: 13,\n            }}\n          >\n            {shortID}\n          </span>\n        ) : null}\n      </button>\n      {open ? (\n        <Popup title={t(\"profile\")} onClose={() => setOpen(false)} width={380}>\n          <div style={{ display: \"grid\", justifyItems: \"center\", gap: 8 }}>\n            <Icon glyph=\"user\" size={64} />\n            {userID ? (\n              <>\n                <div style={{ ...outlined, fontSize: 13, color: v.textDim }}>\n                  {t(\"playerId\")}\n                </div>\n                <div\n                  style={{\n                    ...outlined,\n                    fontFamily: \"ui-monospace, Consolas, monospace\",\n                    fontSize: 14,\n                    wordBreak: \"break-all\",\n                    textAlign: \"center\",\n                  }}\n                >\n                  {userID}\n                </div>\n              </>\n            ) : null}\n          </div>\n          {userID ? (\n            <Button tone=\"blue\" onClick={copy}>\n              <Icon glyph={copied ? \"check\" : \"copy\"} size={20} />{\" \"}\n              {copied ? t(\"copied\") : t(\"copyId\")}\n            </Button>\n          ) : null}\n          <Button tone=\"grey\" onClick={logout}>\n            <Icon glyph=\"logout\" size={20} /> {t(\"logout\")}\n          </Button>\n        </Popup>\n      ) : null}\n    </>\n  );\n}\n\nconst chip: CSSProperties = {\n  ...outlined,\n  display: \"inline-flex\",\n  alignItems: \"center\",\n  gap: 6,\n  padding: 3,\n  paddingRight: 10,\n  borderRadius: 999,\n  ...well,\n  cursor: \"pointer\",\n  whiteSpace: \"nowrap\",\n};\n"
-    },
-    {
-      "path": "src/base/lobby/BackToLobby.tsx",
-      "content": "import {\n  useSyncExternalStore,\n  type ComponentType,\n  type ReactNode,\n} from \"react\";\nimport type { ModeRegistry } from \"@idosgames/module-sdk\";\nimport { IconButton } from \"@idosgames/react/ui\";\nimport { LOBBY_MODE } from \"../app-config\";\nimport { chromeFor } from \"./model\";\nimport { t } from \"./i18n\";\n\n// Over a game that takes the whole screen (voxelcraft, board-game) the base draws only this: a small\n// round button back to the lobby, in the top-left corner — the game keeps the screen. A game that\n// lives inside the lobby (`inLobby`, idle-rpg) gets the lobby's frame instead (GameFrame.tsx).\n// A game with its own \"exit\" calls ctx.navigate(\"lobby\") instead; then delete this panel in\n// ../module.ts.\n\nexport function makeBackToLobby(\n  modes: ModeRegistry,\n  navigate: (modeId: string) => void,\n): ComponentType {\n  return function BackToLobby(): ReactNode {\n    const current = useSyncExternalStore(\n      modes.subscribe,\n      modes.current,\n      modes.current,\n    );\n    if (chromeFor(modes.list(), current) !== \"back\") return null;\n    return (\n      <div\n        style={{\n          position: \"absolute\",\n          top: \"calc(var(--idos-safe-top, 0px) + 10px)\",\n          left: 10,\n          pointerEvents: \"auto\",\n        }}\n      >\n        <IconButton\n          glyph=\"back\"\n          label={t(\"toLobby\")}\n          onClick={() => navigate(LOBBY_MODE)}\n          size={40}\n          tone=\"blue\"\n        />\n      </div>\n    );\n  };\n}\n"
-    },
-    {
-      "path": "src/base/lobby/GameFrame.tsx",
-      "content": "import {\n  useRef,\n  useSyncExternalStore,\n  type ComponentType,\n  type ReactNode,\n} from \"react\";\nimport type { FeatureRegistry, ModeRegistry } from \"@idosgames/module-sdk\";\nimport { useLayout, useUiKit, v } from \"@idosgames/react/ui\";\nimport type { AppConfig } from \"../app-config\";\nimport { BottomTabs, LobbyHeader } from \"./Lobby\";\nimport { PLAY, arrangeFeatures, chromeFor, splitTabs } from \"./model\";\n\n// The game inside the lobby — only a game whose route says `inLobby` (idle-rpg); a full-screen game\n// (voxelcraft, board-game) gets just the button back (BackToLobby.tsx). While such a game is on\n// screen the base keeps the lobby around it: the same balances, wallet and profile on top (the\n// host's `header` slot), the same tabs at the bottom (its `footer` slot) with \"Play\" lit — \"Play\"\n// IS the game. Any other tab opens that screen in the lobby.\n// The host lays the game's canvas and panels out between the two, so a game needs to know nothing.\n// In the lobby itself both render nothing — it draws its own.\n\nexport interface GameFrameOptions {\n  features: FeatureRegistry;\n  modes: ModeRegistry;\n  /** `lobby` of src/app.config.ts — the same tab order as in the lobby. */\n  lobby: AppConfig[\"lobby\"];\n  wallet: boolean;\n  /** Switch to the lobby and open this screen there (a feature id, or the \"More\" grid). */\n  openInLobby: (id: string) => void;\n}\n\n/** A game that lives inside the lobby (`inLobby`) is on screen — a full-screen game is not framed. */\nfunction useInGame(modes: ModeRegistry): boolean {\n  const current = useSyncExternalStore(\n    modes.subscribe,\n    modes.current,\n    modes.current,\n  );\n  return chromeFor(modes.list(), current) === \"frame\";\n}\n\nexport function makeFrameHeader(options: GameFrameOptions): ComponentType {\n  return function GameFrameHeader(): ReactNode {\n    const features = useSyncExternalStore(\n      options.features.subscribe,\n      options.features.list,\n      options.features.list,\n    );\n    if (!useInGame(options.modes)) return null;\n    const store = features.some((f) => f.id === \"store\" && f.available);\n    return (\n      <LobbyHeader\n        features={options.features}\n        wallet={options.wallet}\n        pad={12}\n        onStore={store ? () => options.openInLobby(\"store\") : null}\n        style={{\n          padding: \"8px 12px 8px\",\n          background: `linear-gradient(180deg, ${v.bgTop}, ${v.panelDeep})`,\n          borderBottom: `2px solid ${v.panelEdge}`,\n        }}\n      />\n    );\n  };\n}\n\nexport function makeFrameTabs(options: GameFrameOptions): ComponentType {\n  return function GameFrameTabs(): ReactNode {\n    const all = useSyncExternalStore(\n      options.features.subscribe,\n      options.features.list,\n      options.features.list,\n    );\n    const ref = useRef<HTMLDivElement>(null);\n    const layout = useLayout(ref);\n    const kit = useUiKit();\n    const inGame = useInGame(options.modes);\n    if (!inGame) return null;\n\n    // The lobby's own split; on a wide screen the lobby has a side rail, over a game — the pill.\n    const list = arrangeFeatures(\n      all.filter((f) => f.available),\n      options.lobby,\n    );\n    const { tabs, more } = splitTabs(\n      list,\n      layout === \"desktop\" ? \"tablet\" : layout,\n    );\n    return (\n      // The tabs place themselves in the lobby grid's \"tabs\" area — the same one area here.\n      <div ref={ref} style={{ display: \"grid\", gridTemplateAreas: '\"tabs\"' }}>\n        <BottomTabs\n          tabs={tabs}\n          more={\n            more.length > 0\n              ? {\n                  badge: more.reduce((s, f) => s + (f.badge > 0 ? 1 : 0), 0),\n                  counter: more.some((f) => f.id === \"inventory\"),\n                }\n              : null\n          }\n          current={PLAY}\n          pill={layout !== \"phone\"}\n          onPick={(id) => {\n            if (id === PLAY) return;\n            kit.play(\"tab\");\n            options.openInLobby(id);\n          }}\n        />\n      </div>\n    );\n  };\n}\n"
-    },
-    {
-      "path": "src/base/lobby/i18n.ts",
-      "content": "import { makeT } from \"@idosgames/react/ui\";\n\n// Strings of the lobby. Names of currencies, items and the rest are the publisher's words (title\n// config), and every tab's label is its module's own.\n\nconst EN = {\n  lobby: \"Lobby\",\n  toLobby: \"To the lobby\",\n  play: \"Play\",\n  withFriends: \"With friends\",\n  more: \"More\",\n  profile: \"Profile\",\n  playerId: \"Player ID\",\n  copyId: \"Copy ID\",\n  copied: \"Copied\",\n  logout: \"Log out\",\n  wallet: \"Wallet\",\n  noFeatures:\n    \"Nothing to show yet. Tabs appear as the app's modules (shop, heroes, leaderboards…) get their settings on the title.\",\n} as const;\n\nexport type StringKey = keyof typeof EN;\n\nexport const t = makeT<StringKey>(EN, {\n  lobby: \"Лобби\",\n  toLobby: \"В лобби\",\n  play: \"Играть\",\n  withFriends: \"С друзьями\",\n  more: \"Ещё\",\n  profile: \"Профиль\",\n  playerId: \"ID игрока\",\n  copyId: \"Скопировать ID\",\n  copied: \"Скопировано\",\n  logout: \"Выйти\",\n  wallet: \"Кошелёк\",\n  noFeatures:\n    \"Пока здесь пусто. Вкладки появляются, когда модулям приложения (магазин, герои, лидеры…) заданы настройки в тайтле.\",\n});\n"
-    },
-    {
-      "path": "src/base/lobby/Lobby.tsx",
-      "content": "import {\n  useEffect,\n  useRef,\n  useState,\n  useSyncExternalStore,\n  type ComponentType,\n  type CSSProperties,\n  type ReactNode,\n} from \"react\";\nimport type { FeatureEntry, FeatureRegistry } from \"@idosgames/module-sdk\";\nimport { useUserState } from \"@idosgames/react\";\nimport {\n  Badge,\n  EmptyState,\n  FeatureGrid,\n  Icon,\n  IconButton,\n  type Layout,\n  ON_TONE,\n  outlined,\n  ResourceCounter,\n  screenBackground,\n  uiT,\n  useCatalog,\n  useLayout,\n  useUiKit,\n  v,\n} from \"@idosgames/react/ui\";\nimport type { AppConfig } from \"../app-config\";\nimport { Account } from \"./Account\";\nimport { WalletButton } from \"./WalletButton\";\nimport { MORE, PLAY, arrangeFeatures, splitTabs } from \"./model\";\nimport { t } from \"./i18n\";\n\n// The lobby — the app's home. Its tabs are the modules' features (ctx.features — the shop, heroes,\n// leaders, rewards, the marketplace… and \"Play\" with a button per game); the lobby only lays them\n// out, in three layouts by its width:\n//  - phone: balances, the wallet and the profile on top, the screen, 4 tabs + \"More\" at the bottom;\n//  - tablet: the same frame, the tab bar a centred pill with room for 6;\n//  - desktop: every feature in a side rail, grouped; the screen gets up to 1120px.\n// It is also the PRESENTER of features while on screen: `features.open(id)` from any module switches\n// the lobby to that screen. A feature the title has nothing for yet (`available: false`) is not\n// shown; remove a module from src/modules.ts and its tab is gone.\n\nexport interface LobbyOptions {\n  features: FeatureRegistry;\n  /** `lobby` of src/app.config.ts: tabs to put first / to lift out of \"More\". */\n  lobby: AppConfig[\"lobby\"];\n  /** Show the wallet button — a web3 title on an EVM network. */\n  wallet: boolean;\n  /**\n   * A screen asked for while the lobby was not on screen (a game's \"Open for friends\"): the base\n   * switched to the lobby, the lobby opens it on mount. See `createBaseModule`.\n   */\n  pending?: { take(): { id: string; args?: Record<string, unknown> } | null };\n  /**\n   * The \"Play\" tab was picked: switch to the game and return true (the game then sits inside the\n   * lobby's frame — ./GameFrame.tsx), or false to show the \"Play\" screen (several games).\n   */\n  onPlay?: () => boolean;\n}\n\nconst CONTENT_MAX: Record<Layout, number> = {\n  phone: 760,\n  tablet: 900,\n  desktop: 1120,\n};\n\nexport function makeLobbyPanel(options: LobbyOptions): ComponentType {\n  return function LobbyPanel(): ReactNode {\n    return <Lobby options={options} />;\n  };\n}\n\ninterface Active {\n  id: string;\n  args?: Record<string, unknown>;\n}\n\nfunction Lobby({ options }: { options: LobbyOptions }): ReactNode {\n  const { features } = options;\n  const all = useSyncExternalStore(\n    features.subscribe,\n    features.list,\n    features.list,\n  );\n  const list = arrangeFeatures(\n    all.filter((f) => f.available),\n    options.lobby,\n  );\n  const catalog = useCatalog();\n  const kit = useUiKit();\n  const rootRef = useRef<HTMLDivElement>(null);\n  const layout = useLayout(rootRef);\n  const [active, setActive] = useState<Active | null>(\n    () => options.pending?.take() ?? null,\n  );\n\n  // While the lobby is on screen, \"open feature X\" from any module switches the lobby to X.\n  useEffect(\n    () =>\n      features.setPresenter((id, args) => {\n        setActive({ id, args });\n        return true;\n      }),\n    [features],\n  );\n\n  const { tabs, more } = splitTabs(list, layout);\n  const first = tabs[0];\n  const current: Active | null =\n    active && (active.id === MORE || list.some((f) => f.id === active.id))\n      ? active\n      : first\n        ? { id: first.id }\n        : null;\n  const entry =\n    current && current.id !== MORE ? features.get(current.id) : undefined;\n  const inMore = current !== null && more.some((f) => f.id === current.id);\n  const go = (id: string): void => setActive({ id });\n  const pick = (id: string): void => {\n    kit.play(\"tab\");\n    if (id === PLAY && options.onPlay?.()) return;\n    go(id);\n  };\n\n  const desktop = layout === \"desktop\";\n  const pad = layout === \"phone\" ? 14 : 24;\n  const frame: CSSProperties = desktop\n    ? {\n        gridTemplateColumns: \"232px minmax(0, 1fr)\",\n        gridTemplateRows: \"auto minmax(0, 1fr)\",\n        gridTemplateAreas: `\"tabs header\" \"tabs content\"`,\n      }\n    : {\n        gridTemplateColumns: \"minmax(0, 1fr)\",\n        gridTemplateRows: \"auto minmax(0, 1fr) auto\",\n        gridTemplateAreas: `\"header\" \"content\" \"tabs\"`,\n      };\n\n  const Screen = entry?.Screen;\n  const moreBadge = more.reduce((s, f) => s + (f.badge > 0 ? 1 : 0), 0);\n  const inventoryInMore = more.some((f) => f.id === \"inventory\");\n\n  return (\n    <div\n      ref={rootRef}\n      style={{\n        position: \"absolute\",\n        inset: 0,\n        display: \"grid\",\n        ...frame,\n        background: screenBackground,\n        fontFamily: v.font,\n        color: v.text,\n        overflow: \"hidden\",\n        pointerEvents: \"auto\",\n      }}\n    >\n      <LobbyHeader\n        features={features}\n        wallet={options.wallet}\n        pad={pad}\n        onStore={list.some((f) => f.id === \"store\") ? () => go(\"store\") : null}\n        style={{ gridArea: \"header\" }}\n      />\n\n      {/* The screen */}\n      <div\n        className=\"idos-scroll\"\n        style={{\n          gridArea: \"content\",\n          overflowY: \"auto\",\n          padding: `6px ${pad}px ${desktop ? 28 : 18}px`,\n        }}\n      >\n        <div\n          key={current?.id ?? \"none\"}\n          style={{\n            maxWidth: CONTENT_MAX[layout],\n            margin: \"0 auto\",\n            animation: `idos-fade-in ${v.normal} ease both`,\n          }}\n        >\n          {list.length === 0 ? (\n            <EmptyState glyph=\"box\" text={t(\"noFeatures\")} />\n          ) : current?.id === MORE ? (\n            <FeatureGrid items={more} onOpen={go} />\n          ) : Screen && entry ? (\n            <>\n              {inMore && !desktop ? (\n                <BackToMore\n                  label={catalog.localize(entry.label)}\n                  icon={entry.icon}\n                  onBack={() => go(MORE)}\n                />\n              ) : null}\n              <Screen\n                args={current?.args}\n                close={() =>\n                  inMore ? go(MORE) : first ? go(first.id) : undefined\n                }\n              />\n            </>\n          ) : null}\n        </div>\n      </div>\n\n      {list.length === 0 ? null : desktop ? (\n        <SideRail features={tabs} current={current?.id ?? null} onPick={pick} />\n      ) : (\n        <BottomTabs\n          tabs={tabs}\n          more={\n            more.length > 0\n              ? { badge: moreBadge, counter: inventoryInMore }\n              : null\n          }\n          current={inMore ? MORE : (current?.id ?? null)}\n          pill={layout === \"tablet\"}\n          onPick={pick}\n        />\n      )}\n    </div>\n  );\n}\n\n/** Balances on the left, the wallet and the profile on the right — the lobby's top row, and the\n *  same row over a game (./GameFrame.tsx). */\nexport function LobbyHeader({\n  features,\n  wallet,\n  pad,\n  onStore,\n  style,\n}: {\n  features: FeatureRegistry;\n  wallet: boolean;\n  pad: number;\n  /** A tap on a balance opens the shop; null — no shop on this title. */\n  onStore: (() => void) | null;\n  style?: CSSProperties;\n}): ReactNode {\n  const state = useUserState();\n  const catalog = useCatalog();\n  const balances = Object.entries(state?.InventoryV2?.VirtualCurrencies ?? {})\n    .filter(\n      ([id]) =>\n        catalog.currencies[id] !== undefined ||\n        Object.keys(catalog.currencies).length === 0,\n    )\n    .sort(([a], [b]) => a.localeCompare(b));\n\n  return (\n    <div\n      style={{\n        display: \"flex\",\n        alignItems: \"center\",\n        gap: 8,\n        padding: `12px ${pad}px 6px`,\n        minHeight: 20,\n        ...style,\n      }}\n    >\n      <div\n        style={{\n          display: \"flex\",\n          gap: 8,\n          flexWrap: \"wrap\",\n          flex: \"1 1 auto\",\n          minWidth: 0,\n        }}\n      >\n        {balances.map(([id, c]) => (\n          <ResourceCounter\n            key={id}\n            currencyID={id}\n            amount={Number(c?.Amount ?? 0)}\n            onClick={onStore ?? undefined}\n          />\n        ))}\n      </div>\n      {wallet ? <WalletButton /> : null}\n      <Account features={features} />\n    </div>\n  );\n}\n\nfunction BackToMore({\n  label,\n  icon,\n  onBack,\n}: {\n  label: string;\n  icon?: string;\n  onBack: () => void;\n}): ReactNode {\n  return (\n    <div\n      style={{\n        display: \"flex\",\n        alignItems: \"center\",\n        gap: 10,\n        margin: \"0 0 12px\",\n      }}\n    >\n      <IconButton glyph=\"back\" label={uiT(\"back\")} onClick={onBack} size={36} />\n      {icon ? <Icon glyph={icon} size={28} /> : null}\n      <span style={{ ...outlined, fontSize: 19 }}>{label}</span>\n    </div>\n  );\n}\n\n/** Phone: a full-width tab strip at the bottom. Tablet: the same tabs as a centred pill. */\nexport function BottomTabs({\n  tabs,\n  more,\n  current,\n  pill,\n  onPick,\n}: {\n  tabs: FeatureEntry[];\n  more: { badge: number; counter: boolean } | null;\n  current: string | null;\n  pill: boolean;\n  onPick: (id: string) => void;\n}): ReactNode {\n  const items = [\n    ...tabs.map((f) => ({\n      id: f.id,\n      label: f.label,\n      icon: f.icon ?? \"box\",\n      badge: f.badge,\n    })),\n    ...(more\n      ? [{ id: MORE, label: t(\"more\"), icon: \"menu\", badge: more.badge }]\n      : []),\n  ];\n  return (\n    <nav\n      style={{\n        gridArea: \"tabs\",\n        display: \"grid\",\n        gridTemplateColumns: `repeat(${items.length}, minmax(0, 1fr))`,\n        gap: items.length >= 5 ? 2 : 6,\n        padding: `8px ${items.length >= 5 ? 4 : 10}px calc(8px + env(safe-area-inset-bottom))`,\n        background: `linear-gradient(180deg, ${v.panelDeep}, ${v.bgBottom})`,\n        // Longhands only: a shorthand `border` next to `borderTop` confuses React's style diffing.\n        borderTop: `2px solid ${v.panelEdge}`,\n        ...(pill\n          ? {\n              borderLeft: `2px solid ${v.panelEdge}`,\n              borderRight: `2px solid ${v.panelEdge}`,\n              borderBottom: `2px solid ${v.panelEdge}`,\n              width: `min(${Math.max(520, items.length * 110)}px, calc(100% - 32px))`,\n              justifySelf: \"center\",\n              margin: \"0 0 12px\",\n              padding: \"8px 10px\",\n              borderRadius: 22,\n              boxShadow: `0 6px 0 ${v.shadow}`,\n            }\n          : {}),\n      }}\n    >\n      {items.map((tb) => {\n        const active = tb.id === current;\n        return (\n          <button\n            key={tb.id}\n            type=\"button\"\n            className=\"idos-press\"\n            onClick={() => onPick(tb.id)}\n            data-tutorial-anchor={`tab:${tb.id}`}\n            data-resource-counter={\n              tb.id === \"inventory\" || (tb.id === MORE && more?.counter)\n                ? \"inventory\"\n                : undefined\n            }\n            style={{\n              position: \"relative\",\n              border: \"none\",\n              borderRadius: 14,\n              padding: pill ? \"8px 6px\" : \"6px 4px\",\n              cursor: \"pointer\",\n              display: \"grid\",\n              justifyItems: \"center\",\n              gap: 2,\n              minWidth: 0,\n              background: active\n                ? `linear-gradient(180deg, ${v.blue}, ${v.blueDeep})`\n                : \"transparent\",\n              boxShadow: active\n                ? `0 3px 0 color-mix(in srgb, ${v.blueDeep} 70%, black), inset 0 2px 0 rgba(255,255,255,.3)`\n                : \"none\",\n              transform: active ? \"translateY(-4px)\" : \"none\",\n              transition: `transform ${v.fast} ease`,\n            }}\n          >\n            <Icon glyph={tb.icon} size={active ? 30 : 26} />\n            <span\n              style={{\n                ...outlined,\n                fontSize: pill ? 13 : items.length >= 5 ? 10.5 : 12,\n                letterSpacing: items.length >= 5 && !pill ? -0.2 : 0.2,\n                ...(active ? ON_TONE.blue : { color: v.textDim }),\n                maxWidth: \"100%\",\n                overflow: \"hidden\",\n                textOverflow: \"ellipsis\",\n                whiteSpace: \"nowrap\",\n              }}\n            >\n              {tb.label}\n            </span>\n            <Badge\n              count={tb.badge}\n              style={{ top: 0, right: \"calc(50% - 26px)\" }}\n            />\n          </button>\n        );\n      })}\n    </nav>\n  );\n}\n\n/** Desktop: every feature in a rail on the left — the main ones first, the rest grouped. */\nfunction SideRail({\n  features,\n  current,\n  onPick,\n}: {\n  features: FeatureEntry[];\n  current: string | null;\n  onPick: (id: string) => void;\n}): ReactNode {\n  const main = features.filter((f) => f.primary);\n  const rest = features.filter((f) => !f.primary);\n  const row = (f: FeatureEntry): ReactNode => {\n    const active = f.id === current;\n    return (\n      <button\n        key={f.id}\n        type=\"button\"\n        className=\"idos-press\"\n        onClick={() => onPick(f.id)}\n        data-tutorial-anchor={`tab:${f.id}`}\n        data-resource-counter={f.id === \"inventory\" ? \"inventory\" : undefined}\n        style={{\n          position: \"relative\",\n          border: \"none\",\n          borderRadius: 16,\n          padding: \"10px 14px\",\n          cursor: \"pointer\",\n          display: \"flex\",\n          alignItems: \"center\",\n          gap: 12,\n          textAlign: \"left\",\n          background: active\n            ? `linear-gradient(180deg, ${v.blue}, ${v.blueDeep})`\n            : `color-mix(in srgb, ${v.text} 5%, transparent)`,\n          boxShadow: active\n            ? `0 4px 0 color-mix(in srgb, ${v.blueDeep} 70%, black), inset 0 2px 0 rgba(255,255,255,.3)`\n            : \"none\",\n          transform: active ? \"translateX(4px)\" : \"none\",\n          transition: `transform ${v.fast} ease`,\n        }}\n      >\n        <Icon glyph={f.icon ?? \"box\"} size={f.primary ? 34 : 28} />\n        <span\n          style={{\n            ...outlined,\n            fontSize: f.primary ? 17 : 15,\n            ...(active ? ON_TONE.blue : { color: v.textDim }),\n          }}\n        >\n          {f.label}\n        </span>\n        <Badge count={f.badge} style={{ top: 6, right: 8 }} />\n      </button>\n    );\n  };\n  return (\n    <nav\n      className=\"idos-scroll\"\n      style={{\n        gridArea: \"tabs\",\n        display: \"flex\",\n        flexDirection: \"column\",\n        gap: 8,\n        padding: \"20px 14px\",\n        background: `linear-gradient(180deg, ${v.panelDeep}, ${v.bgBottom})`,\n        borderRight: `2px solid ${v.panelEdge}`,\n        overflowY: \"auto\",\n      }}\n    >\n      {main.map(row)}\n      {rest.length > 0 ? (\n        <div\n          style={{\n            height: 2,\n            background: v.panelEdge,\n            opacity: 0.5,\n            margin: \"6px 4px\",\n          }}\n        />\n      ) : null}\n      {rest.map(row)}\n    </nav>\n  );\n}\n"
-    },
-    {
-      "path": "src/base/lobby/model.ts",
-      "content": "// Pure helpers of the lobby — covered by model.test.ts.\n\nimport type { ModeEntry } from \"@idosgames/module-sdk\";\nimport {\n  sortFeatures,\n  type FeatureMenuItem,\n  type Layout,\n} from \"@idosgames/react/ui\";\nimport type { AppConfig } from \"../app-config\";\n\n/** The pseudo-feature \"More\" — the rest of the features, as a grid. */\nexport const MORE = \"__more\";\n\n/** The lobby's own feature: the \"Play\" tab with a button per game. */\nexport const PLAY = \"play\";\n\nexport interface LobbyFeature extends FeatureMenuItem {\n  primary?: boolean;\n}\n\n/** How many tabs fit next to \"More\" at this width (the desktop rail lists everything). */\nexport function tabSlots(layout: Layout): number {\n  return layout === \"phone\"\n    ? 5\n    : layout === \"tablet\"\n      ? 7\n      : Number.POSITIVE_INFINITY;\n}\n\n/**\n * Applies app.config.ts on top of what the modules declared: the features named in `order` come\n * first, in that order, as main tabs; those in `primary` become main tabs too. Everything else keeps\n * the module's own `primary` / `order`.\n */\nexport function arrangeFeatures<T extends LobbyFeature>(\n  features: readonly T[],\n  lobby: AppConfig[\"lobby\"],\n): T[] {\n  return features.map((f) => {\n    const i = lobby.order.indexOf(f.id);\n    if (i >= 0) return { ...f, primary: true, order: -1000 + i };\n    if (lobby.primary.includes(f.id)) return { ...f, primary: true };\n    return f;\n  });\n}\n\n/**\n * Splits the game's features into the lobby's tabs and \"More\": main (primary) features by their\n * order take the tab slots first, secondary ones fill what is left; the rest goes under \"More\".\n * \"More\" appears only when it has something — an app with three screens has three tabs.\n */\nexport function splitTabs<T extends LobbyFeature>(\n  features: readonly T[],\n  layout: Layout,\n): { tabs: T[]; more: T[] } {\n  const primary = [...features]\n    .filter((f) => f.primary)\n    .sort(\n      (a, b) =>\n        (a.order ?? 100) - (b.order ?? 100) || a.label.localeCompare(b.label),\n    );\n  const secondary = sortFeatures(features.filter((f) => !f.primary));\n  const ordered = [...primary, ...secondary];\n  const slots = tabSlots(layout);\n  if (ordered.length <= slots) return { tabs: ordered, more: [] };\n  // One slot goes to \"More\" itself; main features claim the rest first.\n  const room = Math.max(1, slots - 1);\n  return { tabs: ordered.slice(0, room), more: ordered.slice(room) };\n}\n\n/** The modes the lobby offers to play: those of `game` modules, in the host's order. */\nexport function gameModes(modes: readonly ModeEntry[]): ModeEntry[] {\n  return modes.filter((m) => m.moduleType === \"game\");\n}\n\n/**\n * What the base draws over the mode on screen: nothing in the lobby (it draws itself); the lobby's\n * frame around a game that lives inside it (`inLobby` — idle-rpg); a small button back over a game\n * that takes the whole screen (voxelcraft, board-game).\n */\nexport function chromeFor(\n  modes: readonly ModeEntry[],\n  current: string | null,\n): \"none\" | \"frame\" | \"back\" {\n  const mode = modes.find((m) => m.id === current);\n  if (!mode || mode.moduleType !== \"game\") return \"none\";\n  return mode.inLobby ? \"frame\" : \"back\";\n}\n\n/** `start: \"game\"`: the game that lives inside the lobby — the first one; none → stay in the lobby. */\nexport function startGame(modes: readonly ModeEntry[]): ModeEntry | undefined {\n  return gameModes(modes).find((m) => m.inLobby);\n}\n\n/**\n * Whether the lobby offers the wallet: a web3 title with a network — EVM or Solana alike, the panel\n * is the same for both (it picks the chain from the title's networks by itself).\n */\nexport function hasWallet(identity: {\n  web3: boolean;\n  networkID: string;\n}): boolean {\n  return identity.web3 && identity.networkID.length > 0;\n}\n"
-    },
-    {
-      "path": "src/base/lobby/PlayScreen.tsx",
-      "content": "import {\n  useSyncExternalStore,\n  type ComponentType,\n  type ReactNode,\n} from \"react\";\nimport type {\n  FeatureRegistry,\n  FeatureScreenProps,\n  ModeEntry,\n  ModeRegistry,\n  MultiplayerRegistry,\n} from \"@idosgames/module-sdk\";\nimport {\n  Button,\n  Icon,\n  outlined,\n  panel,\n  useStagger,\n  useUiKit,\n  v,\n} from \"@idosgames/react/ui\";\nimport { gameModes } from \"./model\";\nimport { t } from \"./i18n\";\n\n// The \"Play\" tab of the lobby: a button per installed game. One game — one big card; several — a\n// card each. Pressing it switches the host to the game's mode: a game that lives inside the lobby sits\n// in its frame (GameFrame.tsx), any other takes the whole screen with a button back (BackToLobby.tsx).\n// A game that plays online (registered in ctx.multiplayer) also gets \"With friends\" — its rooms in\n// the multiplayer system — while that system is on the app.\n\nexport function makePlayScreen(\n  modes: ModeRegistry,\n  navigate: (modeId: string) => void,\n  online: MultiplayerRegistry,\n  features: FeatureRegistry,\n): ComponentType<FeatureScreenProps> {\n  return function PlayScreen(): ReactNode {\n    const list = useSyncExternalStore(modes.subscribe, modes.list, modes.list);\n    const onlineGames = useSyncExternalStore(\n      online.subscribe,\n      online.listGames,\n      online.listGames,\n    );\n    const rooms = useSyncExternalStore(\n      features.subscribe,\n      () => features.get(\"multiplayer\")?.available === true,\n      () => false,\n    );\n    const games = gameModes(list);\n    const stagger = useStagger();\n    const kit = useUiKit();\n    const start = (mode: ModeEntry): void => {\n      kit.play(\"open\");\n      navigate(mode.id);\n    };\n\n    return (\n      <div\n        style={{\n          display: \"grid\",\n          gap: 14,\n          gridTemplateColumns:\n            games.length > 1\n              ? \"repeat(auto-fill, minmax(240px, 1fr))\"\n              : \"minmax(0, 1fr)\",\n          maxWidth: games.length > 1 ? undefined : 520,\n          margin: \"0 auto\",\n        }}\n      >\n        {games.map((game, i) => (\n          <div\n            key={game.id}\n            className=\"idos-shine\"\n            style={{\n              ...panel,\n              ...stagger(i),\n              padding: games.length > 1 ? 18 : 26,\n              display: \"grid\",\n              gap: 14,\n              justifyItems: \"center\",\n              background: `linear-gradient(180deg, color-mix(in srgb, ${v.blue} 30%, ${v.panel}) 0%, ${v.panelDeep} 100%)`,\n            }}\n          >\n            <div className=\"idos-bounce\">\n              <Icon\n                glyph={game.icon ?? \"star\"}\n                size={games.length > 1 ? 56 : 84}\n              />\n            </div>\n            <div style={{ ...outlined, fontSize: 22, textAlign: \"center\" }}>\n              {game.label}\n            </div>\n            <Button\n              attract\n              size=\"lg\"\n              style={{ minWidth: 180 }}\n              onClick={() => start(game)}\n              data-tutorial-anchor={`play:${game.id}`}\n            >\n              ▶ {t(\"play\")}\n            </Button>\n            {rooms && onlineGames.some((g) => g.mode === game.id) ? (\n              <Button\n                tone=\"blue\"\n                style={{ minWidth: 180 }}\n                onClick={() => features.open(\"multiplayer\", { mode: game.id })}\n                data-tutorial-anchor={`play-friends:${game.id}`}\n              >\n                <Icon glyph=\"friends\" size={18} /> {t(\"withFriends\")}\n              </Button>\n            ) : null}\n          </div>\n        ))}\n        {games.length === 0 ? (\n          <div style={{ ...outlined, color: v.textDim, textAlign: \"center\" }}>\n            {t(\"noFeatures\")}\n          </div>\n        ) : null}\n      </div>\n    );\n  };\n}\n"
-    },
-    {
-      "path": "src/base/lobby/WalletButton.tsx",
-      "content": "import { useState, type CSSProperties, type ReactNode } from \"react\";\nimport {\n  LazyWalletPanel,\n  isEmbeddedInPlatform,\n  isEmbeddedOnForeignSite,\n  openPlatformWalletPanel,\n} from \"@idosgames/wallet/react/lazy\";\nimport { useIDosGamesClient } from \"@idosgames/react\";\nimport {\n  Icon,\n  outlined,\n  Popup,\n  useGameLayout,\n  useUiKit,\n  well,\n} from \"@idosgames/react/ui\";\nimport { t } from \"./i18n\";\n\n// The app's one wallet entry (deposit / withdraw), next to the balances in the lobby header, on any\n// web3 title — EVM or Solana, the panel is the same and picks the chain by itself.\n//\n// Where the game runs decides what the button does (owner, 2026-09-29):\n//  - inside idosgames.com's frame — crypto goes through the SITE's wallet card only, so the button\n//    asks the page to show it (`openPlatformWalletPanel`); the game never opens a wallet there;\n//  - framed by somebody else's site — no button: there is no wallet of ours to show;\n//  - by its own link (`{id}.idos.games`, a custom domain, the AI Coder preview) — the game's own\n//    panel with its own wallet connection.\n//\n// Import is \"@idosgames/wallet/react/lazy\", NOT \"@idosgames/wallet/react\": the latter pulls Reown\n// AppKit into the startup graph. The wallet config is memoised per project id, so a wallet connected\n// on the sign-in screen is already connected here.\n\nexport function WalletButton(): ReactNode {\n  const client = useIDosGamesClient();\n  const kit = useUiKit();\n  const layout = useGameLayout();\n  const [open, setOpen] = useState(false);\n  const embedded = isEmbeddedInPlatform();\n\n  if (isEmbeddedOnForeignSite()) return null;\n\n  return (\n    <>\n      <button\n        type=\"button\"\n        className=\"idos-press\"\n        aria-label={t(\"wallet\")}\n        onClick={() => {\n          kit.play(\"click\");\n          if (embedded) void openPlatformWalletPanel();\n          else setOpen(true);\n        }}\n        style={chip}\n        data-tutorial-anchor=\"lobby:wallet\"\n      >\n        <Icon glyph=\"👛\" size={layout === \"phone\" ? 26 : 22} />\n        {layout !== \"phone\" ? <span>{t(\"wallet\")}</span> : null}\n      </button>\n      {open && !embedded ? (\n        <Popup title={t(\"wallet\")} onClose={() => setOpen(false)} width={420}>\n          <LazyWalletPanel client={client} appName=\"iDosGames\" />\n        </Popup>\n      ) : null}\n    </>\n  );\n}\n\nconst chip: CSSProperties = {\n  ...outlined,\n  display: \"inline-flex\",\n  alignItems: \"center\",\n  gap: 6,\n  padding: \"3px 10px 3px 5px\",\n  borderRadius: 999,\n  ...well,\n  cursor: \"pointer\",\n  whiteSpace: \"nowrap\",\n  fontSize: 14,\n};\n"
-    },
-    {
-      "path": "src/base/login/loginIcons.ts",
-      "content": "import type { CSSProperties } from \"react\";\nimport { markDataUrl } from \"./logo\";\n\n// Icons of the sign-in buttons (./LoginScreen), inlined as SVG data-URIs like the logo: no asset\n// pipeline and no image files in the project.\n//\n// The provider marks (Google, Telegram) keep the providers' own colours - they tell the player which\n// account the button uses, and Google asks for exactly that mark. Everything else (wallet, iDos,\n// Apple, e-mail, guest) is ONE colour taken from the theme (src/ui.config.ts): an image cannot read a\n// CSS variable, so the screen builds these with the resolved colours.\n\nconst svg = (body: string, viewBox = \"0 0 24 24\"): string =>\n  `data:image/svg+xml;utf8,${encodeURIComponent(\n    `<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"${viewBox}\">${body}</svg>`,\n  )}`;\n\nconst line = (paths: string, color: string): string =>\n  svg(\n    `<g fill=\"none\" stroke=\"${color}\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">${paths}</g>`,\n  );\n\n/** `ink` — text on the secondary buttons, `onPrimary` — text on the primary (wallet) button. */\nexport const loginIcons = ({\n  ink,\n  dim,\n  onPrimary,\n}: {\n  ink: string;\n  dim: string;\n  onPrimary: string;\n}) => ({\n  wallet: line(\n    '<path d=\"M19 7V4a1 1 0 0 0-1-1H5a2 2 0 0 0 0 4h15a1 1 0 0 1 1 1v4h-3a2 2 0 0 0 0 4h3a1 1 0 0 0 1-1v-2a1 1 0 0 0-1-1\"/><path d=\"M3 5v14a2 2 0 0 0 2 2h15a1 1 0 0 0 1-1v-4\"/>',\n    onPrimary,\n  ),\n  idos: markDataUrl(ink),\n  // The multicolor G on a white disc: on the translucent button it would lose its colors.\n  google: svg(\n    '<circle cx=\"24\" cy=\"24\" r=\"24\" fill=\"#fff\"/><g transform=\"translate(9 9) scale(.625)\"><path fill=\"#FFC107\" d=\"M43.611 20.083H42V20H24v8h11.303c-1.649 4.657-6.08 8-11.303 8-6.627 0-12-5.373-12-12s5.373-12 12-12c3.059 0 5.842 1.154 7.961 3.039l5.657-5.657C34.046 6.053 29.268 4 24 4 12.955 4 4 12.955 4 24s8.955 20 20 20 20-8.955 20-20c0-1.341-.138-2.65-.389-3.917z\"/><path fill=\"#FF3D00\" d=\"m6.306 14.691 6.571 4.819C14.655 15.108 18.961 12 24 12c3.059 0 5.842 1.154 7.961 3.039l5.657-5.657C34.046 6.053 29.268 4 24 4 16.318 4 9.656 8.337 6.306 14.691z\"/><path fill=\"#4CAF50\" d=\"M24 44c5.166 0 9.86-1.977 13.409-5.192l-6.19-5.238A11.91 11.91 0 0 1 24 36c-5.202 0-9.619-3.317-11.283-7.946l-6.522 5.025C9.505 39.556 16.227 44 24 44z\"/><path fill=\"#1976D2\" d=\"M43.611 20.083H42V20H24v8h11.303a12.04 12.04 0 0 1-4.087 5.571l.003-.002 6.19 5.238C36.971 39.205 44 34 44 24c0-1.341-.138-2.65-.389-3.917z\"/></g>',\n    \"0 0 48 48\",\n  ),\n  apple: svg(\n    `<path fill=\"${ink}\" d=\"M12.152 6.896c-.948 0-2.415-1.078-3.96-1.04-2.04.027-3.91 1.183-4.961 3.014-2.117 3.675-.546 9.103 1.519 12.09 1.013 1.454 2.208 3.09 3.792 3.039 1.52-.065 2.09-.987 3.935-.987 1.831 0 2.35.987 3.96.948 1.637-.026 2.676-1.48 3.676-2.948 1.156-1.688 1.636-3.325 1.662-3.415-.039-.013-3.182-1.221-3.22-4.857-.026-3.04 2.48-4.494 2.597-4.559-1.429-2.09-3.623-2.324-4.39-2.376-2-.156-3.675 1.09-4.61 1.09zM15.53 3.83c.843-1.012 1.4-2.427 1.245-3.83-1.207.052-2.662.805-3.532 1.818-.78.896-1.454 2.338-1.273 3.714 1.338.104 2.715-.688 3.559-1.701\"/>`,\n  ),\n  // Telegram's own mark: the blue disc with the white plane (the path is the disc with the plane cut\n  // out, so the plane shows the white circle under it).\n  telegram: svg(\n    '<circle cx=\"12\" cy=\"12\" r=\"11\" fill=\"#fff\"/><path fill=\"#27a7e7\" d=\"M11.944 0A12 12 0 0 0 0 12a12 12 0 0 0 12 12 12 12 0 0 0 12-12A12 12 0 0 0 12 0a12 12 0 0 0-.056 0zm4.962 7.224c.1-.002.321.023.465.14a.506.506 0 0 1 .171.325c.016.093.036.306.02.472-.18 1.898-.962 6.502-1.36 8.627-.168.9-.499 1.201-.82 1.23-.696.065-1.225-.46-1.9-.902-1.056-.693-1.653-1.124-2.678-1.8-1.185-.78-.417-1.21.258-1.91.177-.184 3.247-2.977 3.307-3.23.007-.032.014-.15-.056-.212s-.174-.041-.249-.024c-.106.024-1.793 1.14-5.061 3.345-.48.33-.913.49-1.302.48-.428-.008-1.252-.241-1.865-.44-.752-.245-1.349-.374-1.297-.789.027-.216.325-.437.893-.663 3.498-1.524 5.83-2.529 6.998-3.014 3.332-1.386 4.025-1.627 4.476-1.635z\"/>',\n  ),\n  email: line(\n    '<rect width=\"20\" height=\"16\" x=\"2\" y=\"4\" rx=\"2\"/><path d=\"m22 7-8.97 5.7a1.94 1.94 0 0 1-2.06 0L2 7\"/>',\n    ink,\n  ),\n  guest: line(\n    '<circle cx=\"12\" cy=\"8\" r=\"5\"/><path d=\"M20 21a8 8 0 0 0-16 0\"/>',\n    dim,\n  ),\n});\n\n/**\n * An icon at the left edge of a full-width button, with the label kept centered: the same padding\n * on both sides. A background, not a child element, so it also fits the wallet button, whose\n * content the wallet package draws and only takes a `style` from here.\n */\nexport function withIcon(icon: string, under?: string): CSSProperties {\n  // `under` — the button's own fill (a gradient), kept as a second image layer below the icon.\n  return {\n    backgroundImage: under ? `url(\"${icon}\"), ${under}` : `url(\"${icon}\")`,\n    backgroundRepeat: \"no-repeat\",\n    backgroundPosition: under ? \"14px center, 0 0\" : \"14px center\",\n    backgroundSize: under ? \"20px 20px, 100% 100%\" : \"20px 20px\",\n    paddingLeft: \"44px\",\n    paddingRight: \"44px\",\n  };\n}\n"
-    },
-    {
-      "path": "src/base/login/LoginScreen.tsx",
-      "content": "import {\n  useEffect,\n  useMemo,\n  useState,\n  type CSSProperties,\n  type ReactNode,\n} from \"react\";\nimport {\n  AuthType,\n  beginSsoRedirect,\n  type AuthOptionsResponse,\n} from \"@idosgames/core\";\nimport type { LoginScreenProps } from \"@idosgames/app-shell\";\nimport { ENV_GOOGLE_CLIENT_ID } from \"../../env\";\nimport {\n  buttonStyle,\n  outlined,\n  panel,\n  screenBackground,\n  useUiKit,\n  v,\n} from \"@idosgames/react/ui\";\nimport { logoDataUrl } from \"./logo\";\nimport { loginIcons, withIcon } from \"./loginIcons\";\n\n// The Login scene. The host runtime owns WHEN this is shown (the auth gate in\n// @idosgames/app-shell); this file owns what it LOOKS like and which providers it offers.\n// Edit freely — branding, layout, copy, buttons. Colours, fonts and corner radii are NOT set here: they\n// come from the theme in src/ui.config.ts (the same tokens the lobby and every system use), so a new\n// look is one edit there and sign-in follows it.\n//\n// Providers on `client.auth`: loginWithDeviceID (guest), loginWithEmail + registerWithEmail,\n// loginWithGoogle, loginWithApple, loginWithTelegram, loginWithWallet, loginWithSsoCode, plus\n// forgotPassword/resetPassword.\n//\n// A provider is only rendered when it can actually complete, so players never meet a dead button:\n//   guest / email - always available, no external setup (guest only on an open title).\n//   Google        - the title's own Google sign-in (platform setting) or VITE_IDOS_GOOGLE_CLIENT_ID;\n//                   the Google Identity script is loaded on demand.\n//   Apple         - when the title set up Sign in with Apple for the web (a Services ID).\n//   Telegram      - only inside a Telegram Mini App (it signs in with the app's initData).\n//   wallet        - always offered; ./walletLogin owns the wagmi config and the challenge network.\n//   iDos Games    - only where the platform accepts a return_to (see isSsoAvailable below).\n//\n// The title's login mode decides the rest (platform setting: Blockchain -> login mode):\n//   Open                - every method;\n//   AnyWithLinkedWallet - every method except guest (a guest cannot link a wallet);\n//   WalletOnly          - the wallet and iDos Games only: an iDos Games account plays with a wallet\n//                         linked to it (one wallet - one account), everything else is refused.\n\n// Куда платформа соглашается вернуть одноразовый код. Список повторяет allowlist на бэкенде\n// (SsoService.AllowedOrigins) НАМЕРЕННО: здесь он решает только, показывать ли кнопку, а\n// настоящий барьер стоит на сервере. Показать кнопку там, где сервер откажет, — значит\n// пообещать игроку вход, который не состоится.\nconst SSO_ORIGINS = [\n  \"https://cloud.idosgames.com\",\n  \"https://idosgames.com\",\n  \"https://www.idosgames.com\",\n];\n\n// Свои адреса игры: {titleid}.idos.games и {titleid}-dev.idos.games (её DEV-копия). Сервер примет\n// каждый ТОЛЬКО для этого же тайтла.\nconst GAME_HOST = /^https:\\/\\/[a-z0-9]{8}(-dev)?\\.idos\\.games$/;\n\nfunction isSsoAvailable(): boolean {\n  if (typeof window === \"undefined\") return false;\n  const { origin } = window.location;\n  if (SSO_ORIGINS.includes(origin) || GAME_HOST.test(origin)) return true;\n\n  // Свой домен издателя (play.brand.com) id тайтла не несёт, и по origin не понять, сработает ли\n  // вход. Страницу, которую отдаёт платформа, её сервер помечает этой меткой — а на свой домен он\n  // отдаёт игру, только когда домен подключён к ЭТОМУ тайтлу. В превью и на чужом хостинге метки нет.\n  return (\n    typeof document !== \"undefined\" &&\n    document.querySelector('meta[name=\"idos-game-host\"]') !== null\n  );\n}\n\nexport interface LoginScreenExtras {\n  /**\n   * Wallet sign-in. Supplied by ./walletLogin (wired in main.tsx), which renders the ready-made\n   * `WalletLogin` from `@idosgames/wallet/react`: connect → sign the challenge → session, then\n   * `onAuthenticated()`. The screen passes its own `style` so the button matches the theme.\n   *\n   * A remembered wallet session comes back on the next launch by its refresh token (no new\n   * signature); the server re-checks the token balance on it when the title's login mode needs one.\n   */\n  renderWalletLogin?: (props: {\n    client: LoginScreenProps[\"client\"];\n    onAuthenticated: () => void;\n    disabled: boolean;\n    style?: CSSProperties;\n  }) => ReactNode;\n}\n\n/** Пауза повторной отправки, когда сервер её не назвал. Совпадает со значением платформы. */\nconst DEFAULT_RESEND_COOLDOWN = 60;\n\n/**\n * Служебный код отказа → фраза, которую можно показать игроку.\n *\n * ⚠ Без этого экран входа показывал коды КАК ЕСТЬ: игрок видел «EMAIL_SENDER_NOT_CONFIGURED» или\n * «VERIFICATION_CODE_ATTEMPTS_EXCEEDED» вместо объяснения. Это шаблон, с которого начинается\n * каждая игра издателя, поэтому такое уезжает сразу всем.\n *\n * Незнакомый код возвращается как есть — намеренно: издателю на стенде он полезнее, чем общая\n * фраза «что-то пошло не так», а список ниже растёт по мере появления новых.\n */\nfunction humanizeAuthError(code: string | undefined): string {\n  switch (code) {\n    case \"EMAIL_SENDER_NOT_CONFIGURED\":\n      return \"Sign-in by e-mail is unavailable in this game right now. Try another way to sign in.\";\n    case \"INVALID_VERIFICATION_CODE\":\n      return \"That code is not right. Check the e-mail and try again.\";\n    case \"VERIFICATION_CODE_ATTEMPTS_EXCEEDED\":\n      return \"Too many wrong attempts. Ask for a new code.\";\n    case \"INCORRECT_EMAIL_OR_PASSWORD\":\n      return \"Wrong e-mail or password.\";\n    case \"INCORRECT_EMAIL\":\n      return \"That does not look like an e-mail address.\";\n    case \"PASSWORD_LENGTH_INVALID\":\n      return \"The password must be 8 to 100 characters long.\";\n    case \"TOO_MANY_FAILED_ATTEMPTS\":\n      return \"Too many attempts. Please try again a little later.\";\n    case \"RATE_LIMIT_EXCEEDED\":\n      return \"Too many requests. Please try again in a moment.\";\n    case \"PLAY_ACCESS_WALLET_LOGIN_ONLY\":\n      return \"This game can only be entered with a crypto wallet or your iDos Games account.\";\n    case \"PLAY_ACCESS_WALLET_USED_BY_ANOTHER_ACCOUNT\":\n      return \"This wallet already plays with another account.\";\n    case \"WALLET_UNLINK_COOLDOWN\":\n      return \"This wallet was unlinked from another account less than 7 days ago. Try again after the 7 days.\";\n    case \"APPLE_EMAIL_MISSING\":\n      return \"Apple did not share an e-mail address. Try again and allow it, or use another way to sign in.\";\n    case \"PLAY_ACCESS_GUEST_DISABLED\":\n      return \"Guest play is off in this game. Sign in to link a crypto wallet.\";\n    case \"PLAY_ACCESS_CHECK_FAILED\":\n      return \"Could not check your token balance right now. Please try again in a moment.\";\n    default:\n      return code ?? \"Something went wrong. Please try again.\";\n  }\n}\n\ntype Mode = \"menu\" | \"email\" | \"verify\" | \"forgot\" | \"reset\";\n\nconst GOOGLE_SCRIPT = \"https://accounts.google.com/gsi/client\";\nconst APPLE_SCRIPT =\n  \"https://appleid.cdn-apple.com/appleauth/static/jsapi/appleid/1/en_US/appleid.auth.js\";\n\n/** Loads a provider's script once; resolves when it has run. */\nfunction loadScript(src: string): Promise<void> {\n  if (typeof document === \"undefined\")\n    return Promise.reject(new Error(\"no document\"));\n  const existing = document.querySelector<HTMLScriptElement>(\n    `script[src=\"${src}\"]`,\n  );\n  if (existing?.dataset.loaded === \"1\") return Promise.resolve();\n  return new Promise((resolve, reject) => {\n    const el = existing ?? document.createElement(\"script\");\n    el.addEventListener(\"load\", () => {\n      el.dataset.loaded = \"1\";\n      resolve();\n    });\n    el.addEventListener(\"error\", () =>\n      reject(new Error(`could not load ${src}`)),\n    );\n    if (!existing) {\n      el.src = src;\n      el.async = true;\n      document.head.appendChild(el);\n    }\n  });\n}\n\n/** A random nonce for the provider's request: the server checks the token carries it, then burns it. */\nfunction randomNonce(): string {\n  const bytes = new Uint8Array(16);\n  crypto.getRandomValues(bytes);\n  return Array.from(bytes, (b) => b.toString(16).padStart(2, \"0\")).join(\"\");\n}\n\n/** Inside a Telegram Mini App the app hands over signed initData - the one thing Telegram login needs. */\nfunction hasTelegramInitData(): boolean {\n  const tg = (globalThis as { Telegram?: { WebApp?: { initData?: string } } })\n    .Telegram;\n  return Boolean(tg?.WebApp?.initData);\n}\n\n/** Minimal Sign in with Apple JS surface - declared here so the template needs no Apple typings. */\ntype AppleIdentity = {\n  auth: {\n    init(config: {\n      clientId: string;\n      scope: string;\n      redirectURI: string;\n      usePopup: boolean;\n      nonce?: string;\n    }): void;\n    signIn(): Promise<{\n      authorization: { id_token: string };\n      user?: { name?: { firstName?: string; lastName?: string } };\n    }>;\n  };\n};\n\n/** Minimal Google Identity surface — declared here so the template needs no @types/google.accounts. */\ntype GoogleIdentity = {\n  accounts: {\n    id: {\n      initialize(config: {\n        client_id: string;\n        callback: (response: { credential?: string }) => void;\n      }): void;\n      prompt(): void;\n    };\n  };\n};\n\nexport function LoginScreen({\n  client,\n  onAuthenticated,\n  renderWalletLogin,\n}: LoginScreenProps & LoginScreenExtras): ReactNode {\n  const [mode, setMode] = useState<Mode>(\"menu\");\n  const [busy, setBusy] = useState(false);\n  const [error, setError] = useState<string | null>(null);\n\n  const [email, setEmail] = useState(\"\");\n  const [password, setPassword] = useState(\"\");\n  const [registering, setRegistering] = useState(false);\n  const [code, setCode] = useState(\"\");\n  const [resendIn, setResendIn] = useState(0);\n  const [resendCooldown, setResendCooldown] = useState(DEFAULT_RESEND_COOLDOWN);\n\n  const [remember, setRemember] = useState(true);\n  // Images cannot read CSS variables — the logo and the icons are painted with the resolved theme.\n  const theme = useUiKit().config.theme;\n  const logo = useMemo(() => logoDataUrl(theme.text), [theme.text]);\n  const icons = useMemo(\n    () =>\n      loginIcons({\n        ink: theme.text,\n        dim: theme.textDim,\n        onPrimary: theme.onGreen,\n      }),\n    [theme.text, theme.textDim, theme.onGreen],\n  );\n\n  const [notice, setNotice] = useState<string | null>(null);\n\n  // The title's sign-in settings, read before login: the login mode (so the screen never offers a\n  // method the server refuses anyway) and which providers the title set up (Google, Apple). Until\n  // they arrive the open-title set is shown - the server check is the real barrier, this only\n  // keeps dead buttons off the screen.\n  const [options, setOptions] = useState<AuthOptionsResponse | null>(null);\n  useEffect(() => {\n    let active = true;\n    void client.auth.getAuthOptions().then((result) => {\n      if (active && result.ok) setOptions(result.data);\n    });\n    return () => {\n      active = false;\n    };\n  }, [client]);\n  const loginMode = options?.PlayAccessMode ?? \"Open\";\n  const walletOnly = loginMode === \"WalletOnly\";\n  const guestAllowed = loginMode === \"Open\";\n  const googleClientID =\n    ENV_GOOGLE_CLIENT_ID ||\n    (options?.Google?.Enabled ? (options.Google.WebClientID ?? \"\") : \"\");\n  const appleServiceID = options?.Apple?.Enabled\n    ? (options.Apple.ServiceID ?? \"\")\n    : \"\";\n  const telegram = hasTelegramInitData();\n  const sso = isSsoAvailable();\n\n  /**\n   * «Continue with iDos Games»: сначала уже имеющаяся сессия, и только без неё — за новым кодом на\n   * сайт (решение владельца 02.10.2026). Новый вход — это новая сессия в движке, а лимит устройств\n   * тайтла по умолчанию одно: лишний вход вытесняет живую сессию этого же игрока (другую вкладку,\n   * телефон) и стоит ухода со страницы. Живой refresh-токен продлевается одним запросом.\n   *\n   * Без живого токена `autoLogin()` для входа через iDos Games просто отказывает — в гостя он не\n   * уводит (`replay` такой вход не повторяет), поэтому дальше идёт обычный уход на /sso.\n   */\n  const continueWithIdosGames = async (): Promise<void> => {\n    if (client.auth.lastAuthType === AuthType.iDosGames) {\n      setBusy(true);\n      setError(null);\n      const resumed = await client.auth.autoLogin();\n      if (resumed.ok) {\n        onAuthenticated();\n        return;\n      }\n      setBusy(false);\n    }\n    beginSsoRedirect({ titleID: client.titleID });\n  };\n\n  /** Every provider goes through here, so one place owns the busy flag and the error surface. */\n  const run = async (\n    login: () => Promise<{ ok: boolean; error?: string }>,\n  ): Promise<void> => {\n    setBusy(true);\n    setError(null);\n    // \"Remember me\" is read when the login completes, so set it before starting one. Off = this\n    // session works normally but is not written to storage, so the next launch lands here again.\n    client.auth.setRememberSession(remember);\n    const result = await login();\n    if (result.ok) {\n      onAuthenticated();\n      return;\n    }\n    setError(\n      humanizeAuthError(result.error) ?? \"Sign-in failed. Please try again.\",\n    );\n    setBusy(false);\n  };\n\n  /**\n   * Регистрация — единственный провайдер, который НЕ обязательно заканчивается входом.\n   *\n   * Когда тайтл требует подтверждения адреса (а это значение платформы), сервер только отправляет\n   * код, и аккаунта ещё нет. Поэтому она идёт мимо `run`: тот на успехе сразу зовёт\n   * `onAuthenticated()`, а здесь на успехе надо показать экран ввода кода.\n   */\n  const register = async (): Promise<void> => {\n    setBusy(true);\n    setError(null);\n    client.auth.setRememberSession(remember);\n\n    const result = await client.auth.registerWithEmail(email, password);\n\n    if (!result.ok) {\n      setError(\n        humanizeAuthError(result.error) ?? \"Sign-up failed. Please try again.\",\n      );\n      setBusy(false);\n      return;\n    }\n\n    // Аккаунта ещё нет — он появится на подтверждении. Уйти в игру здесь значило бы показать\n    // пустую сессию.\n    setCode(\"\");\n\n    // Паузу задаёт СЕРВЕР (её настраивает издатель), поэтому запоминаем её и дальше берём\n    // отсюда. Раньше первый отсчёт шёл от ответа, а каждый следующий — от захардкоженных 60\n    // секунд: у тайтла с другой настройкой кнопка либо открывалась раньше, чем сервер согласен\n    // слать (нажатие впустую, ответ всё равно успешный), либо держалась закрытой дольше нужного.\n    const cooldown = result.data.resendCooldownSeconds ?? 0;\n    setResendCooldown(cooldown > 0 ? cooldown : DEFAULT_RESEND_COOLDOWN);\n\n    setResendIn(cooldown);\n    setMode(\"verify\");\n    setBusy(false);\n  };\n\n  const resendCode = async (): Promise<void> => {\n    setBusy(true);\n    setError(null);\n\n    const result = await client.auth.resendVerificationCode(email);\n\n    // Ответ почти всегда успешный — начата регистрация или нет, выдержана пауза или нет. Иначе\n    // эта кнопка отвечала бы на вопрос «заведён ли такой адрес». Поэтому и таймер заводим всегда.\n    //\n    // ⚠ Но ОДИН отказ отсюда приходит и его нельзя глотать: «слать нечем» (у тайтла и у\n    // платформы нет отправителя). Он про конфигурацию сервера, а не про адрес, поэтому и\n    // безопасен, и обязателен — иначе игрок жмёт кнопку до посинения, ожидая письма, которого\n    // никто не отправлял.\n    if (!result.ok) setError(humanizeAuthError(result.error));\n\n    setResendIn(resendCooldown);\n    setBusy(false);\n  };\n\n  // Обратный отсчёт до следующей отправки. Без него игрок жмёт «ещё раз» вслепую, а сервер молча\n  // отказывает — и выглядит это как сломанная кнопка.\n  useEffect(() => {\n    if (resendIn <= 0) return;\n    const id = setTimeout(() => setResendIn((v) => v - 1), 1000);\n    return () => clearTimeout(id);\n  }, [resendIn]);\n\n  const signInWithGoogle = async (): Promise<void> => {\n    try {\n      await loadScript(GOOGLE_SCRIPT);\n    } catch {\n      // Handled below: no global means the script is unavailable.\n    }\n    const google = (globalThis as { google?: GoogleIdentity }).google;\n    if (!google) {\n      setError(\n        \"Google sign-in is unavailable: the Google Identity script did not load.\",\n      );\n      return;\n    }\n    setError(null);\n    google.accounts.id.initialize({\n      client_id: googleClientID,\n      callback: (response) => {\n        if (!response.credential) {\n          setError(\"Google sign-in was cancelled.\");\n          return;\n        }\n        void run(() => client.auth.loginWithGoogle(response.credential ?? \"\"));\n      },\n    });\n    google.accounts.id.prompt();\n  };\n\n  const signInWithApple = async (): Promise<void> => {\n    setError(null);\n    try {\n      await loadScript(APPLE_SCRIPT);\n    } catch {\n      setError(\"Apple sign-in is unavailable: the Apple script did not load.\");\n      return;\n    }\n    const apple = (globalThis as { AppleID?: AppleIdentity }).AppleID;\n    if (!apple) {\n      setError(\"Apple sign-in is unavailable: the Apple script did not load.\");\n      return;\n    }\n    const nonce = randomNonce();\n    apple.auth.init({\n      clientId: appleServiceID,\n      scope: \"name email\",\n      // Must be a return URL registered for this Services ID; with a popup Apple only checks it.\n      redirectURI: `${window.location.origin}/`,\n      usePopup: true,\n      nonce,\n    });\n    try {\n      const response = await apple.auth.signIn();\n      const name = [\n        response.user?.name?.firstName,\n        response.user?.name?.lastName,\n      ]\n        .filter(Boolean)\n        .join(\" \");\n      await run(() =>\n        client.auth.loginWithApple(response.authorization.id_token, {\n          nonce,\n          name,\n        }),\n      );\n    } catch {\n      // The player closed Apple's window - nothing to report.\n    }\n  };\n\n  /** \"Forgot password\": the server e-mails a code; the next step sets the new password with it. */\n  const sendResetCode = async (): Promise<void> => {\n    setBusy(true);\n    setError(null);\n    const result = await client.auth.forgotPassword(email);\n    setBusy(false);\n    // Like the resend: the answer does not say whether the address has an account - except \"there\n    // is nothing to send with\", which is about the server and must be shown.\n    if (!result.ok && result.error === \"EMAIL_SENDER_NOT_CONFIGURED\") {\n      setError(humanizeAuthError(result.error));\n      return;\n    }\n    setCode(\"\");\n    setPassword(\"\");\n    setMode(\"reset\");\n  };\n\n  const resetPassword = async (): Promise<void> => {\n    setBusy(true);\n    setError(null);\n    const result = await client.auth.resetPassword(\n      email,\n      code.trim(),\n      password,\n    );\n    setBusy(false);\n    if (!result.ok) {\n      setError(humanizeAuthError(result.error));\n      return;\n    }\n    setPassword(\"\");\n    setNotice(\"Password changed. Sign in with the new one.\");\n    setMode(\"email\");\n  };\n\n  return (\n    <div style={styles.root}>\n      {/* Placeholder color is a pseudo-element, unreachable from inline styles — this one rule is\n          the whole reason for the style tag. */}\n      <style>{`.idos-input::placeholder { color: ${v.textDim}; opacity: 1; }`}</style>\n      <div style={styles.card}>\n        <img src={logo} alt=\"iDos Games\" style={styles.logo} />\n        <h1 style={styles.title}>Sign in</h1>\n\n        {mode === \"menu\" && (\n          <div style={styles.stack}>\n            {renderWalletLogin?.({\n              client,\n              onAuthenticated,\n              disabled: busy,\n              style: {\n                ...styles.button,\n                ...styles.primary,\n                ...withIcon(icons.wallet, PRIMARY_FILL),\n              },\n            })}\n\n            {/* Вход платформенным аккаунтом: уходим на idosgames.com/sso и возвращаемся сюда\n                с одноразовым кодом, который AuthGate обменяет сам. Кнопка нужна только тем,\n                кто открыл игру НАПРЯМУЮ: пришедший с сайта уже вернулся с кодом и этот экран\n                не увидит вовсе.\n\n                Скрыта там, где SSO заведомо откажет — бэкенд принимает return_to только со\n                своих origin'ов, и в превью/на localhost показывать кнопку значило бы обещать\n                игроку то, что не сработает. */}\n            {sso && (\n              <button\n                type=\"button\"\n                style={{ ...styles.button, ...withIcon(icons.idos) }}\n                onClick={() => void continueWithIdosGames()}\n                disabled={busy}\n              >\n                Continue with iDos Games\n              </button>\n            )}\n\n            {walletOnly && sso && (\n              <p style={styles.hint}>\n                Signing in with iDos Games? Link your wallet after that - the\n                game is played with a wallet.\n              </p>\n            )}\n\n            {!walletOnly && googleClientID && (\n              <button\n                type=\"button\"\n                style={{ ...styles.button, ...withIcon(icons.google) }}\n                onClick={() => void signInWithGoogle()}\n                disabled={busy}\n              >\n                Continue with Google\n              </button>\n            )}\n\n            {!walletOnly && appleServiceID && (\n              <button\n                type=\"button\"\n                style={{ ...styles.button, ...withIcon(icons.apple) }}\n                onClick={() => void signInWithApple()}\n                disabled={busy}\n              >\n                Continue with Apple\n              </button>\n            )}\n\n            {!walletOnly && telegram && (\n              <button\n                type=\"button\"\n                style={{ ...styles.button, ...withIcon(icons.telegram) }}\n                onClick={() => void run(() => client.auth.loginWithTelegram())}\n                disabled={busy}\n              >\n                Continue with Telegram\n              </button>\n            )}\n\n            {!walletOnly && (\n              <button\n                type=\"button\"\n                style={{ ...styles.button, ...withIcon(icons.email) }}\n                onClick={() => setMode(\"email\")}\n                disabled={busy}\n              >\n                Continue with email\n              </button>\n            )}\n\n            {guestAllowed && (\n              <button\n                type=\"button\"\n                style={styles.ghost}\n                onClick={() => void run(() => client.auth.loginWithDeviceID())}\n                disabled={busy}\n              >\n                <span style={styles.inlineIcon}>\n                  <img src={icons.guest} alt=\"\" width={18} height={18} />\n                  {busy ? \"Signing in…\" : \"Play as guest\"}\n                </span>\n              </button>\n            )}\n          </div>\n        )}\n\n        {mode === \"email\" && (\n          <div style={styles.stack}>\n            <input\n              className=\"idos-input\"\n              style={styles.input}\n              type=\"email\"\n              placeholder=\"Email\"\n              value={email}\n              onChange={(e) => setEmail(e.target.value)}\n              disabled={busy}\n              autoFocus\n            />\n            <input\n              className=\"idos-input\"\n              style={styles.input}\n              type=\"password\"\n              placeholder=\"Password\"\n              value={password}\n              onChange={(e) => setPassword(e.target.value)}\n              disabled={busy}\n            />\n            <button\n              type=\"button\"\n              style={{ ...styles.button, ...styles.primary }}\n              onClick={() =>\n                registering\n                  ? void register()\n                  : void run(() => client.auth.loginWithEmail(email, password))\n              }\n              disabled={busy || !email || !password}\n            >\n              {busy\n                ? \"Please wait…\"\n                : registering\n                  ? \"Create account\"\n                  : \"Sign in\"}\n            </button>\n            <button\n              type=\"button\"\n              style={styles.ghost}\n              onClick={() => setRegistering((v) => !v)}\n              disabled={busy}\n            >\n              {registering ? \"I already have an account\" : \"Create an account\"}\n            </button>\n            {!registering && (\n              <button\n                type=\"button\"\n                style={styles.ghost}\n                onClick={() => {\n                  setMode(\"forgot\");\n                  setError(null);\n                  setNotice(null);\n                }}\n                disabled={busy}\n              >\n                Forgot password?\n              </button>\n            )}\n            <button\n              type=\"button\"\n              style={styles.ghost}\n              onClick={() => {\n                setMode(\"menu\");\n                setError(null);\n              }}\n              disabled={busy}\n            >\n              Back\n            </button>\n          </div>\n        )}\n\n        {mode === \"verify\" && (\n          <div style={styles.stack}>\n            <p style={styles.hint}>\n              We sent a code to <strong>{email}</strong>. Enter it to finish\n              creating your account.\n            </p>\n            <input\n              className=\"idos-input\"\n              style={styles.input}\n              type=\"text\"\n              inputMode=\"numeric\"\n              autoComplete=\"one-time-code\"\n              placeholder=\"Confirmation code\"\n              value={code}\n              onChange={(e) => setCode(e.target.value)}\n              disabled={busy}\n              autoFocus\n            />\n            <button\n              type=\"button\"\n              style={{ ...styles.button, ...styles.primary }}\n              onClick={() =>\n                void run(() =>\n                  client.auth.confirmEmailRegistration(email, code),\n                )\n              }\n              disabled={busy || !code}\n            >\n              {busy ? \"Please wait…\" : \"Confirm\"}\n            </button>\n            <button\n              type=\"button\"\n              style={styles.ghost}\n              onClick={() => void resendCode()}\n              disabled={busy || resendIn > 0}\n            >\n              {resendIn > 0\n                ? `Send again in ${resendIn}s`\n                : \"Send the code again\"}\n            </button>\n            <button\n              type=\"button\"\n              style={styles.ghost}\n              onClick={() => {\n                setMode(\"email\");\n                setError(null);\n              }}\n              disabled={busy}\n            >\n              Back\n            </button>\n          </div>\n        )}\n\n        {mode === \"forgot\" && (\n          <div style={styles.stack}>\n            <p style={styles.hint}>\n              Enter your e-mail - we will send a code to set a new password.\n            </p>\n            <input\n              className=\"idos-input\"\n              style={styles.input}\n              type=\"email\"\n              placeholder=\"Email\"\n              value={email}\n              onChange={(e) => setEmail(e.target.value)}\n              disabled={busy}\n              autoFocus\n            />\n            <button\n              type=\"button\"\n              style={{ ...styles.button, ...styles.primary }}\n              onClick={() => void sendResetCode()}\n              disabled={busy || !email}\n            >\n              {busy ? \"Please wait...\" : \"Send the code\"}\n            </button>\n            <button\n              type=\"button\"\n              style={styles.ghost}\n              onClick={() => {\n                setMode(\"email\");\n                setError(null);\n              }}\n              disabled={busy}\n            >\n              Back\n            </button>\n          </div>\n        )}\n\n        {mode === \"reset\" && (\n          <div style={styles.stack}>\n            <p style={styles.hint}>\n              If <strong>{email}</strong> has an account, a code is on its way.\n              Enter it and choose a new password.\n            </p>\n            <input\n              className=\"idos-input\"\n              style={styles.input}\n              type=\"text\"\n              inputMode=\"numeric\"\n              autoComplete=\"one-time-code\"\n              placeholder=\"Code from the e-mail\"\n              value={code}\n              onChange={(e) => setCode(e.target.value)}\n              disabled={busy}\n              autoFocus\n            />\n            <input\n              className=\"idos-input\"\n              style={styles.input}\n              type=\"password\"\n              autoComplete=\"new-password\"\n              placeholder=\"New password\"\n              value={password}\n              onChange={(e) => setPassword(e.target.value)}\n              disabled={busy}\n            />\n            <button\n              type=\"button\"\n              style={{ ...styles.button, ...styles.primary }}\n              onClick={() => void resetPassword()}\n              disabled={busy || !code || !password}\n            >\n              {busy ? \"Please wait...\" : \"Set the new password\"}\n            </button>\n            <button\n              type=\"button\"\n              style={styles.ghost}\n              onClick={() => {\n                setMode(\"forgot\");\n                setError(null);\n              }}\n              disabled={busy}\n            >\n              Back\n            </button>\n          </div>\n        )}\n\n        {notice && !error && <p style={styles.hint}>{notice}</p>}\n\n        {/* Applies to every provider above: remembered sessions come back by their refresh token. */}\n        <label style={{ ...styles.remember, opacity: busy ? 0.6 : 1 }}>\n          <input\n            type=\"checkbox\"\n            checked={remember}\n            disabled={busy}\n            onChange={(e) => setRemember(e.target.checked)}\n            style={styles.switchInput}\n          />\n          <span\n            style={{\n              ...styles.switchTrack,\n              background: remember ? v.green : v.wellSoft,\n            }}\n          >\n            <span\n              style={{\n                ...styles.switchKnob,\n                left: remember ? \"21px\" : \"3px\",\n              }}\n            />\n          </span>\n          Remember me\n        </label>\n\n        {error && <p style={styles.error}>{error}</p>}\n      </div>\n    </div>\n  );\n}\n\n// The look is the theme's (src/ui.config.ts, through the UI kit's CSS variables): the screen's\n// gradient, a panel for the card, the kit's green button for the primary action, recessed fields.\n// Change the theme, not these values.\n\n/** The primary button's fill, drawn under the icon layer (see withIcon). */\nconst PRIMARY_FILL = `linear-gradient(180deg, ${v.green} 0%, ${v.greenDeep} 100%)`;\n\nconst styles: Record<string, CSSProperties> = {\n  root: {\n    position: \"absolute\",\n    inset: 0,\n    display: \"grid\",\n    // Centred by the card's auto margins, not placeItems: a card taller than the screen (a phone in\n    // landscape) then starts at the top and scrolls, instead of overflowing above it out of reach.\n    padding: \"16px\",\n    boxSizing: \"border-box\",\n    overflowY: \"auto\",\n    background: screenBackground,\n    color: v.text,\n    fontFamily: v.font,\n    fontSize: \"15px\",\n  },\n  card: {\n    ...panel,\n    margin: \"auto\",\n    width: \"min(360px, 90vw)\",\n    boxSizing: \"border-box\",\n    padding: \"24px 20px 18px\",\n    display: \"grid\",\n    gap: \"16px\",\n  },\n  logo: {\n    width: \"160px\",\n    justifySelf: \"center\",\n    userSelect: \"none\",\n    pointerEvents: \"none\",\n  },\n  remember: {\n    display: \"flex\",\n    alignItems: \"center\",\n    gap: \"10px\",\n    justifySelf: \"center\",\n    cursor: \"pointer\",\n    color: v.textDim,\n    fontWeight: 700,\n  },\n  // The switch: a hidden real checkbox (keyboard/a11y) with a drawn track + knob on top.\n  switchInput: { position: \"absolute\", opacity: 0, width: 0, height: 0 },\n  switchTrack: {\n    position: \"relative\",\n    width: \"42px\",\n    height: \"24px\",\n    borderRadius: \"12px\",\n    boxShadow: `inset 0 0 0 1px ${v.line}`,\n    transition: \"background 0.15s\",\n    flexShrink: 0,\n  },\n  switchKnob: {\n    position: \"absolute\",\n    top: \"3px\",\n    width: \"18px\",\n    height: \"18px\",\n    borderRadius: \"50%\",\n    background: \"#fff\",\n    boxShadow: \"0 1px 3px rgba(0, 0, 0, 0.3)\",\n    transition: \"left 0.15s\",\n  },\n  title: {\n    ...outlined,\n    margin: 0,\n    fontSize: \"24px\",\n    fontFamily: v.font,\n    textAlign: \"center\",\n  },\n  stack: { display: \"grid\", gap: \"10px\" },\n  button: {\n    padding: \"11px 16px\",\n    minHeight: \"46px\",\n    borderRadius: v.buttonRadius,\n    border: `1px solid ${v.line}`,\n    // backgroundColor, not the `background` shorthand: the shorthand would wipe the icon\n    // (backgroundImage from ./loginIcons) - here and on the wallet button, whose own default style\n    // uses the shorthand.\n    backgroundColor: v.wellSoft,\n    color: v.text,\n    font: \"inherit\",\n    fontWeight: 700,\n    cursor: \"pointer\",\n  },\n  // The kit's green button — its text colour and outline follow the theme — with the fill as an image\n  // layer, so an icon can sit on top of it.\n  primary: {\n    ...buttonStyle(\"green\"),\n    background: undefined,\n    backgroundImage: PRIMARY_FILL,\n    border: \"none\",\n    width: \"100%\",\n    font: \"inherit\",\n    fontWeight: 800,\n  },\n  ghost: {\n    padding: \"8px\",\n    border: \"none\",\n    background: \"none\",\n    color: v.textDim,\n    font: \"inherit\",\n    fontWeight: 700,\n    cursor: \"pointer\",\n  },\n  inlineIcon: {\n    display: \"inline-flex\",\n    alignItems: \"center\",\n    gap: \"8px\",\n  },\n  input: {\n    padding: \"12px 14px\",\n    borderRadius: v.buttonRadius,\n    border: `1px solid ${v.line}`,\n    background: v.well,\n    boxShadow: v.wellShadow,\n    color: v.text,\n    font: \"inherit\",\n    outline: \"none\",\n  },\n  error: { margin: 0, color: v.red, fontWeight: 700, textAlign: \"center\" },\n  hint: {\n    margin: 0,\n    color: v.textDim,\n    textAlign: \"center\",\n    fontSize: \"14px\",\n    lineHeight: 1.45,\n  },\n};\n"
-    },
-    {
-      "path": "src/base/login/logo.ts",
-      "content": "// The iDos Games logo, inlined as an SVG data-URI so it needs no asset pipeline: it survives the\n// template seed (text files only) and needs no image file in the project. Swap the paths to rebrand.\n// Painted in ONE colour passed in — the sign-in screen gives it the theme's text colour\n// (src/ui.config.ts), so the logo follows the theme instead of carrying its own.\n//\n// Composition mirrors the original brand mark: the spartan helmet on top, \"iDOS GAMES\" in one\n// line below it. The three path groups are the untouched brand-source paths (helmet / iDOS /\n// GAMES), positioned with transforms.\n\n// The helmet alone: the logo reuses it, and so does the small square mark (MARK_DATA_URL).\nconst HELMET_PATHS = `<path d=\"M147.333 12.333c-13.6 2.534-12.533 1.2-12.933 15.067l-.4 12.267-4.533-11.067c-2.534-6-5.067-10.933-5.734-10.933-2.666 0-27.866 8.666-36.533 12.666-11.733 5.334-26.667 14.8-36.133 22.934l-6.934 5.866L51.6 69.267c8.133 11.066 7.333 11.466-5.067 2.933-7.6-5.067-8.4-5.333-11.466-3.733-3.467 1.866-18.4 17.333-20.4 21.2-.8 1.6 7.066 8.8 33.733 30.933l34.667 28.933 8.8-8.266c14.666-13.867 28.666-22 48.133-28.267 9.067-2.933 14.8-3.733 28.533-4.4 34.267-1.333 60 7.467 81.6 28.133 21.6 20.4 34.934 49.6 37.467 81.734l.8 11.2 14.8 4.533c8.133 2.533 23.733 7.333 34.667 10.8 10.933 3.333 20.4 5.6 21.066 4.933 1.6-1.6 6.134-20.533 7.734-32.666.8-6 1.333-17.6 1.066-25.6l-.4-14.667-8-1.067c-4.4-.533-10.133-1.466-12.666-1.866l-4.667-.8 4.667-1.2c16.933-4.534 18.666-5.2 18.666-8 0-5.467-9.6-31.334-16.666-44.8-4-7.6-10.667-18.667-14.934-24.667-9.866-13.867-31.333-35.467-45.2-45.2-10.4-7.467-34.4-20.933-37.2-21.067-.8 0-4 4-7.333 8.8-3.2 4.8-6.133 8.134-6.4 7.334s.4-5.6 1.6-10.667c1.2-5.2 2.133-9.6 2.133-9.867 0-.933-19.866-6.133-34.4-9.066-14.8-2.934-49.333-4.4-59.6-2.534\"/><path d=\"M157.867 125.533c-21.067 3.334-42.134 14.8-57.467 31.334-13.333 14.133-13.733 12.8 5.6 22 9.2 4.4 16.667 8.266 16.667 8.533s-1.334.4-2.934.133c-13.866-2.133-41.6-5.866-41.733-5.6-.267.267-7.467 28.534-16.267 63.067l-16 62.667 7.334.4c4 .266 7.466.266 7.6 0 .266-.267 3.866-13.867 8.133-30.4 4.267-16.534 8.267-30.8 8.933-31.734.934-1.2 11.067-1.6 42.4-1.6 32.134 0 41.2.4 41.2 1.6 0 .934-1.733 4.667-3.866 8.4L153.733 261l-35.066 6.933c-19.334 3.867-35.2 7.2-35.467 7.467-.667.667-29.867 113.467-29.467 113.867.267.133 23.734-3.6 52.4-8.534l52-8.8 20.4-39.866c11.2-22 20.667-39.734 20.934-39.467.4.533-1.334 26.8-2.8 40.8l-.667 6.933 6.267-3.2c21.2-10.666 52.4-13.466 86.933-8l5.867.934-5.6-7.334C286.4 318.6 281.2 310.6 278 304.867c-5.867-10.134-6-10.8-6-21.867 0-6.267 1.467-20 3.333-30.667 1.867-10.666 3.334-19.466 3.334-19.466 0-.134-9.067-4.267-20.134-9.334s-19.466-9.333-18.8-9.6c.8-.266 7.734.8 15.6 2.267 7.734 1.6 14.4 2.8 14.8 2.8 1.2 0 .4-10.533-1.466-18-7.2-27.733-28-53.467-53.734-66-16.4-8-40.8-12-57.066-9.467\"/><path d=\"M235.6 346.333c-24 4.534-44.133 13.867-68.267 31.467-14 10.267-28.533 18.133-47.733 25.867-23.467 9.466-52.8 32.666-64.4 50.666l-2.533 4L58 454.2c9.333-7.333 30.133-19.467 49.333-28.667C173.733 393.667 246.4 382.2 312.8 393c11.2 1.733 39.2 8.533 45.067 10.8 2.266.8 2.266.667.8-2.267-4-7.6-15.6-21.866-25.867-31.466-12-11.467-24.667-18.934-37.6-22.4-11.467-3.067-46.267-3.867-59.6-1.334\"/>`;\n\nconst logoSvg = (fill: string): string =>\n  `<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 860 690\" fill=\"${fill}\"><g transform=\"translate(243 -2)\">${HELMET_PATHS}</g><g transform=\"translate(-460 467)\"><path d=\"M721.533 34.467c-14.933 5.466-22 17.466-22.933 38.666-.933 24.134 3.467 32.8 30.267 59.867 19.6 19.867 22.933 25.2 22.933 37.867.133 13.466-6.133 20.133-16.933 18.4-9.067-1.467-12.534-7.867-12.534-22.667V159H696.6l.667 13.333c.533 11.467 1.2 14.4 4.933 22 7.067 14.267 16.8 19.6 36.4 19.734 10.667.133 12.267-.134 20.667-4.4 7.6-3.867 9.733-5.867 13.2-11.734 7.6-12.533 9.066-32 3.733-47.6-3.733-11.066-10.667-20.4-27.867-37.2-19.866-19.6-22.533-24.133-22.666-38.4 0-8.933.4-10.533 3.2-13.6 6.266-6.666 18.266-5.6 22.133 2 1.067 2 2 7.067 2 11.2v7.334h27.067l-.934-9.2c-1.6-18.267-8.266-30.267-20-36.4-7.2-3.867-29.2-4.8-37.6-1.6M630.067 34.867c-11.734 4.666-18 11.6-21.734 24.4-1.866 6.4-2 15.333-1.733 67.2l.4 59.866 3.733 7.6c6.8 13.867 18.534 20.267 36.934 20.267 13.733 0 22.933-3.333 30.666-11.067 10.934-11.066 11.2-12.533 11.734-74.666.266-35.734-.134-56.934-1.067-62.8-2.667-16.134-11.6-27.467-24.8-31.467-8.933-2.667-26.4-2.267-34.133.667m28.666 26.8 3.6 4v56.666c0 40.934-.4 57.467-1.6 60-3.6 8-15.6 9.734-22.666 3.467l-4.4-3.867-.4-56.533c-.267-51.733-.134-56.8 2-61.067 3.066-5.866 7.6-8.266 14.4-7.466 3.733.4 6.4 1.866 9.066 4.8M511.667 123.133v89.334l29.066-.4c28.8-.4 28.934-.4 36.667-4.267 9.467-4.533 14.4-10.933 17.467-22.4 2-7.333 2.266-15.467 1.866-65.733l-.4-57.334-4.266-8.8c-8.267-16.666-17.2-19.866-55.334-19.866h-25.066zm53.6-60.266 4.4 3.866.4 52.8c.266 35.067-.134 54.4-1.067 58-2 7.467-5.733 9.6-18.667 10.4l-10.666.8V59h10.666c9.867 0 10.934.267 14.934 3.867M471.667 145v67.333h26.666V77.667h-26.666zM471.667 48.333V63h26.666V33.667h-26.666z\"/></g><g transform=\"translate(-106 244)\"><path d=\"M893.4 259.733c-6.8 3.467-9.2 5.6-12.667 11.467-10.666 17.733-9.2 42.933 3.467 62.267 2.8 4.266 12.267 14.8 20.933 23.333 9.867 9.467 17.067 17.733 18.934 21.6 5.6 11.333 5.2 25.333-.934 30.8-3.466 3.067-11.333 4.133-16.133 2.133-5.867-2.4-8-7.466-8-19.333v-10h-27.067l.8 11.6c1.2 15.867 3.867 24.133 10.267 31.333 7.467 8.534 16.4 12.134 30 12.267 19.067.133 30.133-5.733 37.333-19.867 3.734-7.466 4-8.666 4-24 0-16 0-16.133-5.2-26.666-4.4-9.2-7.733-13.2-23.066-28.534-21.067-21.066-24.8-27.066-24.934-40.4-.133-10.4 2.8-15.6 9.734-17.6 10.133-2.933 17.2 3.334 18.4 16.267l.8 8.267H955.4l-.8-10.8c-.533-8.4-1.6-12.667-4.8-19.2-7.067-14.134-16.667-19.334-36.133-19.334-10.667 0-12.534.4-20.267 4.4M791 346v89.333h76v-24h-48v-54.666h37.333v-24H819V282h48v-25.333h-76zM661.667 346v89.333h22.666l.134-63.066c0-34.534.533-61.734 1.066-60.267.534 1.467 5.467 29.867 10.8 62.933l9.867 60.4h13.067c7.2 0 13.066-.4 13.066-1.066 0-3.067 18.8-124.8 19.334-125.334.4-.4.666 27.867.666 62.8v63.6h25.334V256.667h-38l-9.2 61.6c-5.067 34-9.6 62.133-10 62.666-.534.534-5.334-26.4-10.667-60-5.467-33.466-10.133-61.733-10.533-62.666-.4-1.2-5.467-1.6-19.067-1.6h-18.533zM586.467 258.267c-.8 2.666-27.467 172.4-27.467 174.933 0 1.867 1.733 2.133 12 2.133h11.867l.8-4.4c.533-2.266 1.6-9.333 2.4-15.6l1.6-11.333 17.6-.4 17.466-.4 1.467 8.4c.8 4.667 1.733 11.867 2.267 16l.933 7.733h13.733c7.6 0 13.867-.266 13.867-.666 0-.8-26.533-168.134-27.467-173.734l-.8-4.266h-19.866c-14.8 0-20.134.4-20.4 1.6M613 336.533c3.333 23.067 5.867 42.134 5.6 42.4-.4.267-6.533.267-13.867.134l-13.2-.4 4.934-33.334c2.8-18.4 5.733-38.4 6.666-44.666C604.2 292.533 605 290.133 605.8 292c.533 1.467 3.867 21.467 7.2 44.533M497.267 257.2c-10.134 3.733-15.2 8.267-19.867 17.733L473 284l-.4 59.067c-.4 51.2-.133 60.133 1.733 66.533 5.6 19.333 17.067 27.333 39.467 27.467 10.267.133 12.267-.267 20.133-4.134 9.334-4.533 13.867-9.733 17.867-20.266 2-4.934 2.4-12 2.933-41.067l.534-34.933h-38.934v23.866l6.4.4 6.267.4v19.334c0 13.466-.533 20.666-1.867 23.733-5.066 12-23.333 10.4-26.8-2.4-.933-3.6-1.333-23.2-1.066-59.067.4-48.533.666-54.133 2.666-57.333 3.334-4.8 11.2-7.067 17.6-4.933 6.934 2.266 9.067 7.2 9.867 22.933l.667 13.067H555.4l-.8-15.734c-.8-18-3.067-25.6-9.867-33.466-7.466-8.8-13.466-11.2-29.066-11.734-9.067-.266-14.934.134-18.4 1.467\"/></g></svg>`;\n\n/** White iDos Games logo (helmet over wordmark) as an `<img src>`-ready data-URI. */\nexport const logoDataUrl = (color: string): string =>\n  `data:image/svg+xml;utf8,${encodeURIComponent(logoSvg(color))}`;\n\n/**\n * The helmet on its own, square, for small places (the \"Continue with iDos Games\" button icon).\n * The viewBox is the helmet's bounding box padded to a square.\n */\nexport const markDataUrl = (color: string): string =>\n  `data:image/svg+xml;utf8,${encodeURIComponent(\n    `<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"-33 11 448 448\" fill=\"${color}\">${HELMET_PATHS}</svg>`,\n  )}`;\n"
-    },
-    {
-      "path": "src/base/login/PlayAccessScreen.tsx",
-      "content": "import type { ReactNode } from \"react\";\nimport {\n  DefaultPlayAccessScreen,\n  type PlayAccessScreenProps,\n} from \"@idosgames/app-shell\";\nimport { renderWalletLink } from \"../../walletLogin\";\n\n// The play-access screen. The host shows it INSTEAD of the game while the title's login mode\n// (platform setting: Blockchain -> login mode) requires a token balance the player has not confirmed\n// yet — no linked wallet, balance too low, or the pass expired. The server re-checks the balance on\n// every login and session refresh; this screen is the manual path in between.\n//\n// The ready-made screen lists the requirements, the player's linked wallets, \"Link wallet\" (from\n// ./walletLogin) and \"Check balance\". Restyle freely: replace the body with your own UI and keep\n// calling client.blockchain.getPlayAccess() / confirmPlayAccess() and props.onGranted().\nexport function PlayAccessScreen(props: PlayAccessScreenProps): ReactNode {\n  return (\n    <DefaultPlayAccessScreen {...props} renderLinkWallet={renderWalletLink} />\n  );\n}\n"
-    },
-    {
-      "path": "src/base/module.ts",
-      "content": "import { defineModule, type Module } from \"@idosgames/module-sdk\";\nimport appConfig from \"../app.config\";\nimport { IDOS_WEB3, IDOS_WEB3_NETWORK_ID } from \"../idos.title\";\nimport { GAME_START, LOBBY_MODE, type AppConfig } from \"./app-config\";\nimport { makeLobbyPanel } from \"./lobby/Lobby\";\nimport { makePlayScreen } from \"./lobby/PlayScreen\";\nimport { makeBackToLobby } from \"./lobby/BackToLobby\";\nimport { makeFrameHeader, makeFrameTabs } from \"./lobby/GameFrame\";\nimport { PLAY, gameModes, hasWallet, startGame } from \"./lobby/model\";\nimport { t } from \"./lobby/i18n\";\n\n// The base of every app on the platform — the lobby, the home the player lands on after sign-in (the\n// sign-in itself is ./login, rendered by the host before any module runs). It is written against the\n// same module contract as everything in src/modules/, and main.tsx installs it first.\n//\n//  - The lobby lays out the features of the installed modules (the shop, heroes, leaders…) as tabs,\n//    with the balances, the wallet and the profile on top.\n//  - A game whose route says `inLobby` (idle-rpg) sits INSIDE the lobby: over it the base keeps the\n//    balances on top and the tabs at the bottom (./lobby/GameFrame.tsx), \"Play\" is that game, the\n//    app starts in it. Any other game (voxelcraft, board-game) takes the whole screen: \"Play\" in the\n//    lobby launches it, and over it the base draws only a small button back (./lobby/BackToLobby.tsx).\n//  - It takes the shared-UI roles it draws for everybody, so games hide their own balances and wallet,\n//    and the host draws no nav, ☰ or \"Log out\" of its own.\n//\n// What happens after sign-in and the order of the tabs: ../app.config.ts.\nexport const baseModule: Module = createBaseModule(appConfig, {\n  web3: IDOS_WEB3,\n  networkID: IDOS_WEB3_NETWORK_ID,\n});\n\n/** The web3 identity of the project (src/idos.title.ts) — whether the lobby offers the wallet. */\nexport interface BaseWeb3 {\n  web3: boolean;\n  networkID: string;\n}\n\n/** The base for a given app.config — the project uses `baseModule`; a test harness makes its own. */\nexport function createBaseModule(\n  config: AppConfig,\n  identity: BaseWeb3,\n): Module {\n  return defineModule({\n    id: \"base\",\n    meta: { name: \"Base\", type: \"app\", engine: \"dom\" },\n    sharedUi: {\n      provides: [\"currency-bar\", \"wallet\", \"account\", \"menu\", \"modes\"],\n    },\n    setup(ctx) {\n      ctx.registerRoute({\n        id: LOBBY_MODE,\n        label: t(\"lobby\"),\n        icon: \"🏠\",\n        order: -1000,\n      });\n\n      // The wallet lives next to the balances — for any web3 title (EVM or Solana).\n      const wallet = hasWallet(identity);\n\n      // `features.open(id)` from a game (the lobby is not on screen, its own presenter is gone): switch\n      // to the lobby and let it open the screen on mount. While the lobby is shown, its presenter —\n      // registered later — handles the request first.\n      let pending: { id: string; args?: Record<string, unknown> } | null = null;\n      ctx.features.setPresenter((id, args) => {\n        pending = { id, args };\n        ctx.navigate(LOBBY_MODE);\n        return true;\n      });\n\n      // \"Play\" in the lobby with ONE game that lives inside the lobby (`inLobby`, idle-rpg) goes\n      // straight into it — it sits in the lobby's frame below. Otherwise (a full-screen game, or\n      // several) the \"Play\" screen shows the game cards.\n      const openGame = (): boolean => {\n        const games = gameModes(ctx.modes.list());\n        const only = games.length === 1 ? games[0] : undefined;\n        if (!only?.inLobby) return false;\n        ctx.navigate(only.id);\n        return true;\n      };\n\n      ctx.registerPanel({\n        id: \"lobby\",\n        slot: \"overlay\",\n        component: makeLobbyPanel({\n          features: ctx.features,\n          lobby: config.lobby,\n          wallet,\n          onPlay: openGame,\n          pending: {\n            take: () => {\n              const next = pending;\n              pending = null;\n              return next;\n            },\n          },\n        }),\n      });\n\n      // The game inside the lobby: over a game the base keeps the lobby's balances on top and its tabs\n      // at the bottom (the host's frame slots — the game is laid out between them).\n      const frame = {\n        features: ctx.features,\n        modes: ctx.modes,\n        lobby: config.lobby,\n        wallet,\n        openInLobby: (id: string) => {\n          pending = { id };\n          ctx.navigate(LOBBY_MODE);\n        },\n      };\n      ctx.registerPanel({\n        id: \"frame-header\",\n        slot: \"header\",\n        activeOnly: false,\n        component: makeFrameHeader(frame),\n      });\n      ctx.registerPanel({\n        id: \"frame-tabs\",\n        slot: \"footer\",\n        activeOnly: false,\n        component: makeFrameTabs(frame),\n      });\n      // Over a game that takes the whole screen (voxelcraft, board-game) — only a button back.\n      ctx.registerPanel({\n        id: \"back\",\n        slot: \"modal\",\n        activeOnly: false,\n        component: makeBackToLobby(ctx.modes, ctx.navigate),\n      });\n\n      // \"Play\" — only while there is something to play. The modes are known once every module is\n      // installed, so this follows the list instead of reading it here.\n      const PlayScreen = makePlayScreen(\n        ctx.modes,\n        ctx.navigate,\n        ctx.multiplayer,\n        ctx.features,\n      );\n      let offPlay: (() => void) | null = null;\n      const syncPlay = (): void => {\n        const hasGames = gameModes(ctx.modes.list()).length > 0;\n        if (hasGames && !offPlay)\n          offPlay = ctx.features.register({\n            id: PLAY,\n            label: t(\"play\"),\n            icon: \"star\",\n            group: \"events\",\n            order: 0,\n            primary: true,\n            Screen: PlayScreen,\n          });\n        else if (!hasGames && offPlay) {\n          offPlay();\n          offPlay = null;\n        }\n      };\n      ctx.modes.subscribe(syncPlay);\n\n      // app.config.ts `start`: a game's mode id starts straight in it (the host applies it on its first\n      // render — no flash of the lobby). An id no module registered is ignored by the host.\n      // \"game\" — the game that lives inside the lobby (`inLobby`, idle-rpg); an app with only\n      // full-screen games (voxelcraft, board-game) starts in the lobby, \"Play\" launches them. The list\n      // is filled once every module is installed, so this waits for it and decides once, and only\n      // while nothing is on screen yet (the host has not shown the app).\n      if (config.start === GAME_START) {\n        let decided = false;\n        ctx.modes.subscribe(() => {\n          if (decided || ctx.modes.list().length === 0) return;\n          decided = true;\n          const game = startGame(ctx.modes.list());\n          if (game && ctx.modes.current() === null) ctx.navigate(game.id);\n        });\n      } else if (config.start !== LOBBY_MODE) ctx.navigate(config.start);\n\n      // The lobby is ordinary React in the DOM: an agent reads it as a tree and presses its buttons.\n      // What is not on screen goes here — above all, why a tab is missing.\n      ctx.exposeToAgent({\n        state: () => ({\n          mode: ctx.modes.current(),\n          start: config.start,\n          games: gameModes(ctx.modes.list()).map((m) => m.id),\n          wallet,\n          features: ctx.features.list().map((f) => ({\n            id: f.id,\n            module: f.moduleId,\n            available: f.available,\n            ...(f.unavailableReason\n              ? { hiddenBecause: f.unavailableReason }\n              : {}),\n            badge: f.badge,\n          })),\n        }),\n        actions: {\n          go: (args) => ctx.navigate(String(args?.mode ?? LOBBY_MODE)),\n          open: (args) => ctx.features.open(String(args?.feature ?? \"\")),\n        },\n        describeActions: {\n          go: 'go({ mode }) — switch to a mode: \"lobby\" or a game\\'s mode id',\n          open: 'open({ feature }) — open a tab by feature id (\"store\", \"character\"…); false if it is hidden',\n        },\n      });\n    },\n  });\n}\n"
+      "content": "import { defineAppConfig } from \"@idosgames/app-shell\";\n\n// What happens after sign-in and how the lobby is ordered. The look, animations and sounds are in\n// ./ui.config.ts. Which systems (shop, heroes, leaderboards…) and games the app has is\n// ./modules.ts: remove a module there and its tab is gone. A tab whose system has nothing configured\n// on the title yet (no store offers, no heroes…) stays hidden from players by itself.\n//\n// Everything is optional; uncomment and edit.\nexport default defineAppConfig({\n  // \"game\" — sign-in → straight into a game that lives inside the lobby (idle-rpg); an app whose\n  // games take the whole screen (voxelcraft, board-game) starts in the lobby. \"lobby\" — always\n  // sign-in → lobby → \"Play\". The mode id of a game (\"voxelcraft\") starts in that one.\n  start: \"game\",\n  lobby: {\n    // order: [\"play\", \"store\", \"character\"], // these tabs first, in this order\n    // primary: [\"season\"],                    // also a main tab rather than under \"More\"\n  },\n  auth: {\n    // The \"Play as guest\" button on the sign-in screen is OFF by default; uncomment to show it.\n    // guest: true,\n  },\n});\n"
     },
     {
       "path": "src/config.ts",
@@ -107,16 +47,12 @@
     },
     {
       "path": "src/main.tsx",
-      "content": "// ПЕРВЫЙ импорт сознательно: зонд превью ставит перехват console/ошибок при загрузке своего\n// модуля, и всё, что упадёт ниже по старту (включая config.ts на нераспознанном тайтле), уже\n// попадёт в его лог — а значит доедет до AI-кодера. Вне превью не делает ничего.\nimport { installPreviewProbe } from \"./previewProbe\";\nimport { createIDosGamesClient } from \"@idosgames/core\";\nimport { mountHost } from \"@idosgames/app-shell\";\nimport { baseModule, LoginScreen, PlayAccessScreen } from \"./base\";\nimport { modules } from \"./modules\";\nimport { renderWalletLogin } from \"./walletLogin\";\nimport { TITLE_ID, BUILD_KEY } from \"./config\";\nimport { IS_DEV } from \"./env\";\nimport ui from \"./ui.config\";\n\n// Тайтл зонду — отдельным вызовом: сам он встал раньше, чем config.ts успел его разрешить.\ninstallPreviewProbe({ titleId: TITLE_ID });\n\nconst app = document.getElementById(\"app\");\nif (!app) throw new Error(\"#app container not found\");\n\n// Always runs against the real backend (https://api.idosgames.com) via the global fetch.\nconst client = createIDosGamesClient({\n  titleID: TITLE_ID,\n  buildKey: BUILD_KEY.length > 0 ? BUILD_KEY : undefined,\n  throttleMs: 0,\n});\n\nclient.on(\"error:global\", (message) => {\n  console.error(\"[idos] global error:\", message);\n});\nclient.on(\"error:connection\", (message) => {\n  console.error(\"[idos] connection error:\", message);\n});\n\nif (IS_DEV) {\n  (\n    globalThis as typeof globalThis & { idosClient?: typeof client }\n  ).idosClient = client;\n}\n\n// The host owns sign-in: mountHost replays the previous session (autoLogin) and, when there is\n// none, renders the login screen. Do NOT log in here — that would skip the screen, and with it the\n// player's ability to pick a provider or switch accounts.\n//\n// The app = the base (./base: sign-in and the lobby) + the modules of ./modules.ts (the shop, heroes,\n// leaderboards… and the games). The base goes first; what happens after sign-in is ./app.config.ts.\n//\n// Wallet sign-in comes from ./walletLogin — always offered; that file owns the wagmi config and\n// the challenge network.\nmountHost({\n  container: app,\n  client,\n  modules: [baseModule, ...modules],\n  renderLogin: (props) => (\n    <LoginScreen {...props} renderWalletLogin={renderWalletLogin} />\n  ),\n  // Shown instead of the app when the title's login mode requires a token balance the player has\n  // not confirmed yet (see ./base/login/PlayAccessScreen).\n  renderPlayAccess: (props) => <PlayAccessScreen {...props} />,\n  // Look, animations and sounds of every module's interface — edit ./ui.config.ts, not the modules.\n  ui,\n});\n"
+      "content": "// ПЕРВЫЙ импорт сознательно: зонд превью (из SDK, отдельная точка входа) ставит перехват console/ошибок\n// при загрузке своего модуля, и всё, что упадёт ниже по старту (включая config.ts на нераспознанном\n// тайтле), уже попадёт в его лог — а значит доедет до AI-кодера. Вне превью не делает ничего.\nimport { installPreviewProbe } from \"@idosgames/app-shell/preview-probe\";\nimport { createIDosGamesClient } from \"@idosgames/core\";\nimport {\n  DefaultLoginScreen,\n  DefaultPlayAccessScreen,\n  createBaseModule,\n  mountHost,\n} from \"@idosgames/app-shell\";\nimport appConfig from \"./app.config\";\nimport { modules } from \"./modules\";\nimport { TITLE_ID, BUILD_KEY } from \"./config\";\nimport { ENV_GOOGLE_CLIENT_ID, IS_DEV } from \"./env\";\nimport { IDOS_WEB3, IDOS_WEB3_NETWORK_ID } from \"./idos.title\";\nimport { renderWalletLink, renderWalletLogin } from \"./walletLogin\";\nimport { WalletButton, WalletTopUp } from \"./walletButton\";\nimport ui from \"./ui.config\";\n\n// Тайтл зонду — отдельным вызовом: сам он встал раньше, чем config.ts успел его разрешить.\ninstallPreviewProbe({ titleId: TITLE_ID });\n\nconst app = document.getElementById(\"app\");\nif (!app) throw new Error(\"#app container not found\");\n\n// Always runs against the real backend (https://api.idosgames.com) via the global fetch.\nconst client = createIDosGamesClient({\n  titleID: TITLE_ID,\n  buildKey: BUILD_KEY.length > 0 ? BUILD_KEY : undefined,\n  throttleMs: 0,\n});\n\nclient.on(\"error:global\", (message) => {\n  console.error(\"[idos] global error:\", message);\n});\nclient.on(\"error:connection\", (message) => {\n  console.error(\"[idos] connection error:\", message);\n});\n\nif (IS_DEV) {\n  (\n    globalThis as typeof globalThis & { idosClient?: typeof client }\n  ).idosClient = client;\n}\n\n// The host owns sign-in: mountHost replays the previous session (autoLogin) and, when there is\n// none, renders the login screen. Do NOT log in here — that would skip the screen, and with it the\n// player's ability to pick a provider or switch accounts.\n//\n// The app = the base (sign-in and the lobby, both from @idosgames/app-shell) + the modules of\n// ./modules.ts (the shop, heroes, leaderboards… and the games). The base goes first; what happens\n// after sign-in and the order of the lobby's tabs is ./app.config.ts, the look is ./ui.config.ts.\n//\n// The wallet stack is the project's (the base knows nothing about it): the lobby's wallet button is\n// ./walletButton (with the top-up window for a purchase short on crypto), sign-in / \"link wallet\"\n// buttons are ./walletLogin.\nmountHost({\n  container: app,\n  client,\n  modules: [\n    createBaseModule(appConfig, {\n      web3: IDOS_WEB3,\n      networkID: IDOS_WEB3_NETWORK_ID,\n      WalletButton,\n      WalletTopUp,\n    }),\n    ...modules,\n  ],\n  // The ready-made sign-in: wallet, iDos Games, Google, Apple, Telegram, e-mail, and the title's login\n  // mode. \"Play as guest\" is off until `auth.guest` in ./app.config.ts turns it on; a Google client\n  // id for local development is VITE_IDOS_GOOGLE_CLIENT_ID (a published game shows Google only when\n  // the publisher set up the title's own Google sign-in). A game that needs another layout renders\n  // its own screen here and keeps calling client.auth.login*() and props.onAuthenticated().\n  renderLogin: (props) => (\n    <DefaultLoginScreen\n      {...props}\n      renderWalletLogin={renderWalletLogin}\n      allowGuest={appConfig.auth.guest}\n      googleClientId={ENV_GOOGLE_CLIENT_ID}\n    />\n  ),\n  // Shown instead of the app when the title's login mode requires a token balance the player has\n  // not confirmed yet: it lists the requirements, the linked wallets, \"Link wallet\" and \"Check\".\n  renderPlayAccess: (props) => (\n    <DefaultPlayAccessScreen {...props} renderLinkWallet={renderWalletLink} />\n  ),\n  // Look, animations and sounds of every module's interface — edit ./ui.config.ts, not the modules.\n  ui,\n});\n"
     },
     {
       "path": "src/modules.ts",
       "content": "import type { Module } from \"@idosgames/module-sdk\";\n\n// The modules this app is made of, on top of the base (./base — sign-in and the lobby): the systems\n// shown as lobby tabs (shop, heroes, leaderboards…) and the games launched by \"Play\". Remove a module\n// here and it is gone from the app. The platform writes this file whenever modules are installed or\n// removed, so it holds only the imports and the array.\n//\n// Example, after copying a module into src/modules/voxelcraft/:\n//   import { voxelcraftModule } from \"./modules/voxelcraft\";\n//   export const modules: Module[] = [voxelcraftModule];\nexport const modules: Module[] = [];\n"
     },
-    {
-      "path": "src/previewProbe.ts",
-      "content": "// Зонд превью: даёт AI-кодеру ГЛАЗА на работающее приложение.\n//\n// Живёт ВНУТРИ iframe с игрой, потому что иначе никак: превью грузится с домена бандлера, и\n// родительская страница (дашборд) по правилам браузера в его DOM залезть не может — единственная\n// щель между ними это postMessage. Зонд эту щель и обслуживает: сериализует DOM в компактное\n// дерево, копит console/сеть и умеет кликать по элементам, найденным в прошлом readPage.\n//\n// Отдельный слой — АВТОМАТИЧЕСКОЕ наблюдение за отрисованной игрой (см. ниже): полотна, кадры,\n// three.js, цвет экрана. Он работает без всякого участия игры и именно поэтому нужен: контракт\n// `exposeToAgent` даёт больше, но его кто-то должен написать, а произвольной игре не напишет никто.\n//\n// ДВА ИНВАРИАНТА, которые нельзя нарушать:\n//\n//   1. Зонд молчит, пока с ним не поздоровались с РАЗРЕШЁННОГО origin. Публичный сайт\n//      idosgames.com тоже встраивает игры в iframe — там hello никто не пришлёт, и весь этот код\n//      останется мёртвым. Ответ всегда уходит на event.origin, никогда на \"*\".\n//   2. Детект среды — только рантаймовый (адрес страницы, метка превью): зонд копируется в любой\n//      проект, и зависеть от того, что проект передаёт при сборке, ему нельзя.\n//\n// Подключается ПЕРВОЙ строкой main.tsx: тогда перехват console/ошибок стоит раньше, чем всё\n// остальное успевает упасть, и агент увидит причину падения старта, а не пустоту.\n\n/** Метка протокола: всё, что без неё, зонда не касается. */\nconst WIRE = \"idos-preview-probe/1\";\n\n/** Кто имеет право разговаривать с зондом. Всё остальное игнорируется молча. */\nconst ALLOWED_ORIGIN_HOSTS = [\"platform.idosgames.com\"];\n\n/** Сколько записей console храним. Ring buffer: старое вытесняется. */\nconst CONSOLE_LIMIT = 100;\n\n/** Сколько сетевых вызовов храним. */\nconst NETWORK_LIMIT = 50;\n\n/** Потолок дерева: узлов, глубины и символов. Держит снапшот в разумных токенах. */\nconst MAX_NODES = 400;\nconst MAX_DEPTH = 15;\nconst MAX_TREE_CHARS = 8000;\n\n/** Обрезка текста узла — модели хватает начала, а полный текст раздувает снапшот. */\nconst MAX_TEXT = 80;\n\n/** Однотипных детей печатаем не больше этого, остальные схлопываем в «… +N more». */\nconst MAX_SIBLINGS = 12;\n\n/** Пауза после клика/ввода перед новым снимком: даём React дорисовать. */\nconst SETTLE_MS = 350;\n\n/** Кольцо отметок кадров — по нему считается fps. Хватает на несколько секунд при 60 fps. */\nconst FRAME_RING = 240;\n\n/** Сетка чтения пикселей: 6×6 = 36 точек. Каждая точка — отдельный синхронный readPixels. */\nconst PIXEL_GRID = 6;\n\n/** Сколько ждём кадр перед чтением пикселей. Не дождались — это и есть ответ: петля не идёт. */\nconst FRAME_WAIT_MS = 200;\n\n/** Потолок удержания синтетической клавиши: агент не должен уметь «зажать W» на минуту. */\nconst MAX_INPUT_HOLD_MS = 3000;\n\ntype ProbeRequest = {\n  wire: typeof WIRE;\n  id: string;\n  cmd: string;\n  args?: Record<string, unknown>;\n};\n\ntype ConsoleEntry = { level: string; text: string; at: number };\ntype NetworkEntry = {\n  method: string;\n  url: string;\n  status: number | string;\n  ms: number;\n  at: number;\n};\n\nexport type PreviewProbeOptions = {\n  /** Тайтл, против которого работает приложение — агенту важно видеть DEV это или PROD. */\n  titleId?: string;\n};\n\n/**\n * Debug-поверхности модулей (см. `ctx.exposeToAgent` в @idosgames/module-sdk). Их выкладывает в\n * глобал host-shell; для отрисованных игр это ЕДИНСТВЕННЫЙ способ что-то узнать — у Three/Phaser\n * весь интерфейс это один `<canvas>`, и дерево DOM про него не расскажет ничего.\n */\ntype AgentModuleApi = {\n  state?: () => unknown;\n  actions?: Record<\n    string,\n    (args?: Record<string, unknown>) => unknown | Promise<unknown>\n  >;\n  describeActions?: Record<string, string>;\n};\n\n/** Состояние платформы, которое выкладывает host-shell (см. `publishHostState` в app-shell). */\ntype AgentHostState = {\n  screen?: string;\n  loggedIn?: boolean;\n  userId?: string | null;\n  titleId?: string | null;\n  modules?: string[];\n  /** Кто рисует общий интерфейс: роль → id модуля или null (роль свободна, шаблоны рисуют своё). */\n  sharedUi?: Record<string, string | null>;\n};\n\ntype AgentGlobal = {\n  version?: number;\n  modules?: Record<string, AgentModuleApi>;\n  host?: AgentHostState;\n  /** Журнал шины событий между модулями (последние события, кто что слушает, расхождения версий). */\n  events?: () => unknown;\n};\n\nfunction agentGlobal(): AgentGlobal | undefined {\n  return (globalThis as typeof globalThis & { __IDOS_AGENT__?: AgentGlobal })\n    .__IDOS_AGENT__;\n}\n\nfunction agentModules(): Record<string, AgentModuleApi> {\n  return agentGlobal()?.modules ?? {};\n}\n\nconst consoleLog: ConsoleEntry[] = [];\nconst networkLog: NetworkEntry[] = [];\n\n/** Элементы последнего снимка: клик адресуется по ref_N отсюда. */\nlet refs = new Map<string, Element>();\n\nlet installed = false;\nlet probeOptions: PreviewProbeOptions = {};\n\n/* ------------------------------------------------------------------ утилиты */\n\nfunction push<T>(buf: T[], entry: T, limit: number): void {\n  buf.push(entry);\n  if (buf.length > limit) buf.shift();\n}\n\nfunction clip(text: string, max: number): string {\n  const flat = text.replace(/\\s+/g, \" \").trim();\n  return flat.length > max ? `${flat.slice(0, max)}…` : flat;\n}\n\n/** Безопасная печать аргумента console: объекты в JSON, циклы и геттеры-бомбы не роняют зонд. */\nfunction stringifyArg(value: unknown): string {\n  if (typeof value === \"string\") return value;\n  if (value instanceof Error) return `${value.name}: ${value.message}`;\n  try {\n    return JSON.stringify(value) ?? String(value);\n  } catch {\n    return String(value);\n  }\n}\n\nfunction isAllowedOrigin(origin: string): boolean {\n  try {\n    const url = new URL(origin);\n    if (url.hostname === \"localhost\" || url.hostname === \"127.0.0.1\")\n      return true;\n    return ALLOWED_ORIGIN_HOSTS.includes(url.hostname);\n  } catch {\n    return false;\n  }\n}\n\n/* -------------------------------------------------------- сбор console/сети */\n\nfunction captureConsole(): void {\n  const levels = [\"log\", \"info\", \"warn\", \"error\", \"debug\"] as const;\n  for (const level of levels) {\n    const original = console[level].bind(console);\n    console[level] = (...args: unknown[]): void => {\n      push(\n        consoleLog,\n        {\n          level,\n          text: clip(args.map(stringifyArg).join(\" \"), 300),\n          at: Date.now(),\n        },\n        CONSOLE_LIMIT,\n      );\n      original(...args);\n    };\n  }\n\n  window.addEventListener(\"error\", (event) => {\n    const where = event.filename\n      ? ` (${event.filename}:${event.lineno}:${event.colno})`\n      : \"\";\n    push(\n      consoleLog,\n      {\n        level: \"error\",\n        text: clip(`Uncaught ${event.message}${where}`, 300),\n        at: Date.now(),\n      },\n      CONSOLE_LIMIT,\n    );\n  });\n\n  window.addEventListener(\"unhandledrejection\", (event) => {\n    push(\n      consoleLog,\n      {\n        level: \"error\",\n        text: clip(`Unhandled rejection: ${stringifyArg(event.reason)}`, 300),\n        at: Date.now(),\n      },\n      CONSOLE_LIMIT,\n    );\n  });\n}\n\nfunction captureNetwork(): void {\n  const originalFetch = window.fetch.bind(window);\n  window.fetch = async (\n    input: RequestInfo | URL,\n    init?: RequestInit,\n  ): Promise<Response> => {\n    const started = Date.now();\n    const url =\n      typeof input === \"string\"\n        ? input\n        : input instanceof URL\n          ? input.href\n          : input.url;\n    const method = (\n      init?.method ??\n      (typeof input === \"object\" && \"method\" in input ? input.method : \"GET\") ??\n      \"GET\"\n    ).toUpperCase();\n\n    // Заголовки и тела НЕ пишем сознательно: в них сидит Bearer-тикет игрока, а лог уезжает в LLM.\n    try {\n      const response = await originalFetch(input, init);\n      push(\n        networkLog,\n        {\n          method,\n          url: clip(url, 200),\n          status: response.status,\n          ms: Date.now() - started,\n          at: started,\n        },\n        NETWORK_LIMIT,\n      );\n      return response;\n    } catch (error: unknown) {\n      push(\n        networkLog,\n        {\n          method,\n          url: clip(url, 200),\n          status: `failed: ${stringifyArg(error)}`,\n          ms: Date.now() - started,\n          at: started,\n        },\n        NETWORK_LIMIT,\n      );\n      throw error;\n    }\n  };\n}\n\n/* ------------------------------------------ автоматический слой наблюдения */\n\n// Всё, что ниже, работает БЕЗ какой-либо кооперации со стороны игры — в этом весь смысл.\n// Контракт `exposeToAgent` даёт данные лучше, но его должен кто-то НАПИСАТЬ, а произвольной (и тем\n// более будущей) игре его не напишет никто. Поэтому зонд снимает сам всё, что можно снять с движка\n// и с полотна: есть ли WebGL-контекст, идут ли кадры, сколько draw-вызовов, что говорит three.js о\n// сцене и камере, и не залит ли кадр одним цветом.\n//\n// Скриншотов здесь нет и не будет (решение владельца): наружу уходят ТОЛЬКО числа. Зато число\n// «все 36 проб одного цвета #ffffff» ловит белый экран не хуже картинки.\n\n/** Настоящий rAF, снятый ДО перехвата: им зонд ждёт кадр, не накручивая собственный счётчик. */\nconst rawRaf: ((cb: FrameRequestCallback) => number) | null =\n  typeof window !== \"undefined\" &&\n  typeof window.requestAnimationFrame === \"function\"\n    ? window.requestAnimationFrame.bind(window)\n    : null;\n\ntype CanvasRecord = {\n  canvas: HTMLCanvasElement;\n  /** Как контекст запрашивали: \"2d\" | \"webgl\" | \"webgl2\" | \"webgpu\" | … */\n  kind: string;\n  gl: WebGLRenderingContext | WebGL2RenderingContext | null;\n  ctx2d: CanvasRenderingContext2D | null;\n  /** Отметки «кадр отрисован» (clear/clearRect) — по ним считается настоящий fps. */\n  frames: number;\n  /** Вызовы отрисовки: у Three/Phaser их десятки-сотни за кадр. */\n  draws: number;\n  lastDrawAt: number;\n};\n\n/** Сколько полотен помним. Больше игре и не нужно, а временные canvas'ы иначе растут без конца. */\nconst MAX_CANVAS_RECORDS = 24;\n\nconst canvasRecords: CanvasRecord[] = [];\n\n/** Отметки кадров: по полотну (надёжнее) и по rAF (петля жива, даже если ничего не рисуется). */\nconst glFrameTimes: number[] = [];\nconst rafFrameTimes: number[] = [];\n\nfunction markFrame(ring: number[]): void {\n  ring.push(Date.now());\n  if (ring.length > FRAME_RING) ring.shift();\n}\n\n/** Сколько отметок пришлось на последнюю секунду. Это и есть fps — без усреднения по сессии. */\nfunction perSecond(ring: number[]): number {\n  const cutoff = Date.now() - 1000;\n  let count = 0;\n  for (let i = ring.length - 1; i >= 0; i--) {\n    if ((ring[i] ?? 0) < cutoff) break;\n    count++;\n  }\n  return count;\n}\n\nfunction asRecord(value: unknown): Record<string, unknown> | null {\n  return value && typeof value === \"object\"\n    ? (value as Record<string, unknown>)\n    : null;\n}\n\nfunction num(value: unknown): number | null {\n  return typeof value === \"number\" && Number.isFinite(value) ? value : null;\n}\n\n/**\n * Подменить метод объекта счётчиком. Пишем в САМ объект, а не в прототип: у WebGL-контекста метод\n * лежит на прототипе, и собственное свойство просто перекрывает его для этого экземпляра — чужие\n * контексты (и чужие вкладки) остаются нетронутыми.\n */\nfunction countCalls(target: unknown, name: string, tick: () => void): void {\n  const holder = target as Record<string, unknown> | null;\n  if (!holder) return;\n  const current = holder[name];\n  if (typeof current !== \"function\") return;\n  const original = current as (...args: unknown[]) => unknown;\n  holder[name] = function (this: unknown, ...args: unknown[]): unknown {\n    try {\n      tick();\n    } catch {\n      /* счётчик не имеет права ломать отрисовку */\n    }\n    return original.apply(this, args);\n  };\n}\n\n/** Инструментовка полотна: кадры отдельно, вызовы отрисовки отдельно. */\nfunction instrument(rec: CanvasRecord): void {\n  const frame = (): void => {\n    rec.frames++;\n    rec.lastDrawAt = Date.now();\n    // В общий счётчик fps идут только полотна НА СТРАНИЦЕ: временные canvas'ы, на которых движки\n    // рисуют текстуры и текст, чистятся так же часто и накрутили бы «кадры» на пустом месте.\n    if (rec.canvas.isConnected) markFrame(glFrameTimes);\n  };\n  const draw = (): void => {\n    rec.draws++;\n  };\n\n  if (rec.gl) {\n    // clear зовут один раз за кадр практически все движки — он и служит границей кадра.\n    countCalls(rec.gl, \"clear\", frame);\n    for (const method of [\n      \"drawArrays\",\n      \"drawElements\",\n      \"drawArraysInstanced\",\n      \"drawElementsInstanced\",\n    ]) {\n      countCalls(rec.gl, method, draw);\n    }\n    return;\n  }\n\n  if (rec.ctx2d) {\n    countCalls(rec.ctx2d, \"clearRect\", frame);\n    for (const method of [\n      \"drawImage\",\n      \"fillRect\",\n      \"fill\",\n      \"stroke\",\n      \"fillText\",\n    ]) {\n      countCalls(rec.ctx2d, method, draw);\n    }\n  }\n}\n\nfunction registerContext(\n  canvas: HTMLCanvasElement,\n  kind: string,\n  ctx: unknown,\n): void {\n  // Повторный getContext возвращает тот же объект — второй раз инструментовать нельзя.\n  if (canvasRecords.some((rec) => rec.canvas === canvas && rec.kind === kind))\n    return;\n\n  // Потолок списка обязателен: движки создают временные полотна пачками (текстуры из текста,\n  // атласы), и без него зонд держал бы ссылку на каждое — утечка памяти плюс линейный поиск,\n  // который растёт с каждым кадром. Первыми уходят полотна, которых уже нет на странице.\n  if (canvasRecords.length >= MAX_CANVAS_RECORDS) {\n    for (let i = canvasRecords.length - 1; i >= 0; i--) {\n      if (!canvasRecords[i]?.canvas.isConnected) canvasRecords.splice(i, 1);\n    }\n    while (canvasRecords.length >= MAX_CANVAS_RECORDS) canvasRecords.shift();\n  }\n\n  const isGl =\n    kind === \"webgl\" || kind === \"webgl2\" || kind === \"experimental-webgl\";\n  const rec: CanvasRecord = {\n    canvas,\n    kind,\n    gl: isGl ? (ctx as WebGLRenderingContext | WebGL2RenderingContext) : null,\n    ctx2d: kind === \"2d\" ? (ctx as CanvasRenderingContext2D) : null,\n    frames: 0,\n    draws: 0,\n    lastDrawAt: 0,\n  };\n  canvasRecords.push(rec);\n  instrument(rec);\n}\n\n/**\n * Перехват `getContext`. Ставится ДО импорта движка (зонд — первый импорт main.tsx), поэтому ни\n * одно полотно мимо не проходит, чем бы игра ни рисовала: Three, Phaser, Pixi, сырой WebGL, 2d.\n *\n * Заодно ТОЛЬКО В ПРЕВЬЮ навязывается `preserveDrawingBuffer: true`. По умолчанию содержимое\n * WebGL-буфера действительно лишь до композитинга кадра, и снаружи кадра оттуда читается пустота —\n * то есть статичная сцена, которая рисуется один раз, выглядела бы «чёрным экраном». С флагом\n * последний нарисованный кадр остаётся читаемым в любой момент. Цена — небольшая потеря\n * производительности, и платит её только вкладка с превью: в собранной игре зонда нет.\n */\nfunction captureCanvases(): void {\n  type GetContext = (\n    this: HTMLCanvasElement,\n    id: string,\n    options?: unknown,\n  ) => unknown;\n\n  const proto = HTMLCanvasElement.prototype;\n  const original = proto.getContext as unknown as GetContext;\n\n  const patched: GetContext = function (this: HTMLCanvasElement, id, options) {\n    let effective = options;\n    try {\n      const kind = String(id);\n      if (\n        kind === \"webgl\" ||\n        kind === \"webgl2\" ||\n        kind === \"experimental-webgl\"\n      ) {\n        // Копия, а не правка чужого объекта: игра могла передать свой конфиг и переиспользовать его.\n        effective = {\n          ...(asRecord(options) ?? {}),\n          preserveDrawingBuffer: true,\n        };\n      }\n    } catch {\n      effective = options;\n    }\n\n    const ctx = original.call(this, id, effective);\n    try {\n      if (ctx) registerContext(this, String(id), ctx);\n    } catch {\n      /* наблюдение не имеет права мешать игре получить контекст */\n    }\n    return ctx;\n  };\n\n  proto.getContext = patched as unknown as typeof proto.getContext;\n}\n\n/** Перехват rAF: показывает, что цикл приложения вообще крутится, даже если полотна нет. */\nfunction captureFrames(): void {\n  if (!rawRaf) return;\n  window.requestAnimationFrame = (callback: FrameRequestCallback): number =>\n    rawRaf((time) => {\n      markFrame(rafFrameTimes);\n      callback(time);\n    });\n}\n\n/* ---------------------------------------------------------------- three.js */\n\nconst three: {\n  renderer: Record<string, unknown> | null;\n  scene: Record<string, unknown> | null;\n  camera: Record<string, unknown> | null;\n  scenes: number;\n} = { renderer: null, scene: null, camera: null, scenes: 0 };\n\n/**\n * Канал, по которому three.js сам представляется наблюдателю.\n *\n * `WebGLRenderer` и `Scene` в своих конструкторах проверяют глобал `__THREE_DEVTOOLS__` и, если он\n * есть, шлют в него событие `observe` со ссылкой на себя. Задуман он для расширения-девтулзов, но\n * это ровно то, что нужно здесь: никакой правки игры, а на выходе живой рендерер со счётчиками.\n * Глобал обязан существовать ДО создания рендерера — отсюда установка при импорте зонда.\n */\nfunction captureThree(): void {\n  const holder = globalThis as typeof globalThis & {\n    __THREE_DEVTOOLS__?: EventTarget;\n  };\n\n  // Если глобал уже кто-то поставил (расширение three-devtools) — подписываемся, а не затираем.\n  const target: EventTarget = holder.__THREE_DEVTOOLS__ ?? new EventTarget();\n  holder.__THREE_DEVTOOLS__ = target;\n\n  target.addEventListener(\"observe\", (event: Event) => {\n    try {\n      const detail = asRecord((event as CustomEvent<unknown>).detail);\n      if (!detail) return;\n\n      if (detail[\"isScene\"] === true) {\n        three.scenes++;\n        three.scene ??= detail;\n        return;\n      }\n\n      // Рендерер узнаём по паре info + domElement: это его, и только его, поверхность.\n      if (detail[\"info\"] && detail[\"domElement\"]) {\n        three.renderer = detail;\n        watchRender(detail);\n      }\n    } catch {\n      /* чужой объект не обязан быть таким, как мы ждём */\n    }\n  });\n}\n\n/**\n * Подмена `renderer.render(scene, camera)`: это единственный способ узнать, какие сцену и камеру\n * игра рисует ПРЯМО СЕЙЧАС. Событие `observe` про камеру не рассказывает вообще, а сцен у игры\n * может быть несколько (меню, мир, миникарта).\n */\nfunction watchRender(renderer: Record<string, unknown>): void {\n  if (renderer[\"__idosProbeWatched\"] === true) return;\n  const original = renderer[\"render\"];\n  if (typeof original !== \"function\") return;\n\n  renderer[\"__idosProbeWatched\"] = true;\n  const call = original as (...args: unknown[]) => unknown;\n  renderer[\"render\"] = function (this: unknown, ...args: unknown[]): unknown {\n    const scene = asRecord(args[0]);\n    const camera = asRecord(args[1]);\n    if (scene) three.scene = scene;\n    if (camera) three.camera = camera;\n    return call.apply(this, args);\n  };\n}\n\nfunction threeSnapshot(): Record<string, unknown> | null {\n  if (!three.renderer && !three.scene) return null;\n  const out: Record<string, unknown> = {};\n\n  const info = asRecord(three.renderer?.[\"info\"]);\n  const render = asRecord(info?.[\"render\"]);\n  const memory = asRecord(info?.[\"memory\"]);\n  if (render) {\n    // `calls` у WebGLRenderer, `drawCalls` у WebGPURenderer — представляются они одинаково.\n    out[\"drawCalls\"] = num(render[\"calls\"]) ?? num(render[\"drawCalls\"]);\n    out[\"triangles\"] = num(render[\"triangles\"]);\n    out[\"lines\"] = num(render[\"lines\"]);\n    out[\"points\"] = num(render[\"points\"]);\n    out[\"framesRendered\"] = num(render[\"frame\"]);\n  }\n  if (memory) {\n    out[\"geometries\"] = num(memory[\"geometries\"]);\n    out[\"textures\"] = num(memory[\"textures\"]);\n  }\n\n  const scene = three.scene;\n  const traverse = scene?.[\"traverse\"];\n  if (scene && typeof traverse === \"function\") {\n    let total = 0;\n    let meshes = 0;\n    let lights = 0;\n    let hidden = 0;\n    try {\n      (traverse as (cb: (obj: unknown) => void) => void).call(\n        scene,\n        (obj: unknown) => {\n          if (total > 20000) return; // защита от сцены-монстра: считаем, но не вечно\n          total++;\n          const node = asRecord(obj);\n          if (!node) return;\n          if (node[\"isMesh\"] === true) meshes++;\n          if (node[\"isLight\"] === true) lights++;\n          if (node[\"visible\"] === false) hidden++;\n        },\n      );\n      out[\"scene\"] = {\n        name: typeof scene[\"name\"] === \"string\" ? scene[\"name\"] : null,\n        objects: total,\n        meshes,\n        lights,\n        hidden,\n        scenesCreated: three.scenes,\n      };\n    } catch {\n      out[\"scene\"] = { error: \"scene.traverse failed\" };\n    }\n  }\n\n  // Позиция и направление камеры — прямо из мировой матрицы: третий столбец это её «взгляд»\n  // (с минусом — камера в three смотрит вдоль -Z). Так не нужен импорт three ради Vector3.\n  const elements = asRecord(three.camera?.[\"matrixWorld\"])?.[\"elements\"] as\n    ArrayLike<number> | undefined;\n  if (elements && elements.length >= 16) {\n    const dx = -(elements[8] ?? 0);\n    const dy = -(elements[9] ?? 0);\n    const dz = -(elements[10] ?? 0);\n    const len = Math.hypot(dx, dy, dz) || 1;\n    out[\"camera\"] = {\n      pos: {\n        x: round(elements[12] ?? 0),\n        y: round(elements[13] ?? 0),\n        z: round(elements[14] ?? 0),\n      },\n      lookDir: {\n        x: round(dx / len),\n        y: round(dy / len),\n        z: round(dz / len),\n      },\n      fov: num(three.camera?.[\"fov\"]),\n    };\n  }\n\n  return out;\n}\n\nfunction round(value: number, digits = 2): number {\n  const k = 10 ** digits;\n  return Math.round(value * k) / k;\n}\n\n/* ------------------------------------------------------------------- Pixi */\n\nconst pixi: {\n  app: Record<string, unknown> | null;\n  renderer: Record<string, unknown> | null;\n  version: string | null;\n} = { app: null, renderer: null, version: null };\n\n/**\n * Канал, по которому PixiJS сам представляется наблюдателю — точный аналог `__THREE_DEVTOOLS__`.\n *\n * Pixi 8 при инициализации зовёт `globalThis.__PIXI_APP_INIT__(app, VERSION)`, а его рендерер —\n * `__PIXI_RENDERER_INIT__(renderer, VERSION)` (см. `utils/global/globalHooks`). Хуки задуманы для\n * расширения-девтулзов, и это ровно то, что нужно: игру править не надо, а на выходе живые\n * Application и Renderer. Ставить их обязательно ДО инициализации Pixi — отсюда установка при\n * импорте зонда.\n *\n * Оба хука ставятся не «вместо», а «поверх»: прежний (расширение браузера) вызывается следом.\n */\nfunction capturePixi(): void {\n  type Hook = (target: unknown, version?: string) => void;\n  const holder = globalThis as typeof globalThis & {\n    __PIXI_APP_INIT__?: Hook;\n    __PIXI_RENDERER_INIT__?: Hook;\n  };\n\n  const previousApp = holder.__PIXI_APP_INIT__;\n  holder.__PIXI_APP_INIT__ = (app: unknown, version?: string): void => {\n    try {\n      pixi.app = asRecord(app);\n      pixi.version = version ?? pixi.version;\n    } catch {\n      /* чужой объект не обязан быть таким, как мы ждём */\n    }\n    previousApp?.(app, version);\n  };\n\n  const previousRenderer = holder.__PIXI_RENDERER_INIT__;\n  holder.__PIXI_RENDERER_INIT__ = (\n    renderer: unknown,\n    version?: string,\n  ): void => {\n    try {\n      pixi.renderer = asRecord(renderer);\n      pixi.version = version ?? pixi.version;\n    } catch {\n      /* см. выше */\n    }\n    previousRenderer?.(renderer, version);\n  };\n}\n\n/** Обход дерева отображения Pixi: у него нет `traverse`, только `children`. */\nfunction countPixiTree(root: Record<string, unknown>): Record<string, unknown> {\n  let total = 0;\n  let hidden = 0;\n  let depth = 0;\n\n  const walk = (node: Record<string, unknown>, level: number): void => {\n    if (total > 20000) return; // потолок как у three: считаем, но не вечно\n    total++;\n    if (node[\"visible\"] === false || node[\"renderable\"] === false) hidden++;\n    if (level > depth) depth = level;\n\n    const children = node[\"children\"];\n    if (!Array.isArray(children)) return;\n    for (const child of children) {\n      const record = asRecord(child);\n      if (record) walk(record, level + 1);\n    }\n  };\n\n  walk(root, 0);\n  // Сам корень объектом сцены не считаем — интересно, что В нём.\n  return { objects: Math.max(total - 1, 0), hidden, depth };\n}\n\nfunction pixiSnapshot(): Record<string, unknown> | null {\n  const app = pixi.app;\n  const renderer = pixi.renderer ?? asRecord(app?.[\"renderer\"]);\n  if (!app && !renderer) return null;\n\n  const out: Record<string, unknown> = { version: pixi.version };\n\n  if (renderer) {\n    const type = renderer[\"type\"];\n    out[\"renderer\"] = {\n      // `name` у Pixi 8 это \"webgl\"/\"webgpu\"; `type` — числовой флаг того же самого.\n      backend:\n        typeof renderer[\"name\"] === \"string\"\n          ? renderer[\"name\"]\n          : (num(type) ?? null),\n      width: num(renderer[\"width\"]),\n      height: num(renderer[\"height\"]),\n      resolution: num(renderer[\"resolution\"]),\n    };\n  }\n\n  const ticker = asRecord(app?.[\"ticker\"]);\n  if (ticker) {\n    const fps = num(ticker[\"FPS\"]);\n    out[\"ticker\"] = {\n      fps: fps === null ? null : round(fps, 1),\n      started: ticker[\"started\"] ?? null,\n    };\n  }\n\n  const stage = asRecord(app?.[\"stage\"]);\n  if (stage) {\n    const tree = countPixiTree(stage);\n    out[\"stage\"] = {\n      ...tree,\n      label:\n        typeof stage[\"label\"] === \"string\"\n          ? stage[\"label\"]\n          : typeof stage[\"name\"] === \"string\"\n            ? stage[\"name\"]\n            : null,\n    };\n  }\n\n  return out;\n}\n\n/* ----------------------------------------------------------------- Phaser */\n\n/**\n * У Phaser канала самопредставления НЕТ — и это проверено, а не предположено: `Game.boot` пишет\n * `window.PHASER_GAME = this` только под флагом `WEBGL_DEBUG`, а из готовых сборок\n * (`dist/phaser.esm.js`, которые и ставит npm) эта ветка вырезана целиком.\n *\n * Поэтому игру приходится ИСКАТЬ, а не ждать. Два источника, оба без кооперации игры:\n *   1. `window.PHASER_GAME` — есть в отладочных сборках и в превью, если бандлер взял `main`\n *      (у Phaser это исходники, а не dist);\n *   2. скан собственных ключей `window` на сигнатуру `Phaser.Game`.\n *\n * Поиск ленивый (только при сборке снимка) и с кэшем: перебирать глобалы каждый кадр незачем.\n */\n// Кэшируется ИМЯ глобала, а не сам объект: игру можно пересоздать (host-shell перемонтирует сцену\n// при смене режима), и ссылка на прежнюю осталась бы живой в памяти — зонд честно показывал бы\n// уничтоженную игру. Перечитывание по ключу всегда отдаёт текущую.\nlet phaserKey: string | null = null;\n\nfunction looksLikePhaserGame(value: unknown): boolean {\n  const game = asRecord(value);\n  if (!game) return false;\n  return (\n    typeof game[\"isBooted\"] === \"boolean\" &&\n    asRecord(game[\"scene\"]) !== null &&\n    Array.isArray(asRecord(game[\"scene\"])?.[\"scenes\"]) &&\n    asRecord(game[\"loop\"]) !== null\n  );\n}\n\nfunction findPhaserGame(): Record<string, unknown> | null {\n  const holder = globalThis as typeof globalThis & Record<string, unknown>;\n\n  const at = (key: string): Record<string, unknown> | null => {\n    try {\n      return looksLikePhaserGame(holder[key]) ? asRecord(holder[key]) : null;\n    } catch {\n      // Чтение чужого свойства window может бросить (кросс-доменный фрейм) — не наша забота.\n      return null;\n    }\n  };\n\n  if (phaserKey) {\n    const cached = at(phaserKey);\n    if (cached) return cached;\n    phaserKey = null;\n  }\n\n  for (const key of [\"PHASER_GAME\", ...Object.keys(holder)]) {\n    const found = at(key);\n    if (found) {\n      phaserKey = key;\n      return found;\n    }\n  }\n  return null;\n}\n\nfunction phaserSnapshot(): Record<string, unknown> | null {\n  const game = findPhaserGame();\n  if (!game) return null;\n\n  const out: Record<string, unknown> = {\n    booted: game[\"isBooted\"] ?? null,\n    running: game[\"isRunning\"] ?? null,\n  };\n\n  const fps = num(asRecord(game[\"loop\"])?.[\"actualFps\"]);\n  if (fps !== null) out[\"fps\"] = round(fps, 1);\n\n  const renderer = asRecord(game[\"renderer\"]);\n  if (renderer) {\n    // У Phaser `type` — числовая константа: 1 = CANVAS, 2 = WEBGL.\n    const type = num(renderer[\"type\"]);\n    out[\"renderer\"] = {\n      backend: type === 2 ? \"webgl\" : type === 1 ? \"canvas\" : (type ?? null),\n      width: num(renderer[\"width\"]),\n      height: num(renderer[\"height\"]),\n    };\n  }\n\n  const scenes = asRecord(game[\"scene\"])?.[\"scenes\"];\n  if (Array.isArray(scenes)) {\n    const list: Record<string, unknown>[] = [];\n    for (const raw of scenes.slice(0, 12)) {\n      const sys = asRecord(asRecord(raw)?.[\"sys\"]);\n      const settings = asRecord(sys?.[\"settings\"]);\n      const displayList = asRecord(sys?.[\"displayList\"]);\n      const camera = asRecord(asRecord(sys?.[\"cameras\"])?.[\"main\"]);\n\n      const entry: Record<string, unknown> = {\n        key: settings?.[\"key\"] ?? null,\n        active: settings?.[\"active\"] ?? null,\n        visible: settings?.[\"visible\"] ?? null,\n        objects: Array.isArray(displayList?.[\"list\"])\n          ? (displayList[\"list\"] as unknown[]).length\n          : null,\n      };\n      if (camera) {\n        entry[\"camera\"] = {\n          scrollX: round(num(camera[\"scrollX\"]) ?? 0),\n          scrollY: round(num(camera[\"scrollY\"]) ?? 0),\n          zoom: round(num(camera[\"zoom\"]) ?? 1),\n        };\n      }\n      list.push(entry);\n    }\n    out[\"scenes\"] = list;\n    // «Активная» сцена — та, что реально обновляется: по ней и судят, что происходит на экране.\n    out[\"activeScenes\"] = list.filter((s) => s[\"active\"] === true).length;\n  }\n\n  return out;\n}\n\n/* ------------------------------------------------------------- пиксели */\n\nfunction hex(r: number, g: number, b: number): string {\n  const part = (v: number): string => v.toString(16).padStart(2, \"0\");\n  return `#${part(r)}${part(g)}${part(b)}`;\n}\n\n/**\n * Чтение редкой сетки пикселей — 36 точек вместо картинки: скриншотов здесь нет по решению\n * владельца, а «все 36 проб одного цвета» ловит белый экран ничуть не хуже.\n *\n * Читать можно в любой момент, потому что зонд принудительно включает `preserveDrawingBuffer`\n * (см. `captureCanvases`); без него содержимое буфера пропадало бы сразу после композитинга кадра.\n */\nfunction readGrid(rec: CanvasRecord): number[][] | null {\n  const width = rec.canvas.width;\n  const height = rec.canvas.height;\n  if (width < 2 || height < 2) return null;\n\n  const at = (i: number, size: number): number =>\n    Math.min(size - 1, Math.floor(((i + 0.5) / PIXEL_GRID) * size));\n\n  if (rec.gl) {\n    const gl = rec.gl;\n    if (gl.isContextLost()) return null;\n\n    // Игра могла оставить привязанным свой render target — тогда мы прочли бы не экран. Снимаем\n    // привязку на время чтения и возвращаем ровно ту, что была.\n    const previous = gl.getParameter(\n      gl.FRAMEBUFFER_BINDING,\n    ) as WebGLFramebuffer | null;\n    if (previous) gl.bindFramebuffer(gl.FRAMEBUFFER, null);\n\n    const pixel = new Uint8Array(4);\n    const samples: number[][] = [];\n    for (let iy = 0; iy < PIXEL_GRID; iy++) {\n      for (let ix = 0; ix < PIXEL_GRID; ix++) {\n        gl.readPixels(\n          at(ix, width),\n          at(iy, height),\n          1,\n          1,\n          gl.RGBA,\n          gl.UNSIGNED_BYTE,\n          pixel,\n        );\n        samples.push([\n          pixel[0] ?? 0,\n          pixel[1] ?? 0,\n          pixel[2] ?? 0,\n          pixel[3] ?? 0,\n        ]);\n      }\n    }\n\n    if (previous) gl.bindFramebuffer(gl.FRAMEBUFFER, previous);\n    return samples;\n  }\n\n  if (rec.ctx2d) {\n    const samples: number[][] = [];\n    for (let iy = 0; iy < PIXEL_GRID; iy++) {\n      for (let ix = 0; ix < PIXEL_GRID; ix++) {\n        const data = rec.ctx2d.getImageData(\n          at(ix, width),\n          at(iy, height),\n          1,\n          1,\n        ).data;\n        samples.push([data[0] ?? 0, data[1] ?? 0, data[2] ?? 0, data[3] ?? 0]);\n      }\n    }\n    return samples;\n  }\n\n  return null;\n}\n\nfunction pixelStats(samples: number[][]): Record<string, unknown> {\n  const colours = new Set<string>();\n  let transparent = 0;\n  let r = 0;\n  let g = 0;\n  let b = 0;\n\n  for (const [pr, pg, pb, pa] of samples) {\n    const alpha = pa ?? 0;\n    if (alpha < 8) transparent++;\n    r += pr ?? 0;\n    g += pg ?? 0;\n    b += pb ?? 0;\n    colours.add(hex(pr ?? 0, pg ?? 0, pb ?? 0));\n  }\n\n  const n = samples.length || 1;\n  const uniform = colours.size <= 1;\n  const average = hex(Math.round(r / n), Math.round(g / n), Math.round(b / n));\n\n  return {\n    sampled: samples.length,\n    distinctColours: colours.size,\n    uniform,\n    colour: uniform ? ([...colours][0] ?? null) : null,\n    averageColour: average,\n    transparentSamples: transparent,\n    note: uniform\n      ? `every sampled pixel is the same colour — the frame is a flat fill (a blank/white/black screen looks exactly like this)`\n      : `${colours.size} distinct colours across ${samples.length} samples — something is actually drawn`,\n  };\n}\n\n/** Прочитать сетку прямо сейчас, обернув всё, что может пойти не так, в ответ, а не в исключение. */\nfunction readNow(\n  rec: CanvasRecord,\n  extra: Record<string, unknown>,\n): Record<string, unknown> {\n  try {\n    const samples = readGrid(rec);\n    return samples\n      ? { ...pixelStats(samples), ...extra }\n      : { sampled: 0, note: \"could not read pixels from this canvas\" };\n  } catch (error: unknown) {\n    return { sampled: 0, note: `pixel read failed: ${stringifyArg(error)}` };\n  }\n}\n\n/**\n * Прочитать пиксели, по возможности — в кадре, где что-то нарисовано.\n *\n * Сначала ждём кадр с отрисовкой: у живой игры это самая свежая картинка. Не дождались — читаем всё\n * равно: буфер сохраняется принудительно (см. `captureCanvases`), поэтому там лежит ПОСЛЕДНИЙ\n * нарисованный кадр. Отдать в такой ситуации «ничего не вижу» было бы худшим из ответов: именно\n * когда петля встала, картинка нужнее всего.\n */\nfunction samplePixels(rec: CanvasRecord): Promise<Record<string, unknown>> {\n  return new Promise((resolve) => {\n    if (!rawRaf) {\n      resolve(\n        readNow(rec, {\n          drewDuringSample: false,\n          frameNote: \"read outside an animation frame\",\n        }),\n      );\n      return;\n    }\n\n    let attempts = 0;\n    let settled = false;\n    const finish = (value: Record<string, unknown>): void => {\n      if (settled) return;\n      settled = true;\n      window.clearTimeout(timer);\n      resolve(value);\n    };\n\n    const timer = window.setTimeout(\n      () =>\n        finish(\n          readNow(rec, {\n            drewDuringSample: false,\n            staleFrame: true,\n            frameNote:\n              `nothing was drawn within ${FRAME_WAIT_MS}ms, so this is the LAST frame the game ` +\n              \"rendered, not a live one — the render loop is stopped, the scene only redraws on \" +\n              \"demand, or the preview tab is in the background\",\n          }),\n        ),\n      FRAME_WAIT_MS,\n    );\n\n    const tick = (): void => {\n      if (settled) return;\n      const before = rec.frames + rec.draws;\n      rawRaf(() => {\n        if (settled) return;\n        const drew = rec.frames + rec.draws > before;\n        attempts++;\n        // Ещё один шанс поймать кадр с отрисовкой; на третьей попытке читаем как есть.\n        if (!drew && attempts < 3) {\n          tick();\n          return;\n        }\n        finish(readNow(rec, { drewDuringSample: drew }));\n      });\n    };\n\n    tick();\n  });\n}\n\n/* --------------------------------------------------------- сборка снимка */\n\n/** Полотна документа, самое большое — первым: оно почти всегда и есть игра. */\nfunction canvasesByArea(): {\n  el: HTMLCanvasElement;\n  rec: CanvasRecord | null;\n}[] {\n  const list = Array.from(document.querySelectorAll(\"canvas\")).map((el) => ({\n    el,\n    rec: canvasRecords.find((rec) => rec.canvas === el) ?? null,\n  }));\n  return list.sort(\n    (a, b) => b.el.width * b.el.height - a.el.width * a.el.height,\n  );\n}\n\nfunction describeCanvas(entry: {\n  el: HTMLCanvasElement;\n  rec: CanvasRecord | null;\n}): Record<string, unknown> {\n  const rect = entry.el.getBoundingClientRect();\n  const rec = entry.rec;\n  return {\n    context: rec?.kind ?? \"unknown (context created before the probe, or none)\",\n    buffer: `${entry.el.width}x${entry.el.height}`,\n    onScreen: `${Math.round(rect.width)}x${Math.round(rect.height)}`,\n    visible: rect.width > 0 && rect.height > 0,\n    framesDrawn: rec?.frames ?? null,\n    drawCalls: rec?.draws ?? null,\n    msSinceLastDraw:\n      rec && rec.lastDrawAt > 0 ? Date.now() - rec.lastDrawAt : null,\n  };\n}\n\nfunction platformState(): Record<string, unknown> {\n  const host = agentGlobal()?.host;\n  return {\n    titleId: probeOptions.titleId ?? host?.titleId ?? null,\n    url: window.location.href,\n    // Экран хоста: loading | login | game. «Игрок не залогинен» — самая частая причина того, что\n    // «игра не работает», и без этой строки агент ищет причину в коде игры.\n    screen: host?.screen ?? \"unknown (host state not published)\",\n    loggedIn: host?.loggedIn ?? null,\n    userId: host?.userId ?? null,\n    modulesInstalled: host?.modules ?? null,\n    // Роли общего интерфейса. Отвечает на «почему у шаблона пропал кошелёк/баланс»: его взял\n    // поставщик роли (обычно game-hud), это не поломка.\n    sharedUi: host?.sharedUi ?? null,\n  };\n}\n\n/** Журнал шины событий. Чужой код — поэтому под try: сломанный журнал не должен ронять ответ. */\nfunction eventBusState(): unknown {\n  const read = agentGlobal()?.events;\n  if (typeof read !== \"function\") return null;\n  try {\n    return read();\n  } catch (error: unknown) {\n    return { error: stringifyArg(error) };\n  }\n}\n\n/**\n * Автоматический слой: что видно в приложении БЕЗ его участия.\n *\n * Возвращается всегда — и когда модули открылись агенту, и когда нет. Слепой тишины быть не должно:\n * даже у игры, о которой никто ничего не рассказал, есть полотно, кадры и цвет экрана.\n */\nasync function observeRuntime(options: {\n  pixels: boolean;\n}): Promise<Record<string, unknown>> {\n  const canvases = canvasesByArea();\n  const main = canvases[0] ?? null;\n  const notes: string[] = [];\n\n  const glFps = perSecond(glFrameTimes);\n  const rafFps = perSecond(rafFrameTimes);\n  const rendering: Record<string, unknown> = {\n    fps: glFps > 0 ? glFps : rafFps,\n    fpsSource:\n      glFps > 0 ? \"canvas clear() calls\" : \"requestAnimationFrame callbacks\",\n    animationFramesPerSecond: rafFps,\n    canvasFramesPerSecond: glFps,\n  };\n\n  // Движки опрашиваются ДО заметок про «ничего не анимируется»: их собственный счётчик кадров эту\n  // заметку отменяет, и выдать обе разом значило бы противоречить самому себе в одном ответе.\n  const threeInfo = threeSnapshot();\n  const pixiInfo = pixiSnapshot();\n  const phaserInfo = phaserSnapshot();\n\n  // Кадры, о которых отчитывается САМ движок. Им веры больше, чем счётчику по полотну: движок не\n  // обязан чистить буфер каждый кадр, и тогда наш счётчик занижает. Поймано вживую — Phaser\n  // сообщал 60, а полотно давало 1.\n  const engineFps =\n    num(phaserInfo?.[\"fps\"]) ?? num(asRecord(pixiInfo?.[\"ticker\"])?.[\"fps\"]);\n  const canvasFps = glFps > 0 ? glFps : rafFps;\n  const engineRunning = engineFps !== null && engineFps > 5;\n  if (engineFps !== null) rendering[\"engineFps\"] = engineFps;\n\n  if (!main) {\n    notes.push(\n      \"No <canvas> in the document: this is a DOM app (or the game has not mounted its canvas yet). Read the page instead.\",\n    );\n  } else if (engineRunning && canvasFps <= 5) {\n    notes.push(\n      `The engine reports ${engineFps} fps while the canvas counter sees almost none. Trust the engine: the counter only sees frames that clear the buffer, and a page that has just rebuilt has not accumulated any yet. The game IS running.`,\n    );\n  } else if (rafFps === 0 && glFps === 0) {\n    // Порядок причин здесь не случаен: пауза стоит ПЕРВОЙ, потому что она самая частая и самая\n    // безобидная. Живой прогон показал именно её — игра ждала клика по полотну, а заметка звучала\n    // как «петля мертва», то есть звала чинить исправное.\n    notes.push(\n      \"Nothing is animating: no animation frame ran in the last second. Most often the game is simply PAUSED and waiting for the player to click the canvas (a click via SendInput starts it — check the frames again after that). It is also normal for a scene that only redraws on demand. Only if neither applies is the render loop actually dead (an exception inside it, or it was never started) — the console says which.\",\n    );\n  }\n\n  if (!threeInfo && !pixiInfo && !phaserInfo && main?.rec) {\n    notes.push(\n      \"A canvas is present but no engine identified itself: three.js and PixiJS announce themselves automatically, and Phaser is looked up in the page globals. So this is either another engine (Babylon, raw WebGL/2d), or Phaser that keeps its Game object out of reach. The canvas numbers above (fps, draw calls, pixels) still hold — only the scene/camera detail is missing.\",\n    );\n  }\n\n  let pixels: Record<string, unknown> | null = null;\n  if (options.pixels && main?.rec) {\n    pixels = await samplePixels(main.rec);\n    if (pixels[\"uniform\"] === true) {\n      notes.push(\n        \"The sampled frame is ONE flat colour. Together with a live fps that usually means the scene renders but nothing is in view (camera inside geometry, everything culled, materials/lights missing); with fps 0 it means nothing is being drawn at all.\",\n      );\n    }\n  }\n\n  return {\n    platform: platformState(),\n    canvas: main ? describeCanvas(main) : null,\n    otherCanvases: canvases.length > 1 ? canvases.length - 1 : 0,\n    rendering,\n    three: threeInfo,\n    pixi: pixiInfo,\n    phaser: phaserInfo,\n    pixels,\n    notes,\n  };\n}\n\n/** Однострочная выжимка автоматического слоя — она подмешивается в снимок страницы. */\nfunction summarize(observation: Record<string, unknown>): string {\n  const parts: string[] = [];\n\n  const canvas = asRecord(observation[\"canvas\"]);\n  if (canvas)\n    parts.push(\n      `canvas ${String(canvas[\"buffer\"])} (${String(canvas[\"context\"])})`,\n    );\n\n  const rendering = asRecord(observation[\"rendering\"]);\n  if (rendering) parts.push(`${String(rendering[\"fps\"])} fps`);\n\n  const threeInfo = asRecord(observation[\"three\"]);\n  if (threeInfo) {\n    const scene = asRecord(threeInfo[\"scene\"]);\n    if (scene)\n      parts.push(`three.js scene: ${String(scene[\"objects\"])} objects`);\n    if (threeInfo[\"drawCalls\"] !== null && threeInfo[\"drawCalls\"] !== undefined)\n      parts.push(`${String(threeInfo[\"drawCalls\"])} draw calls`);\n  }\n\n  const pixiInfo = asRecord(observation[\"pixi\"]);\n  const pixiStage = asRecord(pixiInfo?.[\"stage\"]);\n  if (pixiStage)\n    parts.push(`PixiJS stage: ${String(pixiStage[\"objects\"])} display objects`);\n\n  const phaserInfo = asRecord(observation[\"phaser\"]);\n  if (phaserInfo) {\n    const scenes = phaserInfo[\"scenes\"];\n    parts.push(\n      `Phaser: ${String(phaserInfo[\"activeScenes\"] ?? 0)} active scene(s)` +\n        (Array.isArray(scenes) ? ` of ${scenes.length}` : \"\"),\n    );\n  }\n\n  const pixels = asRecord(observation[\"pixels\"]);\n  if (pixels && num(pixels[\"sampled\"])) {\n    parts.push(\n      pixels[\"uniform\"] === true\n        ? `the whole frame is ${String(pixels[\"colour\"])}`\n        : `${String(pixels[\"distinctColours\"])} distinct colours on screen`,\n    );\n  }\n\n  const platform = asRecord(observation[\"platform\"]);\n  if (platform && platform[\"screen\"])\n    parts.push(`host screen: ${String(platform[\"screen\"])}`);\n\n  return parts.join(\", \");\n}\n\n/* ------------------------------------------------------ синтетический ввод */\n\n// Универсальные «руки» — для игр, которые НЕ описали свои действия через `exposeToAgent`.\n// Работает не всегда, и это честно сказано в ответе: движок, который гейтит ввод на Pointer Lock,\n// синтетические события игнорирует, а Pointer Lock в кросс-доменном iframe запрещён браузером.\n\nconst KEY_CODES: Record<string, number> = {\n  Space: 32,\n  Enter: 13,\n  Escape: 27,\n  Tab: 9,\n  Backspace: 8,\n  ArrowLeft: 37,\n  ArrowUp: 38,\n  ArrowRight: 39,\n  ArrowDown: 40,\n  ShiftLeft: 16,\n  ShiftRight: 16,\n  ControlLeft: 17,\n  ControlRight: 17,\n};\n\n/** `key` по `code`: движки читают то одно, то другое, поэтому заполняем оба. */\nfunction keyFromCode(code: string): string {\n  if (code.startsWith(\"Key\")) return code.slice(3).toLowerCase();\n  if (code.startsWith(\"Digit\")) return code.slice(5);\n  if (code === \"Space\") return \" \";\n  if (code.startsWith(\"Shift\")) return \"Shift\";\n  if (code.startsWith(\"Control\")) return \"Control\";\n  if (code.startsWith(\"Alt\")) return \"Alt\";\n  return code;\n}\n\nfunction legacyKeyCode(code: string): number {\n  const known = KEY_CODES[code];\n  if (known) return known;\n  if (code.startsWith(\"Key\")) return code.charCodeAt(3);\n  if (code.startsWith(\"Digit\")) return 48 + Number(code.slice(5));\n  return 0;\n}\n\n/** Кого считаем игрой: самое большое полотно, иначе — активный элемент. */\nfunction inputTarget(): EventTarget {\n  const main = canvasesByArea()[0];\n  return main?.el ?? document.activeElement ?? document.body ?? window;\n}\n\nfunction keyEvent(type: string, code: string): KeyboardEvent {\n  const event = new KeyboardEvent(type, {\n    code,\n    key: keyFromCode(code),\n    bubbles: true,\n    cancelable: true,\n    composed: true,\n  });\n  // keyCode/which в конструкторе не поддерживаются, а игры на них до сих пор смотрят.\n  const legacy = legacyKeyCode(code);\n  Object.defineProperty(event, \"keyCode\", { get: () => legacy });\n  Object.defineProperty(event, \"which\", { get: () => legacy });\n  return event;\n}\n\nfunction wait(ms: number): Promise<void> {\n  return new Promise((resolve) => window.setTimeout(resolve, ms));\n}\n\nasync function sendKey(code: string, ms: number): Promise<void> {\n  const target = inputTarget();\n  if (target instanceof HTMLElement) target.focus?.();\n  target.dispatchEvent(keyEvent(\"keydown\", code));\n  await wait(Math.min(Math.max(ms, 16), MAX_INPUT_HOLD_MS));\n  target.dispatchEvent(keyEvent(\"keyup\", code));\n}\n\n/** Координата: 0..1 читается как доля полотна, больше — как CSS-пиксели. */\nfunction resolveCoord(value: unknown, size: number): number {\n  const n = typeof value === \"number\" && Number.isFinite(value) ? value : 0.5;\n  return n >= 0 && n <= 1 ? n * size : n;\n}\n\n/** Типы, после которых кнопка уже отпущена: у них `buttons` обязан быть нулём. */\nconst RELEASE_EVENTS = new Set([\n  \"mouseup\",\n  \"pointerup\",\n  \"click\",\n  \"mousemove\",\n  \"pointermove\",\n]);\n\n/**\n * Событие указателя. Для `pointer*` строим именно PointerEvent: движки на pointer-событиях\n * (Phaser 4) читают у него `pointerId`/`isPrimary`, и обычный MouseEvent они отбрасывают.\n */\nfunction pointerLikeEvent(\n  type: string,\n  x: number,\n  y: number,\n  button: number,\n  movement?: { dx: number; dy: number },\n): MouseEvent {\n  const init: PointerEventInit = {\n    clientX: x,\n    clientY: y,\n    button,\n    buttons: RELEASE_EVENTS.has(type) ? 0 : 1 << button,\n    bubbles: true,\n    cancelable: true,\n    composed: true,\n    movementX: movement?.dx ?? 0,\n    movementY: movement?.dy ?? 0,\n  };\n\n  if (type.startsWith(\"pointer\") && typeof PointerEvent === \"function\") {\n    return new PointerEvent(type, {\n      ...init,\n      pointerId: 1,\n      pointerType: \"mouse\",\n      isPrimary: true,\n    });\n  }\n  return new MouseEvent(type, init);\n}\n\nasync function sendClick(\n  xArg: unknown,\n  yArg: unknown,\n  button: number,\n): Promise<void> {\n  const target = inputTarget();\n  const element = target instanceof Element ? target : document.body;\n  const rect = element.getBoundingClientRect();\n  const x = rect.left + resolveCoord(xArg, rect.width);\n  const y = rect.top + resolveCoord(yArg, rect.height);\n\n  for (const type of [\"pointerdown\", \"mousedown\"]) {\n    target.dispatchEvent(pointerLikeEvent(type, x, y, button));\n  }\n  await wait(30);\n  for (const type of [\"pointerup\", \"mouseup\", \"click\"]) {\n    target.dispatchEvent(pointerLikeEvent(type, x, y, button));\n  }\n}\n\nasync function sendMove(dx: number, dy: number): Promise<void> {\n  const target = inputTarget();\n  const element = target instanceof Element ? target : document.body;\n  const rect = element.getBoundingClientRect();\n  const x = rect.left + rect.width / 2 + dx;\n  const y = rect.top + rect.height / 2 + dy;\n  // movementX/movementY — то, что читает камера от первого лица; clientX/Y — то, что читают\n  // обычные обработчики. Заполняем оба, чтобы не гадать, какой путь у игры.\n  target.dispatchEvent(pointerLikeEvent(\"mousemove\", x, y, 0, { dx, dy }));\n  target.dispatchEvent(pointerLikeEvent(\"pointermove\", x, y, 0, { dx, dy }));\n  await wait(16);\n}\n\n/**\n * Синтетический ввод + снимок ПОСЛЕ него (как readPage после клика).\n *\n * Ответ всегда несёт `pointerLockActive`: если игра требует захвата указателя, ввод до неё не\n * дойдёт — и агент должен прочитать это как «управление не проверено», а не «управление сломано».\n */\nasync function sendInput(raw: unknown): Promise<unknown> {\n  const args = asRecord(raw) ?? {};\n  const type = String(args[\"type\"] ?? \"key\");\n\n  switch (type) {\n    case \"key\": {\n      const code = String(args[\"code\"] ?? args[\"key\"] ?? \"\");\n      if (!code)\n        throw new Error(\"input type 'key' needs a code, e.g. \\\"KeyW\\\"\");\n      await sendKey(code, Number(args[\"ms\"] ?? 200));\n      break;\n    }\n    case \"click\":\n      await sendClick(args[\"x\"], args[\"y\"], Number(args[\"button\"] ?? 0));\n      break;\n    case \"move\":\n      await sendMove(Number(args[\"dx\"] ?? 0), Number(args[\"dy\"] ?? 0));\n      break;\n    default:\n      throw new Error(`unknown input type '${type}' — use key | click | move`);\n  }\n\n  await settle();\n  // Именно на истинность, а не `!== null`: там, где Pointer Lock не поддержан вовсе, свойство\n  // приходит `undefined`, и строгое сравнение объявило бы захват активным, которого нет.\n  const locked = Boolean(document.pointerLockElement);\n  return {\n    sent: { type, ...args },\n    pointerLockActive: locked,\n    note: locked\n      ? \"Pointer Lock is active, so the game receives this input the same way it receives the player's.\"\n      : \"Synthetic input was dispatched. If the game gates controls on Pointer Lock it ignored this — Pointer Lock cannot be acquired inside the preview iframe. A module's exposeToAgent actions are the reliable path.\",\n    observation: await observeRuntime({ pixels: true }),\n    modules: moduleSurfaces(),\n  };\n}\n\n/* ------------------------------------------------------- сериализация DOM */\n\nconst SKIP_TAGS = new Set([\n  \"SCRIPT\",\n  \"STYLE\",\n  \"LINK\",\n  \"META\",\n  \"NOSCRIPT\",\n  \"TEMPLATE\",\n  \"HEAD\",\n]);\n\nconst INTERACTIVE_TAGS = new Set([\n  \"BUTTON\",\n  \"A\",\n  \"INPUT\",\n  \"SELECT\",\n  \"TEXTAREA\",\n]);\n\nfunction isInteractive(el: Element): boolean {\n  if (INTERACTIVE_TAGS.has(el.tagName)) return true;\n  const role = el.getAttribute(\"role\");\n  if (\n    role === \"button\" ||\n    role === \"link\" ||\n    role === \"tab\" ||\n    role === \"menuitem\"\n  )\n    return true;\n  return el.hasAttribute(\"data-testid\") && el.hasAttribute(\"tabindex\");\n}\n\nfunction isVisible(el: Element): boolean {\n  const rect = el.getBoundingClientRect();\n  if (rect.width > 0 && rect.height > 0) return true;\n  // Нулевой прямоугольник у контейнера — норма (например, обёртка с absolute-детьми):\n  // считаем видимым, если браузер не выключил его целиком.\n  const style = window.getComputedStyle(el);\n  return style.display !== \"none\" && style.visibility !== \"hidden\";\n}\n\n/** Собственный текст узла — без текста детей (их напечатают они сами). */\nfunction ownText(el: Element): string {\n  let text = \"\";\n  for (const node of Array.from(el.childNodes)) {\n    if (node.nodeType === Node.TEXT_NODE) text += node.textContent ?? \"\";\n  }\n  return clip(text, MAX_TEXT);\n}\n\nfunction describe(el: Element, ref: string | null): string {\n  const parts: string[] = [el.tagName.toLowerCase()];\n\n  const id = el.getAttribute(\"id\");\n  if (id) parts[0] += `#${id}`;\n\n  const cls = el.getAttribute(\"class\");\n  if (cls) {\n    const first = cls.trim().split(/\\s+/).slice(0, 2).join(\".\");\n    if (first) parts[0] += `.${first}`;\n  }\n\n  if (ref) parts.push(`[${ref}]`);\n\n  const label = el.getAttribute(\"aria-label\");\n  const testId = el.getAttribute(\"data-testid\");\n  if (testId) parts.push(`testid=${testId}`);\n\n  const text = ownText(el) || (label ? clip(label, MAX_TEXT) : \"\");\n  if (text) parts.push(JSON.stringify(text));\n\n  const flags: string[] = [];\n  if (el.hasAttribute(\"disabled\")) flags.push(\"disabled\");\n  if ((el as HTMLInputElement).checked) flags.push(\"checked\");\n  if (el.tagName === \"INPUT\" || el.tagName === \"TEXTAREA\") {\n    const value = (el as HTMLInputElement).value;\n    if (value) flags.push(`value=${JSON.stringify(clip(value, 40))}`);\n    const placeholder = el.getAttribute(\"placeholder\");\n    if (placeholder)\n      flags.push(`placeholder=${JSON.stringify(clip(placeholder, 40))}`);\n  }\n  if (el.tagName === \"CANVAS\") {\n    const canvas = el as HTMLCanvasElement;\n    flags.push(`${canvas.width}x${canvas.height}`);\n  }\n  if (flags.length) parts.push(`(${flags.join(\", \")})`);\n\n  return parts.join(\" \");\n}\n\nfunction readDom(): { tree: string; truncated: boolean } {\n  refs = new Map<string, Element>();\n  const lines: string[] = [];\n  let nodes = 0;\n  let refSeq = 0;\n  let truncated = false;\n\n  const walk = (el: Element, depth: number): void => {\n    if (truncated) return;\n    if (SKIP_TAGS.has(el.tagName)) return;\n    if (nodes >= MAX_NODES || depth > MAX_DEPTH) {\n      truncated = true;\n      return;\n    }\n\n    const visible = isVisible(el);\n    let ref: string | null = null;\n    if (visible && isInteractive(el)) {\n      ref = `ref_${++refSeq}`;\n      refs.set(ref, el);\n    }\n\n    const line = `${\"  \".repeat(depth)}${describe(el, ref)}${visible ? \"\" : \" (hidden)\"}`;\n    lines.push(line);\n    nodes++;\n\n    // В скрытое поддерево не спускаемся: сам факт «модалка есть и она скрыта» полезен, её\n    // внутренности — нет.\n    if (!visible) return;\n\n    const children = Array.from(el.children);\n    const shown = children.slice(0, MAX_SIBLINGS);\n    for (const child of shown) walk(child, depth + 1);\n    if (children.length > shown.length) {\n      lines.push(\n        `${\"  \".repeat(depth + 1)}… +${children.length - shown.length} more sibling(s)`,\n      );\n    }\n  };\n\n  if (document.body) walk(document.body, 0);\n\n  let tree = lines.join(\"\\n\");\n  if (tree.length > MAX_TREE_CHARS) {\n    tree = `${tree.slice(0, MAX_TREE_CHARS)}\\n… (tree truncated)`;\n    truncated = true;\n  }\n\n  return { tree, truncated };\n}\n\n/**\n * Полотно, которое стоит считать «главным экраном»: либо оно занимает заметную часть окна, либо в\n * дереве вообще не за что зацепиться. Маленький canvas рядом с обычным интерфейсом (график,\n * спарклайн, аватар) главным экраном не объявляем — иначе снимок каждой DOM-страницы обрастал бы\n * рассказом про отрисованную игру, которой там нет.\n */\nfunction dominantCanvas(): {\n  el: HTMLCanvasElement;\n  rec: CanvasRecord | null;\n} | null {\n  const main = canvasesByArea()[0];\n  if (!main) return null;\n\n  const rect = main.el.getBoundingClientRect();\n  const viewport = window.innerWidth * window.innerHeight;\n  const share = viewport > 0 ? (rect.width * rect.height) / viewport : 0;\n  if (share >= 0.15) return main;\n\n  // Нулевой прямоугольник — не обязательно «полотна не видно»: измерять могли до раскладки. Тогда\n  // судим по размеру самого буфера, иначе снимок игры с HUD-кнопкой молча терял бы весь рассказ\n  // про экран (поймано прогоном под jsdom, где размеров нет вообще).\n  const unmeasured = rect.width === 0 && rect.height === 0;\n  if (unmeasured && main.el.width >= 200 && main.el.height >= 200) return main;\n\n  return refs.size === 0 ? main : null;\n}\n\n/**\n * Снимок страницы: дерево DOM плюс — у отрисованной игры — выжимка автоматического наблюдения.\n *\n * У Three/Phaser дерево честно пустое: весь мир внутри одного `<canvas>`. Раньше здесь стояла\n * только пометка «это не пустой экран», и агент оставался ни с чем. Теперь в ту же строку уезжают\n * настоящие цифры (кадры, объекты сцены, цвет полотна) — их зонд добывает сам, без участия игры.\n */\nasync function readPage(): Promise<{ tree: string; truncated: boolean }> {\n  const page = readDom();\n  // Порядок важен: `dominantCanvas` смотрит на `refs`, которые заполняет `readDom`.\n  if (!dominantCanvas()) return page;\n\n  const exposed = Object.keys(agentModules());\n  const head =\n    \"\\n\\n[This screen is drawn into a <canvas>: the DOM above says nothing about what happens \" +\n    \"inside it, so a tree with nothing in it is NOT an empty screen.\";\n\n  let note = head;\n  try {\n    const summary = summarize(await observeRuntime({ pixels: true }));\n    if (summary) note += ` Observed automatically: ${summary}.`;\n  } catch {\n    /* автоматический слой не обязан удаваться — дерево важнее и уже собрано */\n  }\n\n  note +=\n    exposed.length > 0\n      ? ` Call GetGameState for the full picture — modules exposing a debug surface: ${exposed.join(\", \")}.]`\n      : ` Call GetGameState for the full picture. No module exposes a debug surface ` +\n        `(ctx.exposeToAgent), so gameplay state beyond these numbers is not observable — adding that ` +\n        `surface to the game module is what makes it observable.]`;\n\n  return { tree: page.tree + note, truncated: page.truncated };\n}\n\n/* ------------------------------------------------------------- действия */\n\nfunction settle(): Promise<void> {\n  return new Promise((resolve) => window.setTimeout(resolve, SETTLE_MS));\n}\n\nfunction resolveRef(ref: unknown): Element {\n  if (typeof ref !== \"string\") throw new Error(\"ref is required\");\n  const el = refs.get(ref);\n  if (!el) throw new Error(`${ref} is unknown — call readPage first`);\n  if (!el.isConnected)\n    throw new Error(\n      `${ref} is no longer in the document — call readPage again`,\n    );\n  return el;\n}\n\nasync function clickRef(ref: unknown): Promise<unknown> {\n  const el = resolveRef(ref);\n  if (typeof (el as HTMLElement).click !== \"function\")\n    throw new Error(\"element is not clickable\");\n  (el as HTMLElement).click();\n  await settle();\n  return readPage();\n}\n\nasync function typeIntoRef(ref: unknown, text: unknown): Promise<unknown> {\n  const el = resolveRef(ref);\n  if (!(el instanceof HTMLInputElement) && !(el instanceof HTMLTextAreaElement))\n    throw new Error(\"element is not a text field\");\n\n  // Контролируемому React-полю мало el.value = …: React слушает нативный сеттер, и без него\n  // состояние компонента не обновится, а значение откатится на следующем рендере.\n  const proto =\n    el instanceof HTMLInputElement\n      ? HTMLInputElement.prototype\n      : HTMLTextAreaElement.prototype;\n  const setter = Object.getOwnPropertyDescriptor(proto, \"value\")?.set;\n  if (setter) setter.call(el, String(text ?? \"\"));\n  else el.value = String(text ?? \"\");\n\n  el.dispatchEvent(new Event(\"input\", { bubbles: true }));\n  el.dispatchEvent(new Event(\"change\", { bubbles: true }));\n  await settle();\n  return readPage();\n}\n\n/* ------------------------------------------------- состояние игровых модулей */\n\n/**\n * Снимок всех модулей, которые открылись агенту, плюс перечень их действий.\n *\n * Ошибку в чужом `state()` не роняем на весь ответ: один сломанный модуль не должен ослеплять\n * агента по остальным — он получит текст ошибки ровно на месте этого модуля.\n */\nfunction moduleSurfaces(): Record<string, unknown> {\n  const modules = agentModules();\n  const ids = Object.keys(modules);\n  if (ids.length === 0) {\n    return {\n      available: false,\n      hint:\n        \"No module exposes a debug surface (ctx.exposeToAgent), so nothing beyond the automatic \" +\n        \"observation above can be seen: player position, score, current turn and the ability to DRIVE \" +\n        \"the game all come from that surface. If you need them, add exposeToAgent to the game module's \" +\n        \"setup() — it is a few lines and it is what makes the game verifiable from here.\",\n    };\n  }\n\n  const out: Record<string, unknown> = {};\n  for (const id of ids) {\n    const api = modules[id];\n    try {\n      out[id] = {\n        state: api?.state ? api.state() : null,\n        actions: api?.describeActions ?? {},\n      };\n    } catch (error: unknown) {\n      out[id] = { error: stringifyArg(error) };\n    }\n  }\n  return { available: true, modules: out };\n}\n\n/**\n * Ответ на `gameState`: автоматический слой ВСЕГДА, поверхности модулей — если они есть.\n *\n * Порядок именно такой и он важен: даже игра, о которой никто ничего не рассказал, отвечает\n * цифрами (полотно, кадры, сцена, цвет экрана), а не пустотой. «Мне ничего не видно» — худший\n * из возможных ответов: он неотличим от «на экране пусто» и толкает агента чинить исправное.\n */\nasync function gameState(): Promise<unknown> {\n  return {\n    observed: await observeRuntime({ pixels: true }),\n    exposedByGame: moduleSurfaces(),\n    // События между модулями: log (последние 50), listeners/emitted (кто что слушает и шлёт) и\n    // mismatches — подсказки вида «слушают @1, а шлют @2».\n    events: eventBusState(),\n  };\n}\n\n/** Выполнить действие модуля и вернуть состояние ПОСЛЕ него — как readPage после клика. */\nasync function gameAction(\n  moduleId: unknown,\n  action: unknown,\n  rawArgs: unknown,\n): Promise<unknown> {\n  const modules = agentModules();\n  const id = typeof moduleId === \"string\" ? moduleId : Object.keys(modules)[0];\n  if (!id) throw new Error(\"no module exposes actions\");\n\n  const api = modules[id];\n  if (!api) throw new Error(`unknown module '${id}'`);\n\n  const name = typeof action === \"string\" ? action : \"\";\n  const fn = api.actions?.[name];\n  if (!fn) {\n    const known = Object.keys(api.actions ?? {}).join(\", \") || \"none\";\n    throw new Error(\n      `unknown action '${name}' for '${id}' — available: ${known}`,\n    );\n  }\n\n  const callArgs =\n    rawArgs && typeof rawArgs === \"object\"\n      ? (rawArgs as Record<string, unknown>)\n      : {};\n  const result = await fn(callArgs);\n\n  // Состояние после действия — то, ради чего действие и звали.\n  return {\n    module: id,\n    action: name,\n    result: result ?? null,\n    state: api.state ? api.state() : null,\n  };\n}\n\n/* ---------------------------------------------------------------- протокол */\n\nasync function handle(\n  cmd: string,\n  args: Record<string, unknown>,\n): Promise<unknown> {\n  switch (cmd) {\n    case \"hello\":\n      return {\n        ready: true,\n        titleId: probeOptions.titleId ?? null,\n        url: window.location.href,\n      };\n\n    case \"readPage\": {\n      const page = await readPage();\n      return {\n        ...page,\n        url: window.location.href,\n        titleId: probeOptions.titleId ?? null,\n      };\n    }\n\n    case \"console\":\n      return { console: consoleLog.slice(), network: networkLog.slice() };\n\n    case \"click\":\n      return await clickRef(args[\"ref\"]);\n\n    case \"type\":\n      return await typeIntoRef(args[\"ref\"], args[\"text\"]);\n\n    case \"gameState\":\n      return await gameState();\n\n    case \"gameAction\":\n      return await gameAction(args[\"module\"], args[\"action\"], args[\"args\"]);\n\n    case \"input\":\n      return await sendInput(args[\"args\"]);\n\n    default:\n      throw new Error(`unknown command '${cmd}'`);\n  }\n}\n\n/**\n * Ставит зонд (и дополняет его данными о тайтле при повторном вызове).\n *\n * Модуль ставит зонд САМ при импорте — см. вызов внизу файла. Это не стилистика: перехват\n * console обязан встать раньше, чем упадёт что-нибудь на старте (например config.ts, который\n * бросает при нераспознанном тайтле), а вызовы из main.tsx исполняются уже ПОСЛЕ того, как\n * отработали тела всех импортированных модулей. Поэтому в main.tsx этот импорт стоит первым.\n *\n * Вне iframe (обычный запуск игры) не делает ничего.\n */\nexport function installPreviewProbe(options: PreviewProbeOptions = {}): void {\n  probeOptions = { ...probeOptions, ...options };\n  if (installed) return;\n  if (typeof window === \"undefined\") return;\n  // Не в iframe — значит это не превью дашборда. Ни перехватов, ни слушателей.\n  if (window.self === window.top) return;\n\n  installed = true;\n  captureConsole();\n  captureNetwork();\n  // Перехваты автоматического наблюдения ставятся ЗДЕСЬ, при импорте зонда, и это единственный\n  // момент, когда они успевают: `getContext` надо подменить раньше, чем движок создаст полотно, а\n  // глобалы `__THREE_DEVTOOLS__` и `__PIXI_*_INIT__` — раньше, чем three.js и Pixi построят свои\n  // рендереры (оба смотрят на них при инициализации и второго шанса представиться не дают).\n  // Phaser своего канала не имеет вовсе — его игру ищут лениво, при сборке снимка.\n  captureFrames();\n  captureCanvases();\n  captureThree();\n  capturePixi();\n\n  window.addEventListener(\"message\", (event: MessageEvent) => {\n    const data = event.data as ProbeRequest | undefined;\n    if (!data || data.wire !== WIRE || typeof data.id !== \"string\") return;\n    // Чужой встраиватель (публичный сайт) сюда не пройдёт — и не узнает, что зонд вообще есть.\n    if (!isAllowedOrigin(event.origin)) return;\n\n    const source = event.source as Window | null;\n    if (!source) return;\n\n    const reply = (payload: Record<string, unknown>): void => {\n      source.postMessage({ wire: WIRE, id: data.id, ...payload }, event.origin);\n    };\n\n    void handle(data.cmd, data.args ?? {})\n      .then((result) => reply({ ok: true, data: result }))\n      .catch((error: unknown) =>\n        reply({ ok: false, error: stringifyArg(error) }),\n      );\n  });\n}\n\n// Само-установка при импорте — см. комментарий выше.\ninstallPreviewProbe();\n"
-    },
     {
       "path": "src/ui.config.ts",
       "content": "import { defineUiConfig } from \"@idosgames/react/ui\";\n\n// The game's interface in ONE place: colours, animations and sounds of every module built on\n// @idosgames/react/ui (shop, inventory, heroes, rewards, marketplace, …). Change them here — never in\n// a module: an edited catalog module is marked \"customized\" and stops getting catalog updates.\n//\n// Everything is optional; what you leave out keeps its default. Uncomment and edit.\nexport default defineUiConfig({\n  theme: {\n    // bgTop: \"#232a6b\",          // screen background, top of the gradient\n    // bgBottom: \"#0d1033\",       // … and bottom\n    // panel: \"#2c3480\",          // cards and popups\n    // panelEdge: \"#4f5bc9\",      // their frame\n    // gold: \"#ffd24a\",           // prices, highlights, the \"claim\" button\n    // green: \"#59d35b\",          // main action buttons\n    // radius: 18,                // corner radius of cards, px\n    // buttonRadius: 14,          // corner radius of buttons, px\n    // font: \"'Baloo 2', 'Nunito', system-ui, sans-serif\",\n    // rarity: { Mythic: \"#ff3df5\" },   // frame colour of a rarity id (adds to Common…Legendary)\n  },\n  motion: {\n    // enabled: true,             // false — no animations at all\n    // speed: 1,                  // 2 — twice as fast, 0.5 — twice as slow\n    // intensity: 1,              // bounce/overshoot strength: 0 none … 2 cartoonish\n    // rewardFlight: true,        // reward icons fly to the balance counters\n    // particles: true,           // particle bursts on claims and purchases\n    // stagger: true,             // lists appear item by item\n    // respectReducedMotion: true,// follow the system \"reduce motion\" setting\n  },\n  sound: {\n    // enabled: true,             // false — a silent interface\n    // volume: 0.6,               // master volume 0..1 (the player's own volume multiplies it)\n    events: {\n      // Built-in sounds are synthesized in code (no files). Per event:\n      //   \"coin\"                         — the built-in sound of another event\n      //   { url: \"https://…/click.mp3\" } — your own file (optional volume: 0..1)\n      //   { synth: { notes: [{ freq: 880, dur: 0.08, wave: \"triangle\" }] } } — your own synth\n      //   false                          — silence\n      // Events: click, tab, open, close, reward, coin, purchase, claim, error, notify, lootbox,\n      // levelUp, countTick.\n      // click: \"tab\",\n      // countTick: false,\n    },\n  },\n});\n"
@@ -125,17 +61,21 @@
       "path": "src/vite-env.d.ts",
       "content": "/// <reference types=\"vite/client\" />\n"
     },
+    {
+      "path": "src/walletButton.tsx",
+      "content": "import { useState, type CSSProperties, type ReactNode } from \"react\";\nimport {\n  LazyWalletPanel,\n  isEmbeddedInPlatform,\n  isEmbeddedOnForeignSite,\n  openPlatformWalletPanel,\n  useWalletTopUp,\n} from \"@idosgames/wallet/react/lazy\";\nimport { useIDosGamesClient } from \"@idosgames/react\";\nimport {\n  Icon,\n  makeT,\n  outlined,\n  Popup,\n  useGameLayout,\n  useUiKit,\n  well,\n} from \"@idosgames/react/ui\";\n\n// The one string of the button; the rest of the lobby's strings live in the SDK.\nconst t = makeT<\"wallet\" | \"topUp\">(\n  { wallet: \"Wallet\", topUp: \"Top up\" },\n  { wallet: \"Кошелёк\", topUp: \"Пополнение\" },\n);\n\n// The lobby's wallet button (passed to `createBaseModule` in main.tsx as `WalletButton`). The base is in\n// @idosgames/app-shell and knows nothing about the wallet stack, so the project owns this file.\n//\n// The app's one wallet entry (deposit / withdraw), next to the balances in the lobby header, on any\n// web3 title — EVM or Solana, the panel is the same and picks the chain by itself.\n//\n// Where the game runs decides what the button does (owner, 2026-09-29):\n//  - inside idosgames.com's frame — crypto goes through the SITE's wallet card only, so the button\n//    asks the page to show it (`openPlatformWalletPanel`); the game never opens a wallet there;\n//  - framed by somebody else's site — no button: there is no wallet of ours to show;\n//  - by its own link (`{id}.idos.games`, a custom domain, the AI Coder preview) — the game's own\n//    panel with its own wallet connection.\n//\n// Import is \"@idosgames/wallet/react/lazy\", NOT \"@idosgames/wallet/react\": the latter pulls Reown\n// AppKit into the startup graph. The wallet config is memoised per project id, so a wallet connected\n// on the sign-in screen is already connected here.\n\nexport function WalletButton(): ReactNode {\n  const client = useIDosGamesClient();\n  const kit = useUiKit();\n  const layout = useGameLayout();\n  const [open, setOpen] = useState(false);\n  const embedded = isEmbeddedInPlatform();\n\n  if (isEmbeddedOnForeignSite()) return null;\n\n  return (\n    <>\n      <button\n        type=\"button\"\n        className=\"idos-press\"\n        aria-label={t(\"wallet\")}\n        onClick={() => {\n          kit.play(\"click\");\n          if (embedded) void openPlatformWalletPanel();\n          else setOpen(true);\n        }}\n        style={chip}\n        data-tutorial-anchor=\"lobby:wallet\"\n      >\n        <Icon glyph=\"👛\" size={layout === \"phone\" ? 26 : 22} />\n        {layout !== \"phone\" ? <span>{t(\"wallet\")}</span> : null}\n      </button>\n      {open && !embedded ? (\n        <Popup title={t(\"wallet\")} onClose={() => setOpen(false)} width={420}>\n          <LazyWalletPanel client={client} appName=\"iDosGames\" />\n        </Popup>\n      ) : null}\n    </>\n  );\n}\n\nconst chip: CSSProperties = {\n  ...outlined,\n  display: \"inline-flex\",\n  alignItems: \"center\",\n  gap: 6,\n  padding: \"3px 10px 3px 5px\",\n  borderRadius: 999,\n  ...well,\n  cursor: \"pointer\",\n  whiteSpace: \"nowrap\",\n  fontSize: 14,\n};\n\n// The top-up window (passed to `createBaseModule` as `WalletTopUp`; the base keeps it mounted over every\n// mode). A purchase refused because the player is short on crypto opens the game's own wallet on the\n// missing amount, and the purchase repeats by itself once the deposit is credited (owner, 2026-10-09).\n// Inside idosgames.com's frame the SITE's window does this instead, and this renders nothing.\nexport function WalletTopUp(): ReactNode {\n  const client = useIDosGamesClient();\n  const request = useWalletTopUp(client);\n  if (!request) return null;\n  return (\n    <Popup title={t(\"topUp\")} onClose={() => request.onDone(false)} width={420}>\n      {/* A new shortfall is a new panel: it picks its network for the currency once. */}\n      <LazyWalletPanel\n        key={`${request.currencyID}:${request.amount}`}\n        client={client}\n        appName=\"iDosGames\"\n        topUp={request}\n      />\n    </Popup>\n  );\n}\n"
+    },
     {
       "path": "src/walletLogin.tsx",
-      "content": "import { LazyWalletLogin } from \"@idosgames/wallet/react/lazy\";\nimport type { RenderLinkWallet } from \"@idosgames/app-shell\";\nimport type { LoginScreenExtras } from \"./base/login/LoginScreen\";\nimport { ENV_WALLETCONNECT_PROJECT_ID } from \"./env\";\nimport {\n  IDOS_WEB3_NETWORK_ID,\n  IDOS_WEB3_WALLETCONNECT_PROJECT_ID,\n} from \"./idos.title\";\n\n// Wallet sign-in seam — ON by default: every project offers \"Sign in with wallet\".\n//\n// The button uses the SDK's default EVM chain set (no `chains` prop). The challenge network comes\n// from the title (IDOS_WEB3_NETWORK_ID, baked by the platform); the \"bsc\" fallback keeps the button\n// alive on titles that did not pick a network at creation. A title whose Blockchain config is empty\n// will surface the server's error under the button — fix that by configuring the network (backend\n// MCP: get_blockchain / save_blockchain), not by hiding the button. To restrict the chains, import\n// them from this same subpath (mainnet, bsc, polygon, base, arbitrum, optimism, sepolia,\n// polygonAmoy — plain objects, safe to import) and pass `chains={[…]}`.\n//\n// For a title created with the web3 toggle the platform regenerates this file with the title's own\n// network. Keeping the seam in its own file is what makes that swap (and your own edits) safe.\n//\n// The import is \"@idosgames/wallet/react/lazy\", NOT \"@idosgames/wallet/react\". The wallet stack\n// (Reown AppKit + wagmi/viem) is megabytes of code most players never need; the lazy entry keeps it\n// out of the first load until the player actually taps sign-in.\n//\n// walletConnectProjectId adds MOBILE wallets via the WalletConnect QR/deep-link modal; without it\n// the button only works with injected wallets (MetaMask & co) and mobile login is unavailable. It\n// comes from the title's blockchain config (IDOS_WEB3_WALLETCONNECT_PROJECT_ID, baked by the\n// platform); VITE_WALLETCONNECT_PROJECT_ID in .env.local is a local-dev fallback.\n//\n// No `chains` is passed on purpose: the button falls back to the SDK's default EVM chain set, which\n// is the SAME list the in-game wallet panel uses. That shared list is what lets the login and the\n// panel share one wallet config, so a wallet connected here stays connected in the game.\n\nexport const renderWalletLogin: LoginScreenExtras[\"renderWalletLogin\"] = ({\n  client,\n  onAuthenticated,\n  disabled,\n  style,\n}) => (\n  <LazyWalletLogin\n    client={client}\n    networkID={IDOS_WEB3_NETWORK_ID || \"bsc\"}\n    onAuthenticated={onAuthenticated}\n    disabled={disabled}\n    style={style}\n    walletConnectProjectId={\n      IDOS_WEB3_WALLETCONNECT_PROJECT_ID ||\n      ENV_WALLETCONNECT_PROJECT_ID ||\n      undefined\n    }\n  />\n);\n\n// \"Link wallet\" on the play-access screen (./base/login/PlayAccessScreen) — the same button in link mode. When\n// the title's login mode requires a token balance, a player who signed in another way attaches a\n// wallet to the account by signature, and the server checks the balance against exactly that\n// wallet. `networkID` is the network a requirement needs; the title's own network otherwise.\nexport const renderWalletLink: RenderLinkWallet = ({\n  client,\n  networkID,\n  onLinked,\n  disabled,\n  style,\n}) => (\n  <LazyWalletLogin\n    mode=\"link\"\n    client={client}\n    networkID={networkID || IDOS_WEB3_NETWORK_ID || \"bsc\"}\n    onLinked={onLinked}\n    disabled={disabled}\n    style={style}\n    walletConnectProjectId={\n      IDOS_WEB3_WALLETCONNECT_PROJECT_ID ||\n      ENV_WALLETCONNECT_PROJECT_ID ||\n      undefined\n    }\n  />\n);\n"
+      "content": "import { LazyWalletLogin } from \"@idosgames/wallet/react/lazy\";\nimport type { RenderLinkWallet, RenderWalletLogin } from \"@idosgames/app-shell\";\nimport { ENV_WALLETCONNECT_PROJECT_ID } from \"./env\";\nimport {\n  IDOS_WEB3_NETWORK_ID,\n  IDOS_WEB3_WALLETCONNECT_PROJECT_ID,\n} from \"./idos.title\";\n\n// Wallet sign-in seam — ON by default: every project offers \"Sign in with wallet\".\n//\n// The button uses the SDK's default EVM chain set (no `chains` prop). The challenge network comes\n// from the title (IDOS_WEB3_NETWORK_ID, baked by the platform); the \"bsc\" fallback keeps the button\n// alive on titles that did not pick a network at creation. A title whose Blockchain config is empty\n// will surface the server's error under the button — fix that by configuring the network (backend\n// MCP: get_blockchain / save_blockchain), not by hiding the button. To restrict the chains, import\n// them from this same subpath (mainnet, bsc, polygon, base, arbitrum, optimism, sepolia,\n// polygonAmoy — plain objects, safe to import) and pass `chains={[…]}`.\n//\n// For a title created with the web3 toggle the platform regenerates this file with the title's own\n// network. Keeping the seam in its own file is what makes that swap (and your own edits) safe.\n//\n// The import is \"@idosgames/wallet/react/lazy\", NOT \"@idosgames/wallet/react\". The wallet stack\n// (Reown AppKit + wagmi/viem) is megabytes of code most players never need; the lazy entry keeps it\n// out of the first load until the player actually taps sign-in.\n//\n// walletConnectProjectId adds MOBILE wallets via the WalletConnect QR/deep-link modal; without it\n// the button only works with injected wallets (MetaMask & co) and mobile login is unavailable. It\n// comes from the title's blockchain config (IDOS_WEB3_WALLETCONNECT_PROJECT_ID, baked by the\n// platform); VITE_WALLETCONNECT_PROJECT_ID in .env.local is a local-dev fallback.\n//\n// No `chains` is passed on purpose: the button falls back to the SDK's default EVM chain set, which\n// is the SAME list the in-game wallet panel uses. That shared list is what lets the login and the\n// panel share one wallet config, so a wallet connected here stays connected in the game.\n\nexport const renderWalletLogin: RenderWalletLogin = ({\n  client,\n  onAuthenticated,\n  disabled,\n  style,\n}) => (\n  <LazyWalletLogin\n    client={client}\n    networkID={IDOS_WEB3_NETWORK_ID || \"bsc\"}\n    onAuthenticated={onAuthenticated}\n    disabled={disabled}\n    style={style}\n    walletConnectProjectId={\n      IDOS_WEB3_WALLETCONNECT_PROJECT_ID ||\n      ENV_WALLETCONNECT_PROJECT_ID ||\n      undefined\n    }\n  />\n);\n\n// \"Link wallet\" on the play-access screen (mounted in ./main.tsx) — the same button in link mode. When\n// the title's login mode requires a token balance, a player who signed in another way attaches a\n// wallet to the account by signature, and the server checks the balance against exactly that\n// wallet. `networkID` is the network a requirement needs; the title's own network otherwise.\nexport const renderWalletLink: RenderLinkWallet = ({\n  client,\n  networkID,\n  onLinked,\n  disabled,\n  style,\n}) => (\n  <LazyWalletLogin\n    mode=\"link\"\n    client={client}\n    networkID={networkID || IDOS_WEB3_NETWORK_ID || \"bsc\"}\n    onLinked={onLinked}\n    disabled={disabled}\n    style={style}\n    walletConnectProjectId={\n      IDOS_WEB3_WALLETCONNECT_PROJECT_ID ||\n      ENV_WALLETCONNECT_PROJECT_ID ||\n      undefined\n    }\n  />\n);\n"
     },
     {
       "path": "tsconfig.json",
-      "content": "{\n  \"$schema\": \"https://json.schemastore.org/tsconfig\",\n  // Self-contained on purpose: this template is copied out of the monorepo (as the seed for an AI\n  // Coder project) and must typecheck on its own, so it does not `extends` tsconfig.base.json. Keep\n  // the shared options below in sync with tsconfig.base.json.\n  \"compilerOptions\": {\n    \"target\": \"ES2022\",\n    \"lib\": [\"ES2022\", \"DOM\", \"DOM.Iterable\"],\n    \"module\": \"ESNext\",\n    \"moduleResolution\": \"Bundler\",\n\n    \"strict\": true,\n    \"noUncheckedIndexedAccess\": true,\n    \"noImplicitOverride\": true,\n    \"noFallthroughCasesInSwitch\": true,\n    \"useUnknownInCatchVariables\": true,\n\n    \"verbatimModuleSyntax\": true,\n    \"isolatedModules\": true,\n    \"esModuleInterop\": true,\n    \"resolveJsonModule\": true,\n    \"skipLibCheck\": true,\n    \"forceConsistentCasingInFileNames\": true,\n\n    \"noEmit\": true,\n    \"jsx\": \"react-jsx\",\n\n    // Inside the monorepo these point typecheck at the SDK/host source, so no SDK build is needed.\n    // Outside it the paths do not exist and TypeScript falls back to node_modules resolution.\n    \"paths\": {\n      \"@idosgames/core\": [\"../../packages/core/src/index.ts\"],\n      \"@idosgames/core/realtime\": [\"../../packages/core/src/realtime/index.ts\"],\n      \"@idosgames/module-sdk\": [\"../../packages/module-sdk/src/index.ts\"],\n      \"@idosgames/react/ui\": [\"../../packages/react/src/ui/index.ts\"],\n      \"@idosgames/react\": [\"../../packages/react/src/index.ts\"],\n      \"@idosgames/app-shell\": [\"../../packages/app-shell/src/index.ts\"]\n    }\n  },\n  \"include\": [\"src\"],\n  // Tests are not part of the game: the platform builds with no test runner installed, so a\n  // `*.test.ts` that imports vitest would fail every release build. Keep them out of the typecheck.\n  \"exclude\": [\n    \"src/**/*.test.ts\",\n    \"src/**/*.test.tsx\",\n    \"src/**/*.spec.ts\",\n    \"src/**/*.spec.tsx\"\n  ]\n}\n"
+      "content": "{\n  \"$schema\": \"https://json.schemastore.org/tsconfig\",\n  // Self-contained on purpose: this template is copied out of the monorepo (as the seed for an AI\n  // Coder project) and must typecheck on its own, so it does not `extends` tsconfig.base.json. Keep\n  // the shared options below in sync with tsconfig.base.json.\n  \"compilerOptions\": {\n    \"target\": \"ES2022\",\n    \"lib\": [\"ES2022\", \"DOM\", \"DOM.Iterable\"],\n    \"module\": \"ESNext\",\n    \"moduleResolution\": \"Bundler\",\n\n    \"strict\": true,\n    \"noUncheckedIndexedAccess\": true,\n    \"noImplicitOverride\": true,\n    \"noFallthroughCasesInSwitch\": true,\n    \"useUnknownInCatchVariables\": true,\n\n    \"verbatimModuleSyntax\": true,\n    \"isolatedModules\": true,\n    \"esModuleInterop\": true,\n    \"resolveJsonModule\": true,\n    \"skipLibCheck\": true,\n    \"forceConsistentCasingInFileNames\": true,\n\n    \"noEmit\": true,\n    \"jsx\": \"react-jsx\",\n\n    // Inside the monorepo these point typecheck at the SDK/host source, so no SDK build is needed.\n    // Outside it the paths do not exist and TypeScript falls back to node_modules resolution.\n    \"paths\": {\n      \"@idosgames/core\": [\"../../packages/core/src/index.ts\"],\n      \"@idosgames/core/realtime\": [\"../../packages/core/src/realtime/index.ts\"],\n      \"@idosgames/module-sdk\": [\"../../packages/module-sdk/src/index.ts\"],\n      \"@idosgames/react/ui\": [\"../../packages/react/src/ui/index.ts\"],\n      \"@idosgames/react\": [\"../../packages/react/src/index.ts\"],\n      \"@idosgames/app-shell/preview-probe\": [\n        \"../../packages/app-shell/src/preview-probe.ts\"\n      ],\n      \"@idosgames/app-shell\": [\"../../packages/app-shell/src/index.ts\"]\n    }\n  },\n  \"include\": [\"src\"],\n  // Tests are not part of the game: the platform builds with no test runner installed, so a\n  // `*.test.ts` that imports vitest would fail every release build. Keep them out of the typecheck.\n  \"exclude\": [\n    \"src/**/*.test.ts\",\n    \"src/**/*.test.tsx\",\n    \"src/**/*.spec.ts\",\n    \"src/**/*.spec.tsx\"\n  ]\n}\n"
     },
     {
       "path": "vite.config.ts",
-      "content": "import { existsSync } from \"node:fs\";\nimport { fileURLToPath } from \"node:url\";\nimport { defineConfig } from \"vite\";\nimport react from \"@vitejs/plugin-react\";\n\nconst fromHere = (path: string): string =>\n  fileURLToPath(new URL(path, import.meta.url));\n\n// Inside this monorepo, resolve the @idosgames/* packages to their source for instant HMR (no SDK/\n// host rebuild needed in dev). A standalone copy of this template — a cloned starter, or an AI Coder\n// project built in a container — has no such paths and resolves each package from node_modules.\nconst sourceAliases: Record<string, string> = {\n  // ⚠ Subpaths BEFORE the package: a string alias matches its prefix too, so \"@idosgames/core\"\n  // would turn \"@idosgames/core/realtime\" into \".../src/index.ts/realtime\".\n  \"@idosgames/core/realtime\": fromHere(\n    \"../../packages/core/src/realtime/index.ts\",\n  ),\n  \"@idosgames/core\": fromHere(\"../../packages/core/src/index.ts\"),\n  \"@idosgames/module-sdk\": fromHere(\"../../packages/module-sdk/src/index.ts\"),\n  \"@idosgames/react/ui\": fromHere(\"../../packages/react/src/ui/index.ts\"),\n  \"@idosgames/react\": fromHere(\"../../packages/react/src/index.ts\"),\n  \"@idosgames/app-shell\": fromHere(\"../../packages/app-shell/src/index.ts\"),\n};\n\n// Env comes the standard Vite way: VITE_* variables of .env.local reach the code as\n// `import.meta.env.VITE_*` (src/env.ts, src/config.ts). VITE_IDOS_ENV (\"dev\" | \"prod\") picks which\n// copy of the title a LOCAL run talks to; hosted builds take it from their address instead.\nexport default defineConfig(() => {\n  const alias = Object.fromEntries(\n    Object.entries(sourceAliases).filter(([, path]) => existsSync(path)),\n  );\n  return {\n    plugins: [react()],\n    resolve: { alias },\n    server: { port: 5180 },\n  };\n});\n"
+      "content": "import { existsSync } from \"node:fs\";\nimport { fileURLToPath } from \"node:url\";\nimport { defineConfig } from \"vite\";\nimport react from \"@vitejs/plugin-react\";\n\nconst fromHere = (path: string): string =>\n  fileURLToPath(new URL(path, import.meta.url));\n\n// Inside this monorepo, resolve the @idosgames/* packages to their source for instant HMR (no SDK/\n// host rebuild needed in dev). A standalone copy of this template — a cloned starter, or an AI Coder\n// project built in a container — has no such paths and resolves each package from node_modules.\nconst sourceAliases: Record<string, string> = {\n  // ⚠ Subpaths BEFORE the package: a string alias matches its prefix too, so \"@idosgames/core\"\n  // would turn \"@idosgames/core/realtime\" into \".../src/index.ts/realtime\".\n  \"@idosgames/core/realtime\": fromHere(\n    \"../../packages/core/src/realtime/index.ts\",\n  ),\n  \"@idosgames/core\": fromHere(\"../../packages/core/src/index.ts\"),\n  \"@idosgames/module-sdk\": fromHere(\"../../packages/module-sdk/src/index.ts\"),\n  \"@idosgames/react/ui\": fromHere(\"../../packages/react/src/ui/index.ts\"),\n  \"@idosgames/react\": fromHere(\"../../packages/react/src/index.ts\"),\n  \"@idosgames/app-shell/preview-probe\": fromHere(\n    \"../../packages/app-shell/src/preview-probe.ts\",\n  ),\n  \"@idosgames/app-shell\": fromHere(\"../../packages/app-shell/src/index.ts\"),\n};\n\n// Env comes the standard Vite way: VITE_* variables of .env.local reach the code as\n// `import.meta.env.VITE_*` (src/env.ts, src/config.ts). VITE_IDOS_ENV (\"dev\" | \"prod\") picks which\n// copy of the title a LOCAL run talks to; hosted builds take it from their address instead.\nexport default defineConfig(() => {\n  const alias = Object.fromEntries(\n    Object.entries(sourceAliases).filter(([, path]) => existsSync(path)),\n  );\n  return {\n    plugins: [react()],\n    resolve: { alias },\n    server: { port: 5180 },\n  };\n});\n"
     }
   ]
 }