Merge pull request 'chore(release): promote development to master' (#258 ) from development into master

Merge pull request 'feat(tg-bot): unpin auto-forwarded channel posts' (#257 ) from feature/tg-unpin-linked-channel-post into development
feat(tg-bot): unpin auto-forwarded channel posts
2026-07-13 22:21:59 +00:00 · 2026-07-13 22:13:15 +00:00 · 2026-07-14 00:07:46 +02:00 · 2026-07-13 21:42:51 +00:00 · 2026-07-13 23:25:26 +02:00 · 2026-07-13 20:59:22 +00:00
133 changed files with 3179 additions and 547 deletions
@@ -30,7 +30,7 @@ on it**, and prefer the authoritative docs where they overlap. Add to this file
 ## Native Android build (Capacitor)
-The native Android app (`ANDROID_PLAN.md`) is a Capacitor 8 wrapper of the `ui` SPA, scaffolded under
+The native Android app is a Capacitor 8 wrapper of the `ui` SPA, scaffolded under
 `ui/` (a Node project outside `go.work`). Hard-won bring-up facts — verify against current code:
 - **Capacitor 8 needs JDK 21, not 17.** `@capacitor/android` compiles at `VERSION_21`; a JDK 17 Gradle
@@ -234,9 +234,9 @@ The native Android app (`ANDROID_PLAN.md`) is a Capacitor 8 wrapper of the `ui`
  `--pg1-user=scrabble`.
 - **Offline mode** — the robot brain, move generator/validator/scorer and DAWG reader are **JS ports**
  of the Go engine, bundled client-side and **parity-pinned** by golden tests. Multi-phase; native
-  offline-first bundles the dictionaries (see `ANDROID_PLAN.md`).
+  offline-first bundles the dictionaries.
 - **VK ID web login** — raw OAuth 2.1 against `id.vk.com`, a **separate VK "Web" app** from the Mini
  App, server-side confidential code exchange.
 - **Email relay** — Selectel SMTP + confirm / link / unlink / deletion codes + alerts.
- **Native Android** — see `ANDROID_PLAN.md` (Capacitor bundle model, client-version gate,
+- **Native Android** — Capacitor bundle model, client-version gate, offline-first, RuStore; the
-  offline-first, RuStore).
+  design lives in `docs/ARCHITECTURE.md` (§2 gate, §3 identity, §13 native build).
@@ -5,9 +5,9 @@
 #
 # Signing degrades gracefully: with the ANDROID_KEYSTORE_* secrets present the APK is signed; without
 # them build.gradle produces an UNSIGNED release APK (so a dry run still proves the whole pipeline).
-# The keystore is a publication prerequisite — see deploy/README.md (Android build/release runbook) and
+# The keystore is a publication prerequisite — see deploy/README.md (Android build/release runbook).
-# ANDROID_PLAN.md §E. The toolchain is self-provisioned here (JDK 21 + a cached Android SDK), so the
+# The toolchain is self-provisioned here (JDK 21 + a cached Android SDK), so the runner host needs
-# runner host needs nothing pre-installed.
+# nothing pre-installed.
 name: android-build
 run-name: "android build ${{ github.sha }}"
@@ -522,10 +522,21 @@ jobs:
          # (the seller INN, §11) AND that the pricing marker was substituted (proves the fetch +
          # splice ran), never just the status. Data-independent: an empty catalog still substitutes
          # the marker with nothing, so "pricing_template" must be absent either way.
-          out="$(docker run --rm --network edge alpine:3.20 wget -q -O - http://scrabble/offer/ 2>&1 || true)"
+          # Full body is needed (the INN is in §11 and the marker check spans the page), so this
-          if echo "$out" | grep -q "290210610742" && ! echo "$out" | grep -q "pricing_template"; then
+          # cannot be a head-only probe like the legal one. Retry with a timeout instead: the offer is
-            echo "ok: /offer/ serves the rendered offer with the price list spliced in"
+          # now bilingual (RU + EN, larger), and a single-shot fetch can race the renderer's restart in
-          else
+          # the same deploy.
          ok=
          for i in $(seq 1 20); do
            out="$(docker run --rm --network edge alpine:3.20 wget -q -T 10 -O - http://scrabble/offer/ 2>&1 || true)"
            if echo "$out" | grep -q "290210610742" && ! echo "$out" | grep -q "pricing_template"; then
              echo "ok: /offer/ serves the rendered offer with the price list spliced in"
              ok=1
              break
            fi
            sleep 3
          done
          if [ -z "$ok" ]; then
            echo "FAIL: /offer/ did not serve the rendered offer (route fell through, or the price splice failed)"
            docker logs --tail 50 scrabble-renderer || true
            docker logs --tail 50 scrabble-backend || true
@@ -533,6 +544,35 @@ jobs:
            exit 1
          fi
      - name: Probe the /privacy/ and /eula/ legal pages are served
        run: |
          set -u
          # /privacy/ and /eula/ are static legal markdown rendered by the render sidecar. If the
          # @legal caddy route is missing they fall to the landing shell (also 200, canonical
          # erudit-game.ru/), so assert the page-specific canonical URL — it uniquely identifies the
          # rendered legal doc reaching the edge, not the landing catch-all. Read only the <head>
          # (head -c 4096; the canonical link sits in the first bytes): the check is then
          # size-independent, so the large EULA page does not exceed the timeout while the monitoring
          # stack is still booting post-deploy and starving the CPU-capped renderer. Retry like the
          # landing/gateway/backend probe to ride out that window.
          for route in privacy eula; do
            ok=
            for i in $(seq 1 20); do
              head_out="$(docker run --rm --network edge alpine:3.20 sh -c "wget -q -T 10 -O - http://scrabble/${route}/ 2>/dev/null | head -c 4096" || true)"
              if printf '%s' "$head_out" | grep -qF "erudit-game.ru/${route}/"; then
                echo "ok: /${route}/ serves the rendered legal page"
                ok=1
                break
              fi
              sleep 3
            done
            if [ -z "$ok" ]; then
              echo "FAIL: /${route}/ did not serve the rendered legal page (@legal route missing?)"
              docker logs --tail 50 scrabble-renderer || true
              exit 1
            fi
          done
      - name: Probe the /pay/ callback route reaches the gateway
        run: |
          set -u
@@ -62,15 +62,86 @@ client-only (no server change).
 Kept current as parts land so a fresh session resumes without re-deriving. Verify against code.
 > ### ▶ RESUME HERE — 2026-07-13 (documents track + release-prep)
 >
 > **Where we are.** The legal-documents track, the release-prep hygiene, **and the icon rebrand** are
 > DONE. The RuStore release is now gated on **owner-side** items only (keystore, RuStore account) plus
 > the merge/tag chain. Do not re-do or re-litigate the finished work; do not re-ask the locked decisions.
 >
 > **Branches / PRs (current working branch: `feature/android-release-prep`).**
 > - `development` — has the **legal-documents track**, merged via **PR #253** (green, deployed to the
 >   test contour). `/privacy/`, `/eula/`, `/offer/` are live there, bilingual RU/EN.
 > - `feature/android-release-prep` — the **release-prep hygiene**, **PR #254 OPEN, green, NOT merged**
 >   (the owner chose to hold the merge). It is branched off `development`, so it also contains the
 >   legal-documents track. Merge #254 into `development` when ready — needs **owner approval** (the
 >   agent cannot self-approve).
 >
 > **Done this session.**
 > - **Legal documents** (satisfies the RuStore *hosted privacy-policy URL* prerequisite): authored
 >   `ui/legal/{privacy,eula,offer}_{ru,en}.md`; served as **bilingual (RU/EN)** standalone pages by the
 >   render sidecar at `/privacy/`, `/eula/`, `/offer/` via the shared `ui/src/lib/offer.ts`
 >   `renderLegalHtml`, with a client-side **language + theme switcher** (🌐 + ☼/☾, no "back", default
 >   Russian + persisted, mirroring the landing). The offer's EN view **transliterates** the Russian
 >   product names and **translates** the price-list section headings + column headers (`PRICE_TR`).
 >   Edge: `@legal` caddy matcher (`/offer/ /privacy/ /eula/`) + CI probes (size-independent head-only
 >   for the legal pages, retry for the offer). Landing footer links: Пользовательское соглашение |
 >   Политика конфиденциальности | Публичная оферта | Обратная связь (→ the Telegram bot). Docs baked
 >   into `docs/ARCHITECTURE.md`, `docs/FUNCTIONAL.md` (+`_ru`), `renderer/README.md`.
 >   **Locked legal decisions — do NOT re-litigate:** seller **INN `290210610742`**; EULA §14 leads
 >   with **RF law + jurisdiction** as residence tiers (France / England&Wales retained as foreign
 >   tiers); the "only the English version is legally binding" clause is **removed**; data collection is
 >   kept but **scoped to voluntary/support provision** (passport/payment/ID only when the user provides
 >   them); «Компания» is not shout-cased; the offer's EN catalog product names are **transliterated**
 >   (owner-chosen), while its headings/columns are translated.
 > - **Release-prep hygiene (PR #254):** de-anchored `ANDROID_PLAN.md` from all code/docs — **no
 >   reference to this file remains anywhere outside it**; **re-enabled the `android-build` workflow**
 >   (`.gitea/workflows/android-build.yaml.disabled` → `.yaml`; it is `workflow_dispatch`-only + gated
 >   `if master`, so it never auto-runs; the CI host already has the Android SDK at `/opt/android-sdk`);
 >   added [`docs/ICONS.md`](docs/ICONS.md) (the single-master icon/logo format reference).
 >
 > **Remaining to release (owner-gated unless the agent is named).**
 > 1. **Icon rebrand — DONE.** The SVG-tracer export failed, so the icon was designed **collaboratively
 >    from scratch** (wooden «Э» tile + ✻ subscript, Spectral Bold). The construction is fully specified
 >    in fractions of the side in [`docs/ICON_BRANDBOOK.md`](docs/ICON_BRANDBOOK.md), with the reference
 >    generator + pinned font + masters in [`assets/icons/brand/`](assets/icons/brand/). One master →
 >    the whole set sliced by `brand/build-set.mjs` (+ `build-android-res.mjs`): web (favicon light+dark,
 >    apple-touch, PWA any + maskable, og-image reskinned to «Эрудит» / Игра в слова), the Capacitor
 >    layers `ui/assets/{icon,icon-foreground,icon-background}.png`, the Android launcher res (all
 >    densities, **no inset**, **+ monochrome** themed layer), and manual-upload art (`brand/{vk,tg,store}`).
 >    Primary variant **light**; dark where the platform can theme (favicon.svg). The old LiberationSans
 >    generator (`assets/icons/build/`) is removed; targets are mapped in `docs/ICONS.md`.
 > 2. **Merge PR #254** → `development` (owner approval), then **promote `development` → `master`** and
 >    **tag `vX.Y.Z`** for the release (the version stamps the APK `versionName`/`versionCode` and the
 >    `X-Client-Version` header).
 > 3. **Release keystore.** OWNER generates it (`keytool -genkeypair -v -keystore erudit-release.jks
 >    -alias erudit -keyalg RSA -keysize 4096 -validity 10000`), base64-encodes it, sets the four Gitea
 >    **secrets** `ANDROID_KEYSTORE_BASE64` / `ANDROID_KEYSTORE_PASSWORD` / `ANDROID_KEY_ALIAS` /
 >    `ANDROID_KEY_PASSWORD`, and backs the `.jks` up **off-host** (loss ⇒ the app can never be updated).
 >    The AGENT provides the exact commands on request. Without the secrets the workflow builds an
 >    UNSIGNED APK (a dry run still proves the pipeline).
 > 4. **RuStore developer account.** OWNER (verified legal entity or self-employed / самозанятый). Gates
 >    publication, not the build.
 > 5. **Dispatch the signed build.** AGENT: on `master`, dispatch `android-build` (`confirm=build`) via
 >    `tea`, watch to green, retrieve the signed APK artifact (verify Gitea 1.26 `upload-artifact@v4` at
 >    the dispatch).
 > 6. **On-device smoke.** OWNER installs the signed APK and runs the airplane-mode first-launch
 >    checklist (`docs/TESTING.md`). The AGENT can pre-run the emulator smoke.
 > 7. **Store listing.** Reserve `ru.eruditgame.app`, title «Эрудит», RU description, phone screenshots,
 >    icon / feature graphic, age rating, the **privacy-policy URL `https://erudit-game.ru/privacy/`**
 >    (now available), the content declaration.
 > 8. **Upload to RuStore.** OWNER. After publication, set the `ANDROID_RUSTORE_URL` Gitea variable to
 >    the store deep-link so the update button works on future gated releases (empty until then — the
 >    gate is dormant in the MVP).
 - **A. Capacitor scaffolding — ✅ DONE & verified (2026-07-12).** Capacitor 8 native project generated
  under `ui/android/` (tracked), `@capacitor/*` deps + `capacitor.config.ts`, hardware Back in
  `ui/src/lib/native.ts` wired from `App.svelte`. `pnpm build` → `cap sync` → `./gradlew assembleDebug`
  builds a debug APK that installs and **cold-launches to the Login screen** on the Pixel_10 emulator.
  `svelte-check` 0 errors, `vitest` 584 passed. Build recipe + toolchain gotchas live in
  `.claude/CLAUDE.md` → "Native Android build (Capacitor)".
-  **Launcher icon:** a **temporary** placeholder is in place — `ui/assets/icon.png` (the maskable «Э»
+  **Launcher icon:** the temporary placeholder was **superseded by the icon rebrand** — the launcher
-  brand mark upscaled 512→1024) → `pnpm android:assets` regenerated the Android launcher/adaptive
+  now uses the two-layer adaptive icon (background + foreground + monochrome) generated from the brand
-  icons + splashes. Superseded by the icon rebrand below.
+  master; see the RESUME block (item 1), `docs/ICON_BRANDBOOK.md` and `docs/ICONS.md`.
 - **B. Native web-build correctness — ✅ DONE & verified (2026-07-12).** New `ui/src/lib/origin.ts`
  `gatewayOrigin()`; the two `location.origin` landmines fixed (`game/Game.svelte` export/share URL,
  `screens/Wallet.svelte` site-root) — `transport.ts:32` already resolves via `VITE_GATEWAY_URL`, left
@@ -181,11 +252,10 @@ Kept current as parts land so a fresh session resumes without re-deriving. Verif
  then O2–O7; the release chain (PR→development→contour→master→tag→dispatch `android-build`) follows. None of
  O1–O7 is started. Branch `feature/android-native`, local/unpushed.
-Open logistics (not code): **mandatory icon rebrand (future)** — author ONE vector master and generate
+Icon rebrand — **DONE** (was "one master → every icon"): a single Spectral «Э» master now drives web
-*every* icon from it (web `favicon.svg` / PWA `icon-*` / maskable, Android adaptive, future iOS). Today
+(favicon light+dark / PWA any + maskable / apple-touch / og), the Capacitor layers and the Android
-the formats drift — `favicon.svg` is a rounded bordered tile, `icon-maskable-512.png` a full-bleed
+adaptive res (no inset, + monochrome), plus VK/TG/store art. Specced in `docs/ICON_BRANDBOOK.md`,
-square, visibly different — and the Android launcher icon is only a temporary upscale of the maskable
+mapped in `docs/ICONS.md`, generated from `assets/icons/brand/`. `~/.claude/bin/gitea-ci-watch.py` is present.
 (`capacitor-assets` insets it 16.7% into the adaptive safe zone). `~/.claude/bin/gitea-ci-watch.py` is present.
 RuStore publication prerequisites gate release only.
 ---
@@ -334,8 +404,8 @@ is: scaffold → native-correct → gate → offline-first → CI → docs → r
  ```
  Call once from bootstrap. `atNavigationRoot` = current route is `lobby`/`login`
  (mirror `routeDepth(...) === 0` from `App.svelte:50-54`, reading `router.svelte.ts`).
- **Launcher icon (owner asset):** owner supplies a 1024×1024 «Э» icon at `ui/assets/icon.png`
+- **Launcher icon:** DONE — generated from the brand master into the Capacitor layers
-  (+ optional `splash.png`); `pnpm android:assets` generates adaptive icons.
+  `ui/assets/{icon,icon-foreground,icon-background}.png` and the Android res; see `docs/ICONS.md`.
 **Done when:** `npx cap sync android` succeeds against a real `pnpm build`, and (from `ui/android/`)
 `./gradlew assembleDebug` produces a debug APK that installs and cold-launches to the login screen.
@@ -695,6 +765,14 @@ Wire in `ui/android/app/build.gradle` `defaultConfig`:
 ### G. Release + owner handoff
 > **Status 2026-07-13 — see the ▶ RESUME block at the top of §Progress.** Since this chain was
 > written, a **legal-documents track** was added and merged (PR #253 — the RuStore hosted
 > privacy-policy URL and the `/privacy/ /eula/ /offer/` pages), and a **release-prep hygiene** patch is
 > in flight (PR #254, open), and the **icon rebrand is DONE** (brand master → full set; see the RESUME
 > block). The remaining gates are the **keystore** and the **RuStore account** (owner-side). The steps
 > below are the original release chain; the resume
 > block supersedes them with the current, exhaustive state.
 0. **Land the offline-model redesign — ✅ DONE (O1–O7, 2026-07-13; staged detail below).** Resolved the deferred
   native local-game-visibility decision — a native guest now sees / resumes their device-local games once online
   (the **unified lobby**, O5) — as part of the owner-approved change: the explicit offline toggle is gone, offline
@@ -1,41 +1,18 @@
-# Erudit — site icons + Open Graph card
+# Icons
-The favicon set and the `og:image` link-preview card for the public landing
+The whole shipped icon set is sliced from **one master** — see
-(`ui/landing.html`) and the SPA shell (`ui/index.html`). Same design language as the
+[`brand/`](brand/) for the reference generator, the pinned font and the committed
-[VK loading-screen logo](../vk/README.md): the wooden Erudit «Э» tile (score `8`),
+outputs, and [`../../docs/ICON_BRANDBOOK.md`](../../docs/ICON_BRANDBOOK.md) for how the
-with the wordmark on the app's dark board green (`ui/src/app.css` tokens).
+mark is constructed. The per-platform target map (which file goes where) is in
-
+[`../../docs/ICONS.md`](../../docs/ICONS.md).
 | Output (committed to `ui/public/`) | Purpose |
 |------|---------|
 | `favicon.svg` | Vector favicon, transparent; tile + «Э» only (the score is illegible below ~32 px). |
 | `favicon.ico` | 32×32 PNG-in-ICO fallback (also answers the browsers' blind `/favicon.ico` probe). |
 | `apple-touch-icon.png` | 180×180 opaque full-bleed tile; iOS masks its own corners. |
 | `og-image.png` | 1200×630 card: tile + «Эрудит / Скрэббл — игра в слова». Referenced absolutely as `https://erudit-game.ru/og-image.png`. |
 ## How it works
 `build/extract.js` extracts the needed glyph outlines (tile glyphs + every wordmark
 character) from LiberationSans (Arial-metric, the game's font stack) with their
 advance widths into `build/glyphs.json` (committed). `build/generate.js` composes
 plain SVG from those outlines — no font is needed at generation time — writes
 `favicon.svg` and rasterises the PNG/ICO outputs by screenshotting the SVGs with the
 `ui` package's Playwright chromium (`@playwright/test`); the `.ico` container is
 assembled in-script (a single PNG entry). Raster bytes therefore depend on the
 installed chromium version; the SVG sources are deterministic.
 ## Regenerate
 Requirements: Node ≥ 18, `ui` installed (`pnpm install`, provides Playwright).
 `extract.js` additionally needs `opentype.js` (`npm i opentype.js`); **`generate.js`
 needs no extra packages**.
 ```sh
-cd assets/icons
+cd brand
-
+npm i opentype.js
-# 1. (optional) re-extract the glyphs — only if the font or the wordmark changes:
+node build-set.mjs          # web (ui/public) + Capacitor layers (ui/assets) + vk/ tg/ store/
-#    default font: /usr/share/fonts/truetype/liberation/LiberationSans-Regular.ttf
+node build-android-res.mjs  # Android launcher resources (all densities + monochrome)
 node build/extract.js [/path/to/font.ttf]      # -> build/glyphs.json
 # 2. regenerate everything in ui/public/:
 node build/generate.js
 ```
 > The earlier `build/` pipeline (LiberationSans glyph outlines → favicon/apple-touch/OG)
 > was replaced by `brand/` when the icon was rebranded onto the Spectral «Э» master.
 > The separate VK loading-screen animation lives in [`../vk/`](../vk/) and is unrelated.
@@ -0,0 +1,2 @@
 node_modules/
 package-lock.json
@@ -0,0 +1,32 @@
 # Erudit icon — brand master
 The reference construction of the Erudit app icon. The authoritative, human-readable
 spec lives in [`docs/ICON_BRANDBOOK.md`](../../../docs/ICON_BRANDBOOK.md); this folder
 holds the machine reproduction of exactly what that document describes.
 | File | What |
 |------|------|
 | `build-icon.mjs` | reference generator — every dimension is a fraction of the side, matching the brand book |
 | `render-png.mjs` | rasterises an icon SVG to PNG via the `ui` package's Playwright chromium |
 | `Spectral-Bold.ttf` | the «Э» typeface (SIL OFL, `Spectral-OFL.txt`) — pinned so the letter never drifts |
 | `icon-light.svg` / `.png` | the light master (1024) |
 | `icon-dark.svg` / `.png` | the dark master (1024) |
 | `icon-construction.svg` / `.png` | the percent-annotated construction scheme (figure in the brand book) |
 ## Regenerate
 ```sh
 cd assets/icons/brand
 npm i opentype.js                       # the only extra dep; render uses ui's chromium
 node build-icon.mjs --variant light  > icon-light.svg
 node build-icon.mjs --variant dark   > icon-dark.svg
 node build-icon.mjs --variant light --scheme > icon-construction.svg
 node render-png.mjs icon-light.svg  icon-light.png  1024
 node render-png.mjs icon-dark.svg   icon-dark.png   1024
 node render-png.mjs icon-construction.svg icon-construction.png 2048
 ```
 The SVGs are resolution-free; render at any size. Downstream slicing (favicon / PWA /
 iOS / Android) is a separate step — see [`docs/ICONS.md`](../../../docs/ICONS.md).
@@ -0,0 +1,93 @@
 Copyright 2017 The Spectral Project Authors (https://github.com/productiontype/Spectral)
 This Font Software is licensed under the SIL Open Font License, Version 1.1.
 This license is copied below, and is also available with a FAQ at:
 https://openfontlicense.org
 -----------------------------------------------------------
 SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
 -----------------------------------------------------------
 PREAMBLE
 The goals of the Open Font License (OFL) are to stimulate worldwide
 development of collaborative font projects, to support the font creation
 efforts of academic and linguistic communities, and to provide a free and
 open framework in which fonts may be shared and improved in partnership
 with others.
 The OFL allows the licensed fonts to be used, studied, modified and
 redistributed freely as long as they are not sold by themselves. The
 fonts, including any derivative works, can be bundled, embedded, 
 redistributed and/or sold with any software provided that any reserved
 names are not used by derivative works. The fonts and derivatives,
 however, cannot be released under any other type of license. The
 requirement for fonts to remain under this license does not apply
 to any document created using the fonts or their derivatives.
 DEFINITIONS
 "Font Software" refers to the set of files released by the Copyright
 Holder(s) under this license and clearly marked as such. This may
 include source files, build scripts and documentation.
 "Reserved Font Name" refers to any names specified as such after the
 copyright statement(s).
 "Original Version" refers to the collection of Font Software components as
 distributed by the Copyright Holder(s).
 "Modified Version" refers to any derivative made by adding to, deleting,
 or substituting -- in part or in whole -- any of the components of the
 Original Version, by changing formats or by porting the Font Software to a
 new environment.
 "Author" refers to any designer, engineer, programmer, technical
 writer or other person who contributed to the Font Software.
 PERMISSION & CONDITIONS
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of the Font Software, to use, study, copy, merge, embed, modify,
 redistribute, and sell modified and unmodified copies of the Font
 Software, subject to the following conditions:
 1) Neither the Font Software nor any of its individual components,
 in Original or Modified Versions, may be sold by itself.
 2) Original or Modified Versions of the Font Software may be bundled,
 redistributed and/or sold with any software, provided that each copy
 contains the above copyright notice and this license. These can be
 included either as stand-alone text files, human-readable headers or
 in the appropriate machine-readable metadata fields within text or
 binary files as long as those fields can be easily viewed by the user.
 3) No Modified Version of the Font Software may use the Reserved Font
 Name(s) unless explicit written permission is granted by the corresponding
 Copyright Holder. This restriction only applies to the primary font name as
 presented to the users.
 4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
 Software shall not be used to promote, endorse or advertise any
 Modified Version, except to acknowledge the contribution(s) of the
 Copyright Holder(s) and the Author(s) or with their explicit written
 permission.
 5) The Font Software, modified or unmodified, in part or in whole,
 must be distributed entirely under this license, and must not be
 distributed under any other license. The requirement for fonts to
 remain under this license does not apply to any document created
 using the Font Software.
 TERMINATION
 This license becomes null and void if any of the above conditions are
 not met.
 DISCLAIMER
 THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
 EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
 MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
 OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
 COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
 INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
 DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
 FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
 OTHER DEALINGS IN THE FONT SOFTWARE.
@@ -0,0 +1,47 @@
 'use strict';
 // Generate the Android launcher resources from the committed layers, at every
 // density, with NO inset (our layers already fill the 108 dp canvas) and a
 // monochrome (themed) layer. Run build-set.mjs first (it writes the layer PNGs).
 //
 //   npm i opentype.js  # (only build-icon/build-set need it; this reads PNGs)
 //   node build-set.mjs && node build-android-res.mjs
 //
 // Writes ui/android/app/src/main/res/mipmap-*/ic_launcher{,_round,_foreground,
 // _background,_monochrome}.png. The two mipmap-anydpi-v26/*.xml are committed by hand.
 import { readFileSync, writeFileSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
 import { dirname, join } from 'node:path';
 const DIR = dirname(fileURLToPath(import.meta.url));
 const ROOT = join(DIR, '..', '..', '..');
 const RES = join(ROOT, 'ui', 'android', 'app', 'src', 'main', 'res');
 const uri = p => 'data:image/png;base64,' + readFileSync(p).toString('base64');
 const BG = uri(join(ROOT, 'ui', 'assets', 'icon-background.png'));
 const FG = uri(join(ROOT, 'ui', 'assets', 'icon-foreground.png'));
 const MONO = uri(join(DIR, 'android-monochrome.png'));
 // density: [adaptive-layer px (108 dp), legacy launcher px (48 dp)]
 const D = { ldpi: [81, 36], mdpi: [108, 48], hdpi: [162, 72], xhdpi: [216, 96], xxhdpi: [324, 144], xxxhdpi: [432, 192] };
 const pw = await import(join(ROOT, 'ui', 'node_modules', '@playwright', 'test', 'index.js'));
 const { chromium } = pw.default ?? pw;
 const browser = await chromium.launch();
 const page = await browser.newPage({ deviceScaleFactor: 1 });
 const im = (u, s) => `<img src="${u}" width="${s}" height="${s}" style="display:block">`;
 async function shot(html, s, transparent) {
  await page.setViewportSize({ width: s, height: s });
  await page.setContent(`<!doctype html><meta charset=utf8><style>*{margin:0;padding:0}#r{width:${s}px;height:${s}px}</style><div id=r>${html}</div>`, { waitUntil: 'networkidle' });
  return page.locator('#r').screenshot({ omitBackground: !!transparent });
 }
 for (const [d, [fg, lg]] of Object.entries(D)) {
  const dir = join(RES, `mipmap-${d}`);
  writeFileSync(join(dir, 'ic_launcher_background.png'), await shot(im(BG, fg), fg, false));
  writeFileSync(join(dir, 'ic_launcher_foreground.png'), await shot(im(FG, fg), fg, true));
  writeFileSync(join(dir, 'ic_launcher_monochrome.png'), await shot(im(MONO, fg), fg, true));
  const comp = `<div style="position:relative;width:${lg}px;height:${lg}px">${im(BG, lg)}<div style="position:absolute;inset:0">${im(FG, lg)}</div></div>`;
  writeFileSync(join(dir, 'ic_launcher.png'), await shot(comp, lg, false));
  const round = `<div style="width:${lg}px;height:${lg}px;border-radius:50%;overflow:hidden;position:relative">${im(BG, lg)}<div style="position:absolute;inset:0">${im(FG, lg)}</div></div>`;
  writeFileSync(join(dir, 'ic_launcher_round.png'), await shot(round, lg, true));
  console.log('mipmap-' + d, 'ok');
 }
 await browser.close();
@@ -0,0 +1,159 @@
 'use strict';
 // Erudit app-icon — the reference generator. Every dimension below is a FRACTION
 // of the icon side, so this file reads the same as docs/ICON_BRANDBOOK.md and the
 // icon reproduces at any resolution. Emits one variant/layer's SVG to stdout.
 //
 //   node build-icon.mjs --variant light|dark [--layer full|background|foreground] [--scheme] > icon.svg
 //
 // Layers (for Android adaptive icons):
 //   full        the standalone master (rounded tile + mark) — iOS / PWA / favicon
 //   background  wood + grain + light/shadow, full-bleed square (the OS applies the mask)
 //   foreground  only «Э» + ✻, transparent, re-placed for the round mask (see FG_* below)
 //
 // Deps: opentype.js (npm i opentype.js). Font: ./Spectral-Bold.ttf (OFL, bundled).
 import { readFileSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
 import { dirname, join } from 'node:path';
 import opentype from 'opentype.js';
 const DIR = dirname(fileURLToPath(import.meta.url));
 const args = process.argv.slice(2);
 const has = f => args.includes('--' + f);
 const val = (f, d) => { const i = args.indexOf('--' + f); return i >= 0 ? args[i + 1] : d; };
 // ---- the design, in fractions of the side ----
 const S = 1024;                       // reference side (the icon is resolution-free)
 const RADIUS   = 0.17;                // tile corner radius (full master)
 const STAR_BULB = 0.22;               // spoke-end (and hub) radius, as fraction of star radius
 const STAR_SPOKES = 6;
 const GRAIN_COLS = 6, GRAIN_W = 1 / 32, GRAIN_SHIFT = 1 / 16, GRAIN_TILT = 4;
 const SHEEN = 0.15;                   // white, transparent bottom-left -> this alpha top-right
 const SHADE = 0.15;                   // black, this alpha bottom-left -> transparent top-right
 // The mark, placed for the standalone master (bottom-right biased, full-bleed):
 const MASTER = { lh: 0.6055, lc: [0.4814, 0.4922], sd: 0.1729, sc: [0.7881, 0.7881] };
 // The mark, placed for the Android foreground layer (centred-ish inside the 61% safe
 // zone, nudged right 8% / down 3% for optical balance under the round mask; smaller ✻):
 const FOREGROUND = { lh: 0.5391, lc: [0.5234, 0.4951], sd: 0.1318, sc: [0.7627, 0.7266] };
 const PALETTE = {
  light: { wood: '#e6b053', ink: '#5a3a12', grain: '#d8a54e' },
  dark:  { wood: '#4a3316', ink: '#f2d9a0', grain: '#432e14' },
 };
 // Layers:
 //   full        rounded tile + master mark        (favicon.svg — browser rounds nothing)
 //   flat        square tile + master mark          (apple-touch, PWA "any" — OS rounds)
 //   background  square tile, no mark               (Android adaptive background)
 //   foreground  mark only, transparent             (Android adaptive foreground)
 //   maskable    square tile + foreground mark       (PWA maskable — safe-zone aware)
 //   monochrome  foreground mark only, flat colour  (Android 13+ themed layer)
 const LAYERS = ['full', 'flat', 'background', 'foreground', 'maskable', 'monochrome'];
 const variant = val('variant', 'light');
 const layer = val('layer', 'full');
 const P = PALETTE[variant];
 if (!P) { console.error(`unknown --variant ${variant} (light|dark)`); process.exit(1); }
 if (!LAYERS.includes(layer)) { console.error(`unknown --layer ${layer} (${LAYERS.join('|')})`); process.exit(1); }
 const usesForegroundPlacement = ['foreground', 'maskable', 'monochrome'].includes(layer);
 const drawBg = ['full', 'flat', 'background', 'maskable'].includes(layer);
 const drawMark = layer !== 'background';
 const MARK = usesForegroundPlacement ? FOREGROUND : MASTER;
 const inkColour = layer === 'monochrome' ? val('mono', '#ffffff') : P.ink;
 const RX = layer === 'full' ? RADIUS * S : 0;   // only the standalone master keeps rounded corners
 const font = opentype.parse(readFileSync(join(DIR, 'Spectral-Bold.ttf')).buffer);
 // «Э» outline scaled so its ink bounding box is MARK.lh of the side, box centred on MARK.lc.
 function letterSvg() {
  const g = font.charToGlyph('Э');
  const h0 = (() => { const b = g.getPath(0, 0, 1000).getBoundingBox(); return b.y2 - b.y1; })();
  const scale = (MARK.lh * S) / h0;
  const p = g.getPath(0, 0, 1000 * scale);
  const bb = p.getBoundingBox();
  const w = bb.x2 - bb.x1, h = bb.y2 - bb.y1;
  const tx = MARK.lc[0] * S - (bb.x1 + w / 2);
  const ty = MARK.lc[1] * S - (bb.y1 + h / 2);
  return { svg: `<path transform="translate(${tx.toFixed(2)} ${ty.toFixed(2)})" d="${p.toPathData(2)}" fill="${inkColour}"/>`,
           box: { x: bb.x1 + tx, y: bb.y1 + ty, w, h } };
 }
 // Teardrop-spoked asterisk ✻: each spoke tapers to a point at the centre and ends
 // in a round bulb; a central disc equal to the bulb fuses them.
 function starPath() {
  const cx = MARK.sc[0] * S, cy = MARK.sc[1] * S, Rout = MARK.sd * S / 2;
  const rb = Rout * STAR_BULB, R = Rout - rb;
  const L = Math.sqrt(R * R - rb * rb), theta = Math.asin(rb / R);
  const rot = (v, t) => [v[0] * Math.cos(t) - v[1] * Math.sin(t), v[0] * Math.sin(t) + v[1] * Math.cos(t)];
  let d = '';
  for (let k = 0; k < STAR_SPOKES; k++) {
    const a = -Math.PI / 2 + k * 2 * Math.PI / STAR_SPOKES;
    const u = [Math.cos(a), Math.sin(a)];
    const d1 = rot(u, theta), d2 = rot(u, -theta);
    const T1 = [cx + L * d1[0], cy + L * d1[1]], T2 = [cx + L * d2[0], cy + L * d2[1]];
    d += `M${cx.toFixed(2)} ${cy.toFixed(2)} L${T1[0].toFixed(2)} ${T1[1].toFixed(2)} A${rb.toFixed(2)} ${rb.toFixed(2)} 0 1 0 ${T2[0].toFixed(2)} ${T2[1].toFixed(2)} Z `;
  }
  d += `M${cx} ${cy} m${-rb} 0 a${rb} ${rb} 0 1 0 ${2 * rb} 0 a${rb} ${rb} 0 1 0 ${-2 * rb} 0 Z`;
  return `<path d="${d}" fill="${inkColour}"/>`;
 }
 function grain() {
  const colW = S / GRAIN_COLS, sw = GRAIN_W * S, shift = GRAIN_SHIFT * S;
  const yTop = -0.2 * S, yBot = 1.2 * S, cy = S / 2;
  let s = '';
  for (let i = 1; i <= GRAIN_COLS; i++) {
    const xr = i * colW - shift, x = xr - sw, cx = xr - sw / 2;
    s += `<rect x="${x.toFixed(2)}" y="${yTop.toFixed(2)}" width="${sw.toFixed(2)}" height="${(yBot - yTop).toFixed(2)}" fill="${P.grain}" transform="rotate(${GRAIN_TILT} ${cx.toFixed(2)} ${cy.toFixed(2)})"/>`;
  }
  return `<g clip-path="url(#tile)">${s}</g>`;
 }
 let body = '';
 const L = letterSvg();
 if (drawBg) {                           // tile + grain + light/shadow (the background)
  body += `<rect width="${S}" height="${S}" rx="${RX}" fill="${P.wood}"/>`
    + `<defs><clipPath id="tile"><rect width="${S}" height="${S}" rx="${RX}"/></clipPath>`
    +   `<linearGradient id="sheen" gradientUnits="userSpaceOnUse" x1="0" y1="${S}" x2="${S}" y2="0"><stop offset="0" stop-color="#fff" stop-opacity="0"/><stop offset="1" stop-color="#fff" stop-opacity="${SHEEN}"/></linearGradient>`
    +   `<linearGradient id="shade" gradientUnits="userSpaceOnUse" x1="0" y1="${S}" x2="${S}" y2="0"><stop offset="0" stop-color="#000" stop-opacity="${SHADE}"/><stop offset="1" stop-color="#000" stop-opacity="0"/></linearGradient>`
    + `</defs>`
    + grain()
    + `<rect width="${S}" height="${S}" fill="url(#sheen)" clip-path="url(#tile)"/>`
    + `<rect width="${S}" height="${S}" fill="url(#shade)" clip-path="url(#tile)"/>`;
 }
 if (drawMark) body += L.svg + starPath();   // the mark
 if (has('scheme')) body += scheme(L);
 process.stdout.write(`<svg xmlns="http://www.w3.org/2000/svg" width="${S}" height="${S}" viewBox="0 0 ${S} ${S}">${body}</svg>\n`);
 // Percent-based construction overlay for the brand book (full master only).
 function scheme(L) {
  const pc = n => (100 * n / S).toFixed(1) + '%';
  const GC = '#0f172a', BX = '#d81b60', AC = '#0d9488';
  const halo = 'paint-order="stroke" stroke="#fff" stroke-width="4"';
  const cx = MARK.sc[0] * S, cy = MARK.sc[1] * S, sd = MARK.sd * S;
  let g = `<g font-family="'Helvetica Neue',Arial,sans-serif">`;
  for (let f = 1; f <= 3; f++) {
    const p = f * S / 4;
    g += `<line x1="${p}" y1="0" x2="${p}" y2="${S}" stroke="${GC}" stroke-opacity="0.18" stroke-width="1.2"/>`;
    g += `<line x1="0" y1="${p}" x2="${S}" y2="${p}" stroke="${GC}" stroke-opacity="0.18" stroke-width="1.2"/>`;
    g += `<text x="${p + 4}" y="20" font-size="17" font-weight="700" fill="${GC}" ${halo}>${f * 25}%</text>`;
    g += `<text x="4" y="${p - 4}" font-size="17" font-weight="700" fill="${GC}" ${halo}>${f * 25}%</text>`;
  }
  g += `<line x1="${0.14 * S}" y1="${0.86 * S}" x2="${0.86 * S}" y2="${0.14 * S}" stroke="${AC}" stroke-width="3" stroke-dasharray="3 8" stroke-linecap="round"/>`;
  g += `<circle cx="${0.86 * S}" cy="${0.14 * S}" r="6" fill="${AC}"/><circle cx="${0.14 * S}" cy="${0.86 * S}" r="6" fill="${AC}"/>`;
  g += `<text x="${0.86 * S - 6}" y="${0.14 * S - 12}" text-anchor="end" font-size="18" font-weight="700" fill="${AC}" ${halo}>light: white 0%→15%</text>`;
  g += `<text x="${0.14 * S + 10}" y="${0.86 * S + 26}" font-size="18" font-weight="700" fill="${AC}" ${halo}>shadow: black 15%→0%</text>`;
  const { x, y, w, h } = L.box;
  g += `<rect x="${x.toFixed(1)}" y="${y.toFixed(1)}" width="${w.toFixed(1)}" height="${h.toFixed(1)}" fill="none" stroke="${BX}" stroke-width="2.5"/>`;
  g += `<line x1="${MARK.lc[0] * S}" y1="${MARK.lc[1] * S - 16}" x2="${MARK.lc[0] * S}" y2="${MARK.lc[1] * S + 16}" stroke="${BX}" stroke-width="2.5"/><line x1="${MARK.lc[0] * S - 16}" y1="${MARK.lc[1] * S}" x2="${MARK.lc[0] * S + 16}" y2="${MARK.lc[1] * S}" stroke="${BX}" stroke-width="2.5"/>`;
  g += `<text x="${x.toFixed(1)}" y="${(y - 10).toFixed(1)}" font-size="19" font-weight="700" fill="${BX}" ${halo}>«Э» Spectral Bold · box H ${pc(h)} · W ${pc(w)}</text>`;
  g += `<text x="${x.toFixed(1)}" y="${(y + h + 24).toFixed(1)}" font-size="18" font-weight="700" fill="${BX}" ${halo}>box center ${pc(MARK.lc[0] * S)} / ${pc(MARK.lc[1] * S)}</text>`;
  g += `<rect x="${cx - sd / 2}" y="${cy - sd / 2}" width="${sd}" height="${sd}" fill="none" stroke="${BX}" stroke-width="2.5"/>`;
  g += `<line x1="${cx}" y1="${cy - 14}" x2="${cx}" y2="${cy + 14}" stroke="${BX}" stroke-width="2.5"/><line x1="${cx - 14}" y1="${cy}" x2="${cx + 14}" y2="${cy}" stroke="${BX}" stroke-width="2.5"/>`;
  g += `<text x="${(cx + sd / 2).toFixed(1)}" y="${(cy - sd / 2 - 10).toFixed(1)}" text-anchor="end" font-size="18" font-weight="700" fill="${BX}" ${halo}>✻ Ø ${pc(sd)} · center ${pc(cx)} / ${pc(cy)}</text>`;
  g += `<text x="${RX + 14}" y="${RX - 6}" font-size="17" font-weight="700" fill="${GC}" ${halo}>corner r = 17%</text>`;
  g += `<path d="M4 ${RX} A ${RX} ${RX} 0 0 1 ${RX} 4" fill="none" stroke="${GC}" stroke-width="2" stroke-dasharray="5 5"/>`;
  g += `<rect x="${0.03 * S}" y="${S - 96}" width="${0.94 * S}" height="74" rx="12" fill="#0f172a" fill-opacity="0.82"/>`;
  g += `<text x="${0.055 * S}" y="${S - 64}" font-size="18" font-weight="600" fill="#fff">Wood grain: 6 equal columns; a vertical stripe on each column's right edge,</text>`;
  g += `<text x="${0.055 * S}" y="${S - 40}" font-size="18" font-weight="600" fill="#fff">width 1/32 of side; the whole set shifted left 1/16; every stripe tilted 4°.</text>`;
  return g + `</g>`;
 }
@@ -0,0 +1,105 @@
 'use strict';
 // Slice the whole shipped icon set from the brand master (build-icon.mjs). Renders
 // with the ui package's Playwright chromium. See docs/ICONS.md for the target map.
 //
 //   npm i opentype.js && node build-set.mjs
 //
 // Writes: ui/public/* (web), ui/assets/* (Capacitor layers), ./vk/* and ./store/*
 // (manual-upload art). Wiring (manifest, html, Android res) is done separately.
 import { execFileSync } from 'node:child_process';
 import { readFileSync, writeFileSync, mkdirSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
 import { dirname, join } from 'node:path';
 const DIR = dirname(fileURLToPath(import.meta.url));
 const UI = join(DIR, '..', '..', '..', 'ui');
 const PUB = join(UI, 'public'), ASSETS = join(UI, 'assets');
 const VK = join(DIR, 'vk'), STORE = join(DIR, 'store'), TG = join(DIR, 'tg');
 [VK, STORE, TG].forEach(d => mkdirSync(d, { recursive: true }));
 // one SVG string for a variant+layer from the reference generator
 const svgFor = (variant, layer) =>
  execFileSync('node', [join(DIR, 'build-icon.mjs'), '--variant', variant, '--layer', layer], { encoding: 'utf8' });
 const pw = await import(join(UI, 'node_modules', '@playwright', 'test', 'index.js'));
 const { chromium } = pw.default ?? pw;
 const browser = await chromium.launch();
 const page = await browser.newPage();
 async function pngFromSvg(svg, size, transparent) {
  await page.setViewportSize({ width: size, height: size });
  await page.setContent(`<!doctype html><meta charset=utf8><style>*{margin:0;padding:0}svg{display:block;width:${size}px;height:${size}px}</style>${svg}`, { waitUntil: 'networkidle' });
  return page.locator('svg').screenshot({ omitBackground: !!transparent });
 }
 async function shootHtml(html, w, h) {
  await page.setViewportSize({ width: w, height: h });
  await page.setContent(html, { waitUntil: 'networkidle' });
  return page.screenshot();
 }
 function icoFromPNG(png, sizePx) {
  const h = Buffer.alloc(22);
  h.writeUInt16LE(0, 0); h.writeUInt16LE(1, 2); h.writeUInt16LE(1, 4);
  h.writeUInt8(sizePx, 6); h.writeUInt8(sizePx, 7);
  h.writeUInt16LE(1, 10); h.writeUInt16LE(32, 12);
  h.writeUInt32LE(png.length, 14); h.writeUInt32LE(22, 18);
  return Buffer.concat([h, png]);
 }
 const write = (p, buf) => { writeFileSync(p, buf); console.log('wrote', p.replace(join(DIR, '..', '..', '..'), '.'), buf.length, 'b'); };
 // ---- pre-render the SVG sources we need ----
 const S = {
  fullLight: svgFor('light', 'full'), fullDark: svgFor('dark', 'full'),
  flatLight: svgFor('light', 'flat'), flatDark: svgFor('dark', 'flat'),
  maskLight: svgFor('light', 'maskable'), maskDark: svgFor('dark', 'maskable'),
  bgLight: svgFor('light', 'background'), fgLight: svgFor('light', 'foreground'),
  monoLight: svgFor('light', 'monochrome'),
 };
 // ---- favicon.svg: light + dark in one file, toggled by prefers-color-scheme ----
 const inner = svg => svg.replace(/^<svg[^>]*>/, '').replace(/<\/svg>\s*$/, '');
 const faviconSvg =
  `<svg xmlns="http://www.w3.org/2000/svg" width="1024" height="1024" viewBox="0 0 1024 1024">`
  + `<style>.d{display:none}@media(prefers-color-scheme:dark){.l{display:none}.d{display:inline}}</style>`
  + `<g class="l">${inner(S.fullLight)}</g><g class="d">${inner(S.fullDark)}</g></svg>\n`;
 write(join(PUB, 'favicon.svg'), Buffer.from(faviconSvg));
 // ---- web rasters ----
 write(join(PUB, 'favicon.ico'), icoFromPNG(await pngFromSvg(S.flatLight, 32, false), 32));
 write(join(PUB, 'apple-touch-icon.png'), await pngFromSvg(S.flatLight, 180, false));
 write(join(PUB, 'icon-192.png'), await pngFromSvg(S.flatLight, 192, false));
 write(join(PUB, 'icon-512.png'), await pngFromSvg(S.flatLight, 512, false));
 write(join(PUB, 'icon-192-dark.png'), await pngFromSvg(S.flatDark, 192, false));
 write(join(PUB, 'icon-512-dark.png'), await pngFromSvg(S.flatDark, 512, false));
 write(join(PUB, 'icon-maskable-512.png'), await pngFromSvg(S.maskLight, 512, false));
 write(join(PUB, 'icon-maskable-512-dark.png'), await pngFromSvg(S.maskDark, 512, false));
 // ---- Capacitor layers (ui/assets) ----
 write(join(ASSETS, 'icon.png'), await pngFromSvg(S.flatLight, 1024, false));          // legacy single
 write(join(ASSETS, 'icon-foreground.png'), await pngFromSvg(S.fgLight, 1024, true));   // adaptive fg
 write(join(ASSETS, 'icon-background.png'), await pngFromSvg(S.bgLight, 1024, false));  // adaptive bg
 write(join(DIR, 'android-monochrome.png'), await pngFromSvg(S.monoLight, 1024, true)); // themed layer (wired manually)
 // ---- VK (no rounding — flat light) ----
 for (const px of [576, 278, 150, 32]) write(join(VK, `vk-${px}.png`), await pngFromSvg(S.flatLight, px, false));
 // ---- Telegram bot: square, no rounding (TG crops the avatar to a circle) ----
 write(join(TG, 'tg-512.png'), await pngFromSvg(S.flatLight, 512, false));   // bot avatar + Mini App icon
 // ---- store art ----
 write(join(STORE, 'rustore-512.png'), await pngFromSvg(S.flatLight, 512, false));
 // ---- wordmark banner (board-green bg + master tile + «Эрудит» / Игра в слова) ----
 const b64 = readFileSync(join(DIR, 'Spectral-Bold.ttf')).toString('base64');
 const banner = (w, h, tile, t1, t2, gap, pad) => `<!doctype html><meta charset=utf8><style>
@font-face{font-family:Spectral;src:url(data:font/ttf;base64,${b64});font-weight:700}
 *{margin:0;padding:0;box-sizing:border-box}
 body{width:${w}px;height:${h}px;background:#2a3330;display:flex;align-items:center;gap:${gap}px;padding:0 ${pad}px;font-family:Spectral}
 .tile{width:${tile}px;height:${tile}px;flex:none}.tile svg{width:${tile}px;height:${tile}px;display:block}
 .wm{color:#e7ece8;text-align:center}.t1{font-weight:700;font-size:${t1}px;line-height:1.02;letter-spacing:-2px}
 .t2{font-weight:700;font-size:${t2}px;line-height:1.1;color:#cdd6cf;margin-top:6px}
 </style><div class=tile>${S.fullLight}</div><div class=wm><div class=t1>«Эрудит»</div><div class=t2>Игра в слова</div></div>`;
 write(join(PUB, 'og-image.png'), await shootHtml(banner(1200, 630, 300, 150, 74, 64, 96), 1200, 630));
 write(join(TG, 'tg-demo-640x360.png'), await shootHtml(banner(640, 360, 150, 72, 38, 30, 44), 640, 360));
 await browser.close();
 console.log('done');
@@ -0,0 +1 @@
 <svg xmlns="http://www.w3.org/2000/svg" width="1024" height="1024" viewBox="0 0 1024 1024"><rect width="1024" height="1024" rx="0" fill="#4a3316"/><defs><clipPath id="tile"><rect width="1024" height="1024" rx="0"/></clipPath><linearGradient id="sheen" gradientUnits="userSpaceOnUse" x1="0" y1="1024" x2="1024" y2="0"><stop offset="0" stop-color="#fff" stop-opacity="0"/><stop offset="1" stop-color="#fff" stop-opacity="0.15"/></linearGradient><linearGradient id="shade" gradientUnits="userSpaceOnUse" x1="0" y1="1024" x2="1024" y2="0"><stop offset="0" stop-color="#000" stop-opacity="0.15"/><stop offset="1" stop-color="#000" stop-opacity="0"/></linearGradient></defs><g clip-path="url(#tile)"><rect x="74.67" y="-204.80" width="32.00" height="1433.60" fill="#432e14" transform="rotate(4 90.67 512.00)"/><rect x="245.33" y="-204.80" width="32.00" height="1433.60" fill="#432e14" transform="rotate(4 261.33 512.00)"/><rect x="416.00" y="-204.80" width="32.00" height="1433.60" fill="#432e14" transform="rotate(4 432.00 512.00)"/><rect x="586.67" y="-204.80" width="32.00" height="1433.60" fill="#432e14" transform="rotate(4 602.67 512.00)"/><rect x="757.33" y="-204.80" width="32.00" height="1433.60" fill="#432e14" transform="rotate(4 773.33 512.00)"/><rect x="928.00" y="-204.80" width="32.00" height="1433.60" fill="#432e14" transform="rotate(4 944.00 512.00)"/></g><rect width="1024" height="1024" fill="url(#sheen)" clip-path="url(#tile)"/><rect width="1024" height="1024" fill="url(#shade)" clip-path="url(#tile)"/></svg>
@@ -0,0 +1 @@
 <svg xmlns="http://www.w3.org/2000/svg" width="1024" height="1024" viewBox="0 0 1024 1024"><path transform="translate(237.62 774.88)" d="M250.04-34.91Q326.35-34.91 368.57-91.33Q410.78-147.75 410.78-243.55Q410.78-249.23 410.78-254.91L254.10-254.91L208.64-185.91L195.65-185.91L195.65-368.57L208.64-368.57L254.10-299.56L407.53-299.56Q396.98-392.92 351.52-447.72Q306.06-502.52 241.11-502.52Q217.57-502.52 198.90-498.46Q180.22-494.40 162.36-482.22L83.62-354.77L69-354.77L77.93-505.76Q112.84-522.81 154.25-533.37Q195.65-543.92 259.78-543.92Q319.86-543.92 371.41-523.22Q422.96-502.52 460.71-465.58Q498.46-428.64 519.57-378.31Q540.67-327.98 540.67-267.90Q540.67-188.34 504.55-125.83Q468.42-63.32 405.10-27.60Q341.78 8.12 259.78 8.12Q200.52 8.12 150.59-3.25Q100.67-14.61 67.38-34.10L56.02-171.29L69.82-171.29L142.88-63.32Q165.61-50.33 191.59-42.62Q217.57-34.91 250.04-34.91" fill="#f2d9a0"/><path d="M781.00 744.04 L795.25 695.59 A14.85 14.85 0 1 0 766.76 695.59 Z M781.00 744.04 L830.08 732.15 A14.85 14.85 0 1 0 815.84 707.48 Z M781.00 744.04 L815.84 780.60 A14.85 14.85 0 1 0 830.08 755.93 Z M781.00 744.04 L766.76 792.49 A14.85 14.85 0 1 0 795.25 792.49 Z M781.00 744.04 L731.93 755.93 A14.85 14.85 0 1 0 746.17 780.60 Z M781.00 744.04 L746.17 707.48 A14.85 14.85 0 1 0 731.93 732.15 Z M781.0048 744.0384 m-14.845952 0 a14.845952 14.845952 0 1 0 29.691904 0 a14.845952 14.845952 0 1 0 -29.691904 0 Z" fill="#f2d9a0"/></svg>
@@ -0,0 +1 @@
 <svg xmlns="http://www.w3.org/2000/svg" width="1024" height="1024" viewBox="0 0 1024 1024"><rect width="1024" height="1024" rx="174.08" fill="#4a3316"/><defs><clipPath id="tile"><rect width="1024" height="1024" rx="174.08"/></clipPath><linearGradient id="sheen" gradientUnits="userSpaceOnUse" x1="0" y1="1024" x2="1024" y2="0"><stop offset="0" stop-color="#fff" stop-opacity="0"/><stop offset="1" stop-color="#fff" stop-opacity="0.15"/></linearGradient><linearGradient id="shade" gradientUnits="userSpaceOnUse" x1="0" y1="1024" x2="1024" y2="0"><stop offset="0" stop-color="#000" stop-opacity="0.15"/><stop offset="1" stop-color="#000" stop-opacity="0"/></linearGradient></defs><g clip-path="url(#tile)"><rect x="74.67" y="-204.80" width="32.00" height="1433.60" fill="#432e14" transform="rotate(4 90.67 512.00)"/><rect x="245.33" y="-204.80" width="32.00" height="1433.60" fill="#432e14" transform="rotate(4 261.33 512.00)"/><rect x="416.00" y="-204.80" width="32.00" height="1433.60" fill="#432e14" transform="rotate(4 432.00 512.00)"/><rect x="586.67" y="-204.80" width="32.00" height="1433.60" fill="#432e14" transform="rotate(4 602.67 512.00)"/><rect x="757.33" y="-204.80" width="32.00" height="1433.60" fill="#432e14" transform="rotate(4 773.33 512.00)"/><rect x="928.00" y="-204.80" width="32.00" height="1433.60" fill="#432e14" transform="rotate(4 944.00 512.00)"/></g><rect width="1024" height="1024" fill="url(#sheen)" clip-path="url(#tile)"/><rect width="1024" height="1024" fill="url(#shade)" clip-path="url(#tile)"/><path transform="translate(157.86 804.91)" d="M280.84-39.21Q366.55-39.21 413.96-102.58Q461.38-165.95 461.38-273.54Q461.38-279.93 461.38-286.31L285.40-286.31L234.34-208.80L219.75-208.80L219.75-413.96L234.34-413.96L285.40-336.46L457.73-336.46Q445.88-441.32 394.81-502.86Q343.75-564.41 270.81-564.41Q244.37-564.41 223.39-559.85Q202.42-555.29 182.36-541.62L93.92-398.46L77.50-398.46L87.53-568.06Q126.74-587.21 173.24-599.06Q219.75-610.91 291.78-610.91Q359.25-610.91 417.15-587.66Q475.05-564.41 517.45-522.92Q559.85-481.44 583.56-424.90Q607.27-368.37 607.27-300.90Q607.27-211.54 566.69-141.33Q526.12-71.12 454.99-31Q383.87 9.12 291.78 9.12Q225.22 9.12 169.14-3.65Q113.06-16.41 75.68-38.30L62.92-192.39L78.42-192.39L160.48-71.12Q186.01-56.53 215.19-47.87Q244.37-39.21 280.84-39.21" fill="#f2d9a0"/><path d="M807.01 807.01 L825.70 743.46 A19.48 19.48 0 1 0 788.33 743.46 Z M807.01 807.01 L871.40 791.42 A19.48 19.48 0 1 0 852.71 759.05 Z M807.01 807.01 L852.71 854.97 A19.48 19.48 0 1 0 871.40 822.61 Z M807.01 807.01 L788.33 870.57 A19.48 19.48 0 1 0 825.70 870.57 Z M807.01 807.01 L742.63 822.61 A19.48 19.48 0 1 0 761.32 854.97 Z M807.01 807.01 L761.32 759.05 A19.48 19.48 0 1 0 742.63 791.42 Z M807.0144 807.0144 m-19.475456 0 a19.475456 19.475456 0 1 0 38.950912 0 a19.475456 19.475456 0 1 0 -38.950912 0 Z" fill="#f2d9a0"/></svg>
@@ -0,0 +1 @@
 <svg xmlns="http://www.w3.org/2000/svg" width="1024" height="1024" viewBox="0 0 1024 1024"><rect width="1024" height="1024" rx="0" fill="#e6b053"/><defs><clipPath id="tile"><rect width="1024" height="1024" rx="0"/></clipPath><linearGradient id="sheen" gradientUnits="userSpaceOnUse" x1="0" y1="1024" x2="1024" y2="0"><stop offset="0" stop-color="#fff" stop-opacity="0"/><stop offset="1" stop-color="#fff" stop-opacity="0.15"/></linearGradient><linearGradient id="shade" gradientUnits="userSpaceOnUse" x1="0" y1="1024" x2="1024" y2="0"><stop offset="0" stop-color="#000" stop-opacity="0.15"/><stop offset="1" stop-color="#000" stop-opacity="0"/></linearGradient></defs><g clip-path="url(#tile)"><rect x="74.67" y="-204.80" width="32.00" height="1433.60" fill="#d8a54e" transform="rotate(4 90.67 512.00)"/><rect x="245.33" y="-204.80" width="32.00" height="1433.60" fill="#d8a54e" transform="rotate(4 261.33 512.00)"/><rect x="416.00" y="-204.80" width="32.00" height="1433.60" fill="#d8a54e" transform="rotate(4 432.00 512.00)"/><rect x="586.67" y="-204.80" width="32.00" height="1433.60" fill="#d8a54e" transform="rotate(4 602.67 512.00)"/><rect x="757.33" y="-204.80" width="32.00" height="1433.60" fill="#d8a54e" transform="rotate(4 773.33 512.00)"/><rect x="928.00" y="-204.80" width="32.00" height="1433.60" fill="#d8a54e" transform="rotate(4 944.00 512.00)"/></g><rect width="1024" height="1024" fill="url(#sheen)" clip-path="url(#tile)"/><rect width="1024" height="1024" fill="url(#shade)" clip-path="url(#tile)"/></svg>
@@ -0,0 +1 @@
 <svg xmlns="http://www.w3.org/2000/svg" width="1024" height="1024" viewBox="0 0 1024 1024"><path transform="translate(237.62 774.88)" d="M250.04-34.91Q326.35-34.91 368.57-91.33Q410.78-147.75 410.78-243.55Q410.78-249.23 410.78-254.91L254.10-254.91L208.64-185.91L195.65-185.91L195.65-368.57L208.64-368.57L254.10-299.56L407.53-299.56Q396.98-392.92 351.52-447.72Q306.06-502.52 241.11-502.52Q217.57-502.52 198.90-498.46Q180.22-494.40 162.36-482.22L83.62-354.77L69-354.77L77.93-505.76Q112.84-522.81 154.25-533.37Q195.65-543.92 259.78-543.92Q319.86-543.92 371.41-523.22Q422.96-502.52 460.71-465.58Q498.46-428.64 519.57-378.31Q540.67-327.98 540.67-267.90Q540.67-188.34 504.55-125.83Q468.42-63.32 405.10-27.60Q341.78 8.12 259.78 8.12Q200.52 8.12 150.59-3.25Q100.67-14.61 67.38-34.10L56.02-171.29L69.82-171.29L142.88-63.32Q165.61-50.33 191.59-42.62Q217.57-34.91 250.04-34.91" fill="#5a3a12"/><path d="M781.00 744.04 L795.25 695.59 A14.85 14.85 0 1 0 766.76 695.59 Z M781.00 744.04 L830.08 732.15 A14.85 14.85 0 1 0 815.84 707.48 Z M781.00 744.04 L815.84 780.60 A14.85 14.85 0 1 0 830.08 755.93 Z M781.00 744.04 L766.76 792.49 A14.85 14.85 0 1 0 795.25 792.49 Z M781.00 744.04 L731.93 755.93 A14.85 14.85 0 1 0 746.17 780.60 Z M781.00 744.04 L746.17 707.48 A14.85 14.85 0 1 0 731.93 732.15 Z M781.0048 744.0384 m-14.845952 0 a14.845952 14.845952 0 1 0 29.691904 0 a14.845952 14.845952 0 1 0 -29.691904 0 Z" fill="#5a3a12"/></svg>
@@ -0,0 +1 @@
 <svg xmlns="http://www.w3.org/2000/svg" width="1024" height="1024" viewBox="0 0 1024 1024"><rect width="1024" height="1024" rx="174.08" fill="#e6b053"/><defs><clipPath id="tile"><rect width="1024" height="1024" rx="174.08"/></clipPath><linearGradient id="sheen" gradientUnits="userSpaceOnUse" x1="0" y1="1024" x2="1024" y2="0"><stop offset="0" stop-color="#fff" stop-opacity="0"/><stop offset="1" stop-color="#fff" stop-opacity="0.15"/></linearGradient><linearGradient id="shade" gradientUnits="userSpaceOnUse" x1="0" y1="1024" x2="1024" y2="0"><stop offset="0" stop-color="#000" stop-opacity="0.15"/><stop offset="1" stop-color="#000" stop-opacity="0"/></linearGradient></defs><g clip-path="url(#tile)"><rect x="74.67" y="-204.80" width="32.00" height="1433.60" fill="#d8a54e" transform="rotate(4 90.67 512.00)"/><rect x="245.33" y="-204.80" width="32.00" height="1433.60" fill="#d8a54e" transform="rotate(4 261.33 512.00)"/><rect x="416.00" y="-204.80" width="32.00" height="1433.60" fill="#d8a54e" transform="rotate(4 432.00 512.00)"/><rect x="586.67" y="-204.80" width="32.00" height="1433.60" fill="#d8a54e" transform="rotate(4 602.67 512.00)"/><rect x="757.33" y="-204.80" width="32.00" height="1433.60" fill="#d8a54e" transform="rotate(4 773.33 512.00)"/><rect x="928.00" y="-204.80" width="32.00" height="1433.60" fill="#d8a54e" transform="rotate(4 944.00 512.00)"/></g><rect width="1024" height="1024" fill="url(#sheen)" clip-path="url(#tile)"/><rect width="1024" height="1024" fill="url(#shade)" clip-path="url(#tile)"/><path transform="translate(157.86 804.91)" d="M280.84-39.21Q366.55-39.21 413.96-102.58Q461.38-165.95 461.38-273.54Q461.38-279.93 461.38-286.31L285.40-286.31L234.34-208.80L219.75-208.80L219.75-413.96L234.34-413.96L285.40-336.46L457.73-336.46Q445.88-441.32 394.81-502.86Q343.75-564.41 270.81-564.41Q244.37-564.41 223.39-559.85Q202.42-555.29 182.36-541.62L93.92-398.46L77.50-398.46L87.53-568.06Q126.74-587.21 173.24-599.06Q219.75-610.91 291.78-610.91Q359.25-610.91 417.15-587.66Q475.05-564.41 517.45-522.92Q559.85-481.44 583.56-424.90Q607.27-368.37 607.27-300.90Q607.27-211.54 566.69-141.33Q526.12-71.12 454.99-31Q383.87 9.12 291.78 9.12Q225.22 9.12 169.14-3.65Q113.06-16.41 75.68-38.30L62.92-192.39L78.42-192.39L160.48-71.12Q186.01-56.53 215.19-47.87Q244.37-39.21 280.84-39.21" fill="#5a3a12"/><path d="M807.01 807.01 L825.70 743.46 A19.48 19.48 0 1 0 788.33 743.46 Z M807.01 807.01 L871.40 791.42 A19.48 19.48 0 1 0 852.71 759.05 Z M807.01 807.01 L852.71 854.97 A19.48 19.48 0 1 0 871.40 822.61 Z M807.01 807.01 L788.33 870.57 A19.48 19.48 0 1 0 825.70 870.57 Z M807.01 807.01 L742.63 822.61 A19.48 19.48 0 1 0 761.32 854.97 Z M807.01 807.01 L761.32 759.05 A19.48 19.48 0 1 0 742.63 791.42 Z M807.0144 807.0144 m-19.475456 0 a19.475456 19.475456 0 1 0 38.950912 0 a19.475456 19.475456 0 1 0 -38.950912 0 Z" fill="#5a3a12"/></svg>
@@ -0,0 +1,12 @@
 {
  "name": "erudit-icon-brand",
  "private": true,
  "type": "module",
  "description": "Reference generator for the Erudit app-icon set (see docs/ICON_BRANDBOOK.md).",
  "scripts": {
    "build": "node build-set.mjs && node build-android-res.mjs"
  },
  "dependencies": {
    "opentype.js": "^1.3.4"
  }
 }
@@ -0,0 +1,21 @@
 'use strict';
 // Rasterise an icon SVG to PNG at a given size, using the `ui` package's cached
 // Playwright chromium (no extra install). Usage:
 //   node render-png.mjs <in.svg> <out.png> [size=1024]
 import { readFileSync, writeFileSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
 import { dirname, join } from 'node:path';
 const DIR = dirname(fileURLToPath(import.meta.url));
 const pw = await import(join(DIR, '..', '..', '..', 'ui', 'node_modules', '@playwright', 'test', 'index.js'));
 const { chromium } = pw.default ?? pw;
 const [, , svgPath, pngPath, size] = process.argv;
 const S = Number(size) || 1024;
 const svg = readFileSync(svgPath, 'utf8');
 const b = await chromium.launch();
 const pg = await b.newPage({ viewport: { width: S, height: S }, deviceScaleFactor: 1 });
 await pg.setContent(`<!doctype html><meta charset=utf8><style>*{margin:0;padding:0}</style>${svg}`, { waitUntil: 'networkidle' });
 writeFileSync(pngPath, await pg.locator('svg').screenshot({ omitBackground: true }));
 await b.close();
 console.log('wrote', pngPath, S + 'px');
@@ -1,78 +0,0 @@
 'use strict';
 // Extract the glyph outlines the site icons and the og-image wordmark need from a
 // grotesque font (LiberationSans = Arial-metric, matching the game's system-ui/Arial
 // stack) and emit cubic-bezier contours per character, baseline at y=0, y-down,
 // plus the advance width so generate.js can lay out words without the font.
 // Same outline conversion as ../../vk/build/extract.js, generalised to a char set.
 const opentype = require('opentype.js');
 const fs = require('fs');
 const FONT = process.argv[2] || '/usr/share/fonts/truetype/liberation/LiberationSans-Regular.ttf';
 const b = fs.readFileSync(FONT);
 const font = opentype.parse(b.buffer.slice(b.byteOffset, b.byteOffset + b.byteLength));
 const FS = 1000; // em scale
 // The tile glyphs («Э», «8») + every character of the og-image wordmark lines
 // («Эрудит», «Скрэббл — игра в слова»). The space carries only an advance.
 const CHARS = [...new Set('Э8рудитСкэббл—игра в слова')];
 function glyphData(ch) {
  const g = font.charToGlyph(ch);
  const p = g.getPath(0, 0, FS); // baseline at y=0, y-down
  const contours = [];
  let cur = null, prev = null;
  for (const c of p.commands) {
    if (c.type === 'M') {
      if (cur) contours.push(cur);
      cur = [{ v: [c.x, c.y], i: [c.x, c.y], o: [c.x, c.y] }];
      prev = { x: c.x, y: c.y };
    } else if (c.type === 'L') {
      cur.push({ v: [c.x, c.y], i: [c.x, c.y], o: [c.x, c.y] });
      prev = { x: c.x, y: c.y };
    } else if (c.type === 'C') {
      cur[cur.length - 1].o = [c.x1, c.y1];
      cur.push({ v: [c.x, c.y], i: [c.x2, c.y2], o: [c.x, c.y] });
      prev = { x: c.x, y: c.y };
    } else if (c.type === 'Q') {
      const c1 = [prev.x + 2 / 3 * (c.x1 - prev.x), prev.y + 2 / 3 * (c.y1 - prev.y)];
      const c2 = [c.x + 2 / 3 * (c.x1 - c.x), c.y + 2 / 3 * (c.y1 - c.y)];
      cur[cur.length - 1].o = c1;
      cur.push({ v: [c.x, c.y], i: c2, o: [c.x, c.y] });
      prev = { x: c.x, y: c.y };
    } else if (c.type === 'Z') {
      if (cur && cur.length > 1) {
        const last = cur[cur.length - 1], first = cur[0];
        if (Math.hypot(last.v[0] - first.v[0], last.v[1] - first.v[1]) < 1e-3) {
          first.i = last.i; // fold the duplicate closing point into the first
          cur.pop();
        }
      }
      if (cur) { contours.push(cur); cur = null; }
    }
  }
  if (cur) contours.push(cur);
  let minx = Infinity, miny = Infinity, maxx = -Infinity, maxy = -Infinity;
  const out = contours.map(ct => {
    const v = [], i = [], o = [];
    ct.forEach(pt => {
      v.push(pt.v);
      i.push([pt.i[0] - pt.v[0], pt.i[1] - pt.v[1]]);
      o.push([pt.o[0] - pt.v[0], pt.o[1] - pt.v[1]]);
      minx = Math.min(minx, pt.v[0]); maxx = Math.max(maxx, pt.v[0]);
      miny = Math.min(miny, pt.v[1]); maxy = Math.max(maxy, pt.v[1]);
    });
    return { i, o, v, c: true };
  });
  const bbox = out.length
    ? { x: minx, y: miny, w: maxx - minx, h: maxy - miny }
    : { x: 0, y: 0, w: 0, h: 0 }; // the space has no outline
  return { adv: g.advanceWidth * (FS / font.unitsPerEm), bbox, contours: out };
 }
 const glyphs = {};
 for (const ch of CHARS) glyphs[ch] = glyphData(ch);
 const out = __dirname + '/glyphs.json';
 fs.writeFileSync(out, JSON.stringify({ em: FS, glyphs }));
 console.log('wrote', out, fs.statSync(out).size, 'bytes;', CHARS.length, 'glyphs:', CHARS.join(''));
@@ -1,128 +0,0 @@
 'use strict';
 // Site icons + the Open Graph card for the public landing, drawn from the same
 // design as ../../vk (the wooden Erudit tile: face «Э», score «8») and the app's
 // board palette (ui/src/app.css). Everything is composed as SVG from the committed
 // glyph outlines (build/extract.js -> glyphs.json), so no font is needed at build
 // time; the PNG/ICO rasters are screenshots taken with the ui package's Playwright
 // chromium (@playwright/test re-exports the browser API). Outputs go straight to
 // ui/public/:
 //   favicon.svg          96 viewBox, transparent, tile + «Э» (the score is illegible small)
 //   favicon.ico          32x32 PNG-in-ICO render of the same
 //   apple-touch-icon.png 180x180 opaque full-bleed tile (iOS masks its own corners)
 //   og-image.png         1200x630 card: tile + wordmark on the board green
 const fs = require('fs');
 const path = require('path');
 const G = JSON.parse(fs.readFileSync(path.join(__dirname, 'glyphs.json'), 'utf8'));
 const UI = path.resolve(__dirname, '../../../ui');
 const OUT = path.join(UI, 'public');
 // ---- palette (vk loader tile + app.css board tokens) ------------------------
 const FACE = '#D9B978', BORDER = '#B49559', GLYPH = '#1A1A1A';
 const BOARD_DARK = '#2a3330', TEXT = '#e7ece8', TEXT_MUTED = '#cdd6cf';
 // ---- glyph outlines -> SVG path data ----------------------------------------
 const r2 = n => Math.round(n * 100) / 100;
 // pathD renders one glyph's contours scaled by sc and translated by (tx, ty).
 function pathD(g, sc, tx, ty) {
  const pt = (v, d) => `${r2(v[0] * sc + tx + d[0] * sc)} ${r2(v[1] * sc + ty + d[1] * sc)}`;
  const Z = [0, 0];
  return g.contours.map(ct => {
    const n = ct.v.length;
    let d = `M${pt(ct.v[0], Z)}`;
    for (let k = 1; k <= n; k++) {
      const a = k - 1, b = k % n;
      d += `C${pt(ct.v[a], ct.o[a])} ${pt(ct.v[b], ct.i[b])} ${pt(ct.v[b], Z)}`;
    }
    return d + 'Z';
  }).join('');
 }
 // glyphAt centres a glyph's bbox at (cx, cy) with the given pixel cap height, the
 // same placement rule as the vk loader's glyph(). stroke fattens it slightly.
 function glyphAt(ch, capPx, cx, cy, stroke, colour) {
  const g = G.glyphs[ch], sc = capPx / g.bbox.h;
  const d = pathD(g, sc, cx - (g.bbox.x + g.bbox.w / 2) * sc, cy - (g.bbox.y + g.bbox.h / 2) * sc);
  return `<path d="${d}" fill="${colour}" stroke="${colour}" stroke-width="${r2(stroke)}"/>`;
 }
 // textLine lays out a string on a baseline from the per-glyph advances; capPx sets
 // the capital height (measured on «Э»). Returns the combined path + the width.
 function textLine(str, capPx, x, y, colour) {
  const sc = capPx / G.glyphs['Э'].bbox.h;
  let d = '', w = 0;
  for (const ch of str) {
    const g = G.glyphs[ch];
    if (g.contours.length) d += pathD(g, sc, x + w, y);
    w += g.adv * sc;
  }
  return { svg: `<path d="${d}" fill="${colour}"/>`, width: w };
 }
 // tile draws the rounded wooden tile centred at (cx, cy): size px wide/high, with
 // the vk loader's corner (6/52) and rim proportions, «Э» and optionally the «8».
 function tile(cx, cy, size, withScore) {
  const h = size / 2, rx = size * (6 / 52), rim = size * (1.8 / 52);
  let s = `<rect x="${r2(cx - h + rim / 2)}" y="${r2(cy - h + rim / 2)}" width="${r2(size - rim)}" height="${r2(size - rim)}" rx="${r2(rx)}" fill="${FACE}" stroke="${BORDER}" stroke-width="${r2(rim)}"/>`;
  s += glyphAt('Э', size * (32 / 52), cx, cy - size * (1 / 52), size * (1 / 52), GLYPH);
  if (withScore) s += glyphAt('8', size * (8.5 / 52), cx + size * (19.5 / 52), cy + size * (18.5 / 52), size * (0.5 / 52), GLYPH);
  return s;
 }
 const svg = (w, h, body) => `<svg xmlns="http://www.w3.org/2000/svg" width="${w}" height="${h}" viewBox="0 0 ${w} ${h}">${body}</svg>`;
 // ---- favicon.svg (the committed vector master) -------------------------------
 const favicon = svg(96, 96, tile(48, 48, 88, false)) + '\n';
 // ---- apple-touch-icon: opaque full bleed, iOS applies its own corner mask ----
 const appleTouch = svg(180, 180,
  `<rect width="180" height="180" fill="${FACE}"/>` +
  `<rect x="8" y="8" width="164" height="164" rx="18" fill="none" stroke="${BORDER}" stroke-width="4"/>` +
  glyphAt('Э', 100, 90, 88, 3, GLYPH) +
  glyphAt('8', 26, 146, 142, 1.5, GLYPH));
 // ---- og-image: tile + wordmark, centred as one group on the board green ------
 function ogImage() {
  const W = 1200, H = 630, tileSize = 340, gap = 84;
  const l1 = textLine('Эрудит', 112, 0, 0, TEXT);
  const l2 = textLine('Скрэббл — игра в слова', 44, 0, 0, TEXT_MUTED);
  const textW = Math.max(l1.width, l2.width);
  const left = (W - (tileSize + gap + textW)) / 2;
  const tx = left + tileSize + gap;
  // Two baselines around the vertical centre; the tile centre sits between them.
  const b1 = 295, b2 = 408;
  const body =
    `<rect width="${W}" height="${H}" fill="${BOARD_DARK}"/>` +
    tile(left + tileSize / 2, H / 2, tileSize, true) +
    textLine('Эрудит', 112, tx, b1, TEXT).svg +
    textLine('Скрэббл — игра в слова', 44, tx, b2, TEXT_MUTED).svg;
  console.log(`og-image: text ${Math.round(textW)}px wide, group left ${Math.round(left)}px`);
  return svg(W, H, body);
 }
 // ---- rasterisation (Playwright chromium from ui/node_modules) ----------------
 async function shoot(page, markup, w, h, transparent) {
  await page.setViewportSize({ width: w, height: h });
  await page.setContent(`<body style="margin:0">${markup}</body>`);
  return page.screenshot({ omitBackground: transparent });
 }
 // icoFromPNG wraps one PNG as a single-entry .ico (ICONDIR + ICONDIRENTRY + PNG).
 function icoFromPNG(png, sizePx) {
  const h = Buffer.alloc(22);
  h.writeUInt16LE(0, 0); h.writeUInt16LE(1, 2); h.writeUInt16LE(1, 4); // icon, 1 image
  h.writeUInt8(sizePx, 6); h.writeUInt8(sizePx, 7);                    // 32x32
  h.writeUInt16LE(1, 10); h.writeUInt16LE(32, 12);                     // planes, 32bpp
  h.writeUInt32LE(png.length, 14); h.writeUInt32LE(22, 18);            // size, offset
  return Buffer.concat([h, png]);
 }
 (async () => {
  fs.writeFileSync(path.join(OUT, 'favicon.svg'), favicon);
  const { chromium } = require(path.join(UI, 'node_modules', '@playwright/test'));
  const browser = await chromium.launch();
  const page = await browser.newPage();
  const fav32 = await shoot(page, svg(32, 32, tile(16, 16, 29.33, false)), 32, 32, true);
  fs.writeFileSync(path.join(OUT, 'favicon.ico'), icoFromPNG(fav32, 32));
  fs.writeFileSync(path.join(OUT, 'apple-touch-icon.png'), await shoot(page, appleTouch, 180, 180, false));
  fs.writeFileSync(path.join(OUT, 'og-image.png'), await shoot(page, ogImage(), 1200, 630, false));
  await browser.close();
  for (const f of ['favicon.svg', 'favicon.ico', 'apple-touch-icon.png', 'og-image.png']) {
    console.log('wrote', path.join(OUT, f), fs.statSync(path.join(OUT, f)).size, 'bytes');
  }
 })();
@@ -241,7 +241,7 @@ that survives losing the host.
 ## Android app build & release (RuStore)
 The standalone Android app is built by a **manual** workflow, never automatically, and is separate from the
-web/prod rollout — a signed APK uploaded to RuStore by hand. Full plan: [`../ANDROID_PLAN.md`](../ANDROID_PLAN.md).
+web/prod rollout — a signed APK uploaded to RuStore by hand. The build/release runbook follows.
 - **Trigger:** `Actions → android-build → Run workflow` from **`master`**, input `confirm=build` (mirrors
  `prod-deploy`). **Tag the release first** (`git tag vX.Y.Z` on `master`) — the workflow refuses anything
@@ -107,12 +107,13 @@
 		}
 	}
-	# The public offer page is rendered by the render sidecar: it splices the live catalog price
+	# The public legal pages are rendered by the render sidecar: the offer (with the live catalog
-	# list (backend, internal) into the committed ui/legal/offer_ru.md and returns the HTML. Only
+	# price list from the backend spliced into ui/legal/offer_ru.md), the privacy policy and the EULA
-	# /offer/ is exposed here — the sidecar's /render stays off this allow-list, internal-only. Kept
+	# (both static markdown). Only these paths are exposed here — the sidecar's /render stays off this
-	# disjoint from the landing/app paths so the catch-all below never shadows it.
+	# allow-list, internal-only. Kept disjoint from the landing/app paths so the catch-all below never
-	@offer path /offer /offer/*
+	# shadows them.
-	handle @offer {
+	@legal path /offer /offer/* /privacy /privacy/* /eula /eula/*
 	handle @legal {
 		reverse_proxy renderer:8090
 	}
@@ -967,10 +967,14 @@ finished journal on each GET. The only degraded platform is a legacy Telegram cl
 predating `downloadFile`, where the GCG falls back to the old clipboard copy and the
 image option is not offered.
-The same sidecar also serves the **public offer page** at `/offer/` — the one edge-exposed
+The same sidecar also serves the **public legal pages** — the offer at `/offer/`, the privacy
-route on it (caddy routes `/offer/` here; its `/render` stays internal). It reuses the shared
+policy at `/privacy/` and the EULA at `/eula/` — the edge-exposed routes on it (caddy routes them
-`ui/src/lib/offer.ts` renderer (again one renderer, no drift) over the owner-edited
+here; its `/render` stays internal). All three reuse the shared `ui/src/lib/offer.ts`
-`ui/legal/offer_ru.md`, baked into the image, splicing in the **live price list** (§4.4): it
+`renderLegalHtml` (one renderer, no drift) over their owner-edited `ui/legal/*_{ru,en}.md` — each is
 **bilingual (RU + EN)** with a client-side language + theme switcher (default Russian, persisted;
 the offer's EN view transliterates the Russian product names) — baked into the image. `/privacy/`
 and `/eula/` are static; the offer additionally splices in the **live price list** (§4.4) into both
 languages: it
 fetches the two catalog tables as markdown from the backend's internal
 `/api/v1/internal/offer/pricing` at the `<#pricing_template#>` marker, then renders the page. The
 backend projects the tables from the active catalog through `payments.Money` (no float reaches the
@@ -1365,7 +1369,9 @@ Single public origin, path-routed. The Vite build has two entries: a lightweight
 `/app/` (web), `/telegram/` (the Telegram Mini App; on that path without sign-in data
 — no `initData` — the client renders a compact, shareable launch-diagnostic screen instead
 of redirecting away) and `/vk/` (the VK Mini App; the client reads the signed `vk_*` launch
-parameters from the URL and the gateway verifies them in-process — §12); a stray hit on the
+parameters from the URL and the gateway verifies them in-process — §12; on that path without a
 signed launch the client renders the same shareable launch-diagnostic screen rather than starting
 a throwaway guest); a stray hit on the
 gateway's `/` 308-redirects to `/app/`. The **landing** ships in its own static container: the
 `landing` target of `gateway/Dockerfile` (caddy:2-alpine + the same Vite build,
 `deploy/landing/Caddyfile`) serves it at `/`, so stray public traffic is absorbed by
@@ -1446,9 +1452,10 @@ in-process (the distroless image has no `/etc/mime.types`). Hash-named `/assets/
 in-compose **caddy** is the contour's edge: it owns a single `/_gm` Basic-Auth and
 routes `/_gm/grafana/*` to **Grafana** (anonymous-admin, so the one shared login gates
 it with no per-user Grafana accounts) and the rest of `/_gm/*` to the backend-rendered
-**admin console**; `/app/`, `/telegram/`, `/vk/` and the Connect path go to the gateway; `/offer/`
+**admin console**; `/app/`, `/telegram/`, `/vk/` and the Connect path go to the gateway; the public
-(the public offer, rendered by the `renderer` sidecar with the live catalog price list spliced in)
+legal pages `/offer/`, `/privacy/` and `/eula/` (rendered by the `renderer` sidecar — the offer with
-goes to the render sidecar; and the catch-all — notably the landing at `/` — goes to the landing
+the live catalog price list spliced in) go to the render sidecar; and the catch-all — notably the
 landing at `/` — goes to the landing
 container. The
 **Telegram validator** runs as a separate container with **no public ingress**,
 answering only internal gRPC (HMAC, no Telegram egress). The **Telegram bot** holds
@@ -1536,8 +1543,8 @@ hidden in the MVP (`VITE_PAYMENTS_DISABLED`). The APK is built by a **manual** `
 the dicts, and assembles a **release APK** artifact — signed when the `ANDROID_KEYSTORE_*` secrets are
 present, unsigned otherwise. `versionCode`/`versionName` are deterministic from the release tag `vMA.MI.PA`
 (`versionCode = MA*1_000_000 + MI*1_000 + PA`, `versionName = "MA.MI.PA"`). The runner is a host-executor
-with a host-provisioned Android SDK; RuStore upload is manual. Full plan + runbook:
+with a host-provisioned Android SDK; RuStore upload is manual. Runbook:
-[`../ANDROID_PLAN.md`](../ANDROID_PLAN.md), [`../deploy/README.md`](../deploy/README.md).
+[`../deploy/README.md`](../deploy/README.md).
 ## 14. CI & branches
@@ -30,11 +30,13 @@ render with arbitrary languages, so detection would make the indexed content
 nondeterministic); a saved 🌐 choice still wins. The page carries a static Russian SEO head
 (title/description, the Open Graph card Telegram/VK link previews use, a canonical link
 pinned to the production origin, JSON-LD, the favicon set and `robots.txt`), while the SPA
-shell is `noindex` — the landing is the only indexable page. The footer links to the **public
+shell is `noindex` — the landing is the only indexable page. The footer links to the three **legal
-offer** (`/offer/`) and, beside it, **feedback** — the Telegram bot the offer names as the seller's
+documents** — the **user agreement** (`/eula/`), the **privacy policy** (`/privacy/`) and the
-contact. The offer page (the legal document a purchase accepts) is rendered on demand from
+**public offer** (`/offer/`) — and, beside them, **feedback** (the Telegram bot the documents name as
-`ui/legal/offer_ru.md` with its **price list** (§4.4) generated from the live product catalog, so
+the seller's contact). Each is **bilingual (RU/EN)** with a language + theme switcher and is rendered
-the published prices always match what is currently on sale — no redeploy to update them.
+from its `ui/legal/*_{ru,en}.md` sources by the render sidecar; the offer additionally splices in its
 **price list** (§4.4) generated from the live product catalog, so the published prices always match
 what is currently on sale — no redeploy to update them.
 On the plain web the client is an **installable PWA**: a logged-out player sees an install
 call-to-action under the login form (and at the bottom of Settings) that installs the app to the
@@ -70,7 +72,10 @@ A **VK Mini App** launch works the same way: it authenticates from VK's signed l
 `vk_language` and its display name from the VK profile (read on the client, since VK does not put
 the name in the signed launch). While the theme preference is "auto" the app follows the VK
 client's light/dark scheme, and the layout clears the VK mobile home bar. The same quiet-retry
-"couldn't load" screen applies inside VK.
+"couldn't load" screen applies inside VK. Opening a Mini App link directly in an ordinary browser —
 the `/vk/` entry with no signed VK launch, or `/telegram/` with no Telegram sign-in data — shows a
 compact, shareable diagnostic screen instead of proceeding (as a throwaway guest on VK, or by
 redirecting away on Telegram), so a player who ends up there wrongly can screenshot it for us.
 **Email** sign-in (web) mails a branded six-digit confirmation code — localized
 (en/ru), no images — to the address; entering it signs the player in. A new address
 is provisioned on the first request but only becomes a durable account once the code
@@ -430,9 +435,11 @@ unanswered reply. Guests cannot send feedback (the entry is hidden). A player th
 barred from feedback (a role, not a full account block) sees the send control disabled.
 ### Telegram support chat
-A user can also reach the operators straight from the Telegram bot: anything they send the bot
+A user can also reach the operators straight from the Telegram bot. The `/support` command replies
-other than `/start` — text, a photo, a voice message, a file — is forwarded into the operators'
+with the support desk's working hours and what to include (a description and, when possible,
-private support group, grouped into a per-user thread. The user sees no automatic reply; an
+screenshots). Anything else they send the bot other than `/start` — text, a photo, a voice message,
 a file — is forwarded into the operators' private support group, grouped into a per-user thread. The
 user sees no automatic reply to a forwarded message; an
 operator answers from that thread and the bot delivers the answer back as an ordinary bot message,
 so to the user it is a quiet one-to-one conversation. Operators can block a user (the bot then
 silently ignores their messages) or clear a thread's messages. This is independent of the in-app
@@ -535,7 +542,8 @@ at any time (games already lost stay lost).
 Where the bot manages a channel's **linked discussion chat**, everyone may write by default and the
 bot **mutes** a player who is **not registered** or is **blocked**, un-muting them once they register
-or are unblocked. So an unregistered newcomer who comments is muted (the promo bot points them at the
+or are unblocked. It also clears the automatic pin Telegram puts on each channel post that is
 auto-forwarded into the chat, so only deliberately pinned messages stay pinned. So an unregistered newcomer who comments is muted (the promo bot points them at the
 game to register, after which the bot restores their voice), and a registered, unblocked player simply
 writes. An operator can also **mute a player in the chat only** — a `chat_muted` role on the user card —
 without a full account block; an account block mutes them in the chat regardless. Muting and unmuting
@@ -32,12 +32,13 @@ top-1 подсказку, безлимитную проверку слова с
 главнее. Страница несёт статическую русскую SEO-«шапку» (title/description, карточка
 Open Graph, которую используют превью ссылок в Telegram/VK, канонический адрес
 продакшен-домена, JSON-LD, набор favicon и `robots.txt`), а оболочка SPA помечена
-`noindex` — индексируется только посадочная страница. В подвале — ссылки на **публичную
+`noindex` — индексируется только посадочная страница. В подвале — ссылки на три **юридических
-оферту** (`/offer/`) и рядом на **обратную связь** (тот самый Telegram-бот, который оферта
+документа** — **пользовательское соглашение** (`/eula/`), **политику конфиденциальности**
-указывает как контакт Продавца). Страница оферты (юридический документ, который принимается при
+(`/privacy/`) и **публичную оферту** (`/offer/`) — и рядом на **обратную связь** (тот самый
-покупке) рендерится по запросу из `ui/legal/offer_ru.md`, а её **перечень стоимости** (§4.4)
+Telegram-бот, который документы указывают как контакт Продавца). Каждый — **двуязычный (RU/EN)** с
-формируется из живого каталога товаров, поэтому опубликованные цены всегда совпадают с тем, что
+переключателем языка и темы, рендерится из исходников `ui/legal/*_{ru,en}.md` сайдкаром-рендерером;
-сейчас в продаже — без передеплоя.
+оферта дополнительно подставляет **перечень стоимости** (§4.4), формируемый из живого каталога
 товаров, поэтому опубликованные цены всегда совпадают с тем, что сейчас в продаже — без передеплоя.
 В обычном вебе клиент — **устанавливаемое PWA**: незалогиненный игрок видит призыв к установке
 под формой входа (и внизу «Настроек»), который в один тап ставит приложение на рабочий стол
@@ -76,7 +77,10 @@ launch-параметрам VK (их проверяет gateway), и при пе
 так как VK не кладёт имя в подписанный запуск). Пока тема в режиме «авто», приложение следует
 светлой/тёмной схеме VK-клиента, а раскладка обходит нижнюю home-bar VK на мобильных. Тот же экран
 тихого повтора «не удалось
-загрузить» действует и внутри VK.
+загрузить» действует и внутри VK. Если открыть ссылку на мини-приложение прямо в обычном браузере —
 вход `/vk/` без подписанного запуска VK или `/telegram/` без данных входа Telegram — показывается
 компактный экран диагностики, которым можно поделиться, вместо того чтобы продолжить (гостем-однодневкой
 на VK или редиректом прочь на Telegram), — чтобы игрок, случайно попавший туда, прислал нам скриншот.
 **Email**-вход (в вебе) отправляет на адрес брендированный шестизначный код подтверждения —
 локализованный (ru/en), без картинок; после ввода игрок входит. Новый адрес заводится при первом
 запросе, но становится постоянным аккаунтом только после подтверждения кода — так брошенная,
@@ -441,9 +445,11 @@ Telegram. На сенсорном устройстве в настройках
 обратную связь (роль, а не полная блокировка аккаунта), видит кнопку отправки недоступной.
 ### Чат поддержки в Telegram
-С операторами можно поговорить и прямо из Telegram-бота: всё, что пользователь присылает боту,
+С операторами можно поговорить и прямо из Telegram-бота. Команда `/support` отвечает графиком работы
-кроме `/start` — текст, фото, голосовое, файл, — пересылается в закрытую группу поддержки операторов
+поддержки и напоминанием, что приложить (подробное описание и, по возможности, скриншоты). Всё
-и собирается в отдельную ветку на пользователя. Пользователь не получает автоответа; оператор
+остальное, что пользователь присылает боту, кроме `/start` — текст, фото, голосовое, файл, —
 пересылается в закрытую группу поддержки операторов и собирается в отдельную ветку на пользователя.
 Пользователь не получает автоответа на пересланное сообщение; оператор
 отвечает из этой ветки, и бот доставляет ответ обратно обычным сообщением — для пользователя это
 тихий диалог один на один. Операторы могут заблокировать пользователя (тогда бот молча игнорирует
 его сообщения) или очистить сообщения ветки. Это независимо от встроенной «Обратной связи» выше —
@@ -549,7 +555,9 @@ high-rate флага. С карточки пользователя операт
 Там, где бот ведёт **привязанный к каналу чат-обсуждение**, по умолчанию писать может каждый, а бот
 **глушит** игрока, который **не зарегистрирован** или **заблокирован**, и снимает мьют, как только тот
-зарегистрируется или будет разблокирован. То есть незарегистрированного новичка, написавшего в чат,
+зарегистрируется или будет разблокирован. Ещё бот убирает автоматический пин, который Telegram ставит
 на каждый пост канала, авто-форварднутый в чат, — закреплёнными остаются только намеренно закреплённые
 сообщения. То есть незарегистрированного новичка, написавшего в чат,
 бот глушит (промо-бот направляет его в игру зарегистрироваться, после чего бот возвращает голос), а
 зарегистрированный незаблокированный игрок просто пишет. Оператор также может **замьютить игрока только
 в чате** — роль `chat_muted` на карточке пользователя — без полной блокировки аккаунта; блокировка
@@ -0,0 +1,90 @@
 # Icon & logo asset map
 > The whole shipped icon set is sliced from **one master**. This file is the per-platform
 > **target map** (which file goes where, at what size). How the mark itself is constructed
 > — proportions, palette, wood grain, the light/shadow gradients, the «Э» + ✻ placement,
 > all in fractions of the side — is specified in [`ICON_BRANDBOOK.md`](ICON_BRANDBOOK.md).
 > The reference generator, the pinned Spectral font and the committed masters live in
 > [`../assets/icons/brand/`](../assets/icons/brand/).
 ## The master (one source, six layers)
 `brand/build-icon.mjs` emits any `--variant light|dark` in any `--layer`:
 | Layer | What | Feeds |
 |---|---|---|
 | `full` | rounded tile + master mark | `favicon.svg` |
 | `flat` | square tile + master mark (OS rounds) | apple-touch, PWA "any", VK, TG, store |
 | `background` | square tile only, full-bleed | Android adaptive background |
 | `foreground` | mark only, transparent, re-placed for the round mask | Android adaptive foreground |
 | `maskable` | square tile + foreground-placed mark | PWA `maskable` |
 | `monochrome` | foreground-placed silhouette, flat colour | Android 13+ themed layer |
 `brand/build-set.mjs` renders every raster below; `brand/build-android-res.mjs` renders
 the Android launcher resources.
 ## Generated targets
 ### Web — `ui/public/` (via `brand/build-set.mjs`)
 | File | Size | Note |
 |---|---|---|
 | `favicon.svg` | vector | **light + dark in one file** via `prefers-color-scheme` |
 | `favicon.ico` | 32×32 | PNG-in-ICO; answers the blind `/favicon.ico` probe |
 | `apple-touch-icon.png` | 180×180 | opaque full-bleed (iOS masks its own corners) |
 | `icon-192.png` / `icon-512.png` | 192 / 512 | PWA `any`, light |
 | `icon-192-dark.png` / `icon-512-dark.png` | 192 / 512 | dark variants (generated; see PWA note) |
 | `icon-maskable-512.png` | 512×512 | PWA `maskable`, light |
 | `icon-maskable-512-dark.png` | 512×512 | dark variant (generated; see PWA note) |
 | `og-image.png` | 1200×630 | board-green card: master tile + «Эрудит» / Игра в слова |
 ### PWA — `ui/public/manifest.webmanifest`
 Referenced icons are the **light** set (`icon-192`, `icon-512` = `any`;
 `icon-maskable-512` = `maskable`). The manifest has **no reliable way to pick an icon by
 colour scheme**, so the dark PNGs are **generated but not referenced** — theming the
 in-browser tab is handled by `favicon.svg` instead. Wire the dark files in only if a
 concrete installer target is known to honour them.
 ### Android — `ui/android/app/src/main/res/` (via `brand/build-android-res.mjs`)
 Capacitor layer inputs are `ui/assets/{icon,icon-foreground,icon-background}.png`. The
 resources are **hand-generated from the layers**, not `capacitor-assets` — our layers
 already fill the 108 dp canvas (foreground inside the 61 % safe zone, background
 full-bleed), so they must be placed with **no inset**, and we add the **monochrome**
 themed layer, neither of which `capacitor-assets` does. Per density mdpi→xxxhdpi (+ldpi):
 - `mipmap-*/ic_launcher.png` / `ic_launcher_round.png` — legacy square / round (composite)
 - `mipmap-*/ic_launcher_foreground.png` + `ic_launcher_background.png` — adaptive layers
 - `mipmap-*/ic_launcher_monochrome.png` — themed layer
 - `mipmap-anydpi-v26/ic_launcher.xml` + `ic_launcher_round.xml` — **no `<inset>`**, with
  `<background>` + `<foreground>` + `<monochrome>` (committed by hand)
 ### iOS / iPhone / iPad — FUTURE
 No iOS shell today. When one exists, `flat` (opaque, no alpha, no rounded corners; the OS
 masks) drives the asset catalog — a single 1024×1024 marketing icon (Xcode derives the
 rest), plus light/dark/tinted where the catalog supports it.
 ### VK / Telegram / store — manual upload (`brand/{vk,tg,store}/`)
 Square, **no rounding** (each platform crops/rounds itself), light `flat`:
 | Folder | Files | Use |
 |---|---|---|
 | `vk/` | `vk-576/278/150/32.png` | VK community / app icons |
 | `tg/` | `tg-512.png` | Telegram bot avatar + Mini App icon (512, square; TG crops circular) |
 | `tg/` | `tg-demo-640x360.png` | BotFather `/newapp` demo banner (tile + wordmark) |
 | `store/` | `rustore-512.png` | RuStore app icon |
 | RuStore | screenshots / feature graphic | per the RuStore listing spec (uploaded by hand) |
 | Google Play (future) | icon / feature graphic | 512×512 / 1024×500 |
 | App Store (future) | marketing icon / screenshots | 1024×1024 / per device class |
 ## Regenerate
 ```sh
 cd assets/icons/brand
 npm i                        # opentype.js (rasterisation reuses the ui package's chromium)
 node build-set.mjs           # web (ui/public) + Capacitor layers (ui/assets) + vk/ tg/ store/ + og
 node build-android-res.mjs   # Android launcher resources (all densities + monochrome)
 ```
@@ -0,0 +1,166 @@
 # Erudit app-icon — brand book
 The single source of truth for **how the Erudit icon is constructed**. It is written to
 be reproducible *from words alone*: a designer with this document and the Spectral font
 can rebuild the icon exactly, at any size, without pixel-matching anything.
 Two rules make that possible:
 1. **The icon is a square.** Every size and position below is a **fraction of the
   square's side** (equivalently, a percentage). Nothing is in pixels. Draw the square
   at whatever resolution you need and scale each value to it.
 2. **The origin is the top-left corner.** `x` grows right, `y` grows down. So "center
   `48.1% / 49.2%`" means a point `0.481·side` from the left and `0.492·side` from the top.
 The companion generator in [`../assets/icons/brand/`](../assets/icons/brand/) is the
 machine version of this exact spec (`build-icon.mjs`, where each constant is the same
 fraction printed here). The `docs/ICONS.md` map covers the *opposite* concern — which
 files/sizes we slice this master into for each platform.
 ## Anatomy
 ![Construction scheme](../assets/icons/brand/icon-construction.png)
 Bottom-to-top the icon is six layers: **tile → wood grain → light sheen → shadow →
 letter «Э» → star ✻**. The letter and star are always drawn last, at full ink colour;
 the grain and the two gradients only ever touch the background.
 ## Palette
 The icon ships as a **light** and a **dark** variant (a matched pair — the light tile
 carries dark ink, the dark tile carries light ink). Each variant uses four colours.
 | Role | Light | Dark |
 |------|-------|------|
 | **Tile** — the wooden body | `#e6b053` | `#4a3316` |
 | **Ink** — the «Э» and the ✻ | `#5a3a12` | `#f2d9a0` |
 | **Grain** — the vertical stripes | `#d8a54e` | `#432e14` |
 | **Sheen** — diagonal light | white, α 0 → 15 % | white, α 0 → 15 % |
 | **Shadow** — diagonal dark | black, α 15 → 0 % | black, α 15 → 0 % |
 The grain colour is intentionally close to the tile — a hair darker — so the stripes
 read as wood texture, not as stripes.
 ## 1 — Tile
 A **square with rounded corners**, corner radius **17 %** of the side, filled with the
 **Tile** colour. This is the whole background; there is no separate outer frame or
 border. Corners are baked at 17 %; platform masks (iOS/Android) may round further on top.
 ## 2 — Wood grain
 Subtle vertical planks over the tile:
 - Divide the width into **6 equal columns** (each `1/6` of the side wide).
 - On the **right edge of each column**, draw one **vertical stripe**, width **`1/32` of
  the side** (≈ 3.1 %), running the full height.
 - Move the **whole set of six stripes left** by **`1/16` of the side** (= two stripe
  widths).
 - **Tilt every stripe 4°** (clockwise, about its own centre).
 - Draw the stripes **past the top and bottom edges** so the tilt leaves no empty corners,
  then **clip the whole set to the tile** (so the rounded corners stay clean).
 - Colour: **Grain**.
 ## 3 — Light sheen · 4 — Shadow
 Two linear gradients along the **same diagonal**, from the **bottom-left corner to the
 top-right corner**, each clipped to the tile and sitting **above the grain, below the
 letter**:
 - **Sheen** — white. Fully transparent at the bottom-left, rising to **15 % opacity** at
  the top-right. Brightens the top-right.
 - **Shadow** — black. **15 % opacity** at the bottom-left, fading to transparent at the
  top-right. Deepens the bottom-left.
 Together they give the tile a lit-from-the-top-right, resting-in-shadow-at-the-bottom-left
 sense of depth. Both percentages are a tuning knob (`--sheen`, `--shade`).
 ## 5 — The letter «Э»
 - Typeface: **Spectral, Bold** (SIL OFL; pinned in the brand folder).
 - Glyph: the Cyrillic capital **«Э»** (U+042D).
 - Size: scale the glyph so its **ink bounding box is 60.5 % of the side tall** (its width
  then follows the font — about 53.2 %).
 - Position: place the **center of that bounding box** at **48.1 % / 49.2 %** (just up and
  left of the icon center).
 - Colour: **Ink**.
 ## 6 — The star ✻
 A **six-spoke teardrop asterisk** (the "score" mark that replaces a tile's point number):
 - Each spoke tapers to a **point at the center** and ends in a **round bulb**; a central
  disc equal to a bulb fuses the six spokes.
 - Outer diameter: **17.3 % of the side**.
 - Bulb radius (and the central disc): **22 % of the star's radius**.
 - Position: center at **78.8 % / 78.8 %** — tucked to the lower-right of the «Э», like a
  subscript, with a clear gap from the letter.
 - Colour: **Ink**.
 Spectral has no ✻ glyph, so the star is **drawn geometrically**, not set as type. The exact
 construction is in `build-icon.mjs` (`starPath`).
 ## Composition intent
 The «Э» and the ✻ are treated as **one group**. Its combined bounding box measures
 about **65.9 % × 68.6 %** of the side, and it is placed so its **bottom-right corner sits
 at 87.5 % / 87.5 %** of the icon (the lower-right corner of an inner `12.5 % … 87.5 %`
 safe square). That is what pushes the composition down-and-right and leaves the star room
 in the corner. When re-deriving positions, this is the anchor to preserve.
 > This bottom-right bias suits a **full-bleed** icon (iOS / PWA / favicon, which show
 > almost the whole square). Android crops more, so it uses a **separate two-layer build**
 > — see the next section. The master itself is never moved for Android.
 ## Android adaptive icon (two layers)
 Android icons are **108×108 dp** and the OS applies its own mask (circle, squircle,
 rounded square…). Only the **inner 66 dp = 61 % of the side, centred** is guaranteed
 visible under every mask; the outer ~1/6 ring is used for the mask and motion effects.
 So Android is **not** the full-bleed master — it is built as two layers:
 - **Background** — the tile with wood grain and the light/shadow gradients, **full-bleed
  and square** (no rounded corners; the OS supplies the shape). It fills the whole 108 dp
  layer, so the sacrificial outer ring is just more wood.
 - **Foreground** — **only the «Э» + ✻**, transparent, **re-placed** to sit safely inside
  the mask:
  - «Э»: box height **53.9 %**, box center **52.3 % / 49.5 %**.
  - ✻: outer diameter **13.2 %** (smaller than the master's), center **76.3 % / 72.7 %**,
    tucked closer to the letter.
  - The mark is centred, then nudged **right 8 % / down 3 %** so it reads optically
    centred under the round mask, and the whole group fits within the **61 % safe zone**.
 Everything else (palette, grain, gradients, star construction) is identical to the master.
 ## Variants in use
 The **light** variant is the primary icon (launcher, favicon, apple-touch, PWA). The
 **dark** variant is shipped in addition wherever the platform can pick by appearance
 (e.g. an SVG favicon via `prefers-color-scheme`). Where a platform allows only one icon,
 use **light**.
 ## Reproduce
 ```sh
 cd assets/icons/brand
 npm i opentype.js
 # full master (iOS / PWA / favicon), either variant:
 node build-icon.mjs --variant light --layer full        > icon-light.svg
 # Android adaptive layers:
 node build-icon.mjs --variant light --layer background   > icon-light-android-background.svg
 node build-icon.mjs --variant light --layer foreground   > icon-light-android-foreground.svg
 # the construction figure:
 node build-icon.mjs --variant light --scheme             > icon-construction.svg
 node render-png.mjs  icon-light.svg  icon-light.png  1024   # any size
 ```
 `--layer` is `full` (default), `background`, or `foreground`. All outputs are committed
 alongside the generator in [`../assets/icons/brand/`](../assets/icons/brand/).
 ## Masters
 | | Light | Dark |
 |-|-------|------|
 | **Full** (iOS / PWA / favicon) | ![light](../assets/icons/brand/icon-light.png) | ![dark](../assets/icons/brand/icon-dark.png) |
 | **Android background** | ![lbg](../assets/icons/brand/icon-light-android-background.png) | ![dbg](../assets/icons/brand/icon-dark-android-background.png) |
 | **Android foreground** | ![lfg](../assets/icons/brand/icon-light-android-foreground.png) | ![dfg](../assets/icons/brand/icon-dark-android-foreground.png) |
@@ -40,7 +40,7 @@ tests or touching CI.
  in the **offline guest lobby** (not `/login`), plays a local vs_ai move from the **bundled** dawg tier
  (`playwright.config.ts` bundles the dicts into `dist-e2e/dict/`), starts a hotseat game, and drives
  `window.__native.reconcile()` to prove online lights up — the device-local game stays listed in the
-  **unified lobby** (closing G-step-0) — and Profile hides the Telegram/VK link buttons.
+  **unified lobby** — and Profile hides the Telegram/VK link buttons.
  The **version-gate** spec (`e2e/update.spec.ts`) drives the `__update` hook to prove both tiers — the
  hard *Update / Play offline* notice (and that "Play offline" drops into the offline lobby) and the soft
  dismissable *update available* nudge in the lobby; `retry.test.ts` covers the `FailedPrecondition →
@@ -121,7 +121,8 @@ web code exchange via `internal/vkid`, and both forward the trusted `external_id
 Rate-limit defaults (built-in): public 30/min·IP (burst 10), authenticated
 300/min·user (burst 80, sized for multi-device play), admin
 60/min·IP (burst 20, guarding the `/_gm` mount ahead of its Basic-Auth),
-email-code 5/10 min·IP (burst 2).
+email-code 5/10 min·IP (burst 4, covering request + a mistyped code + the
 correct one; defence-in-depth over the backend's per-code 5-attempt/15-min cap).
 Every rejection increments `gateway_rate_limited_total{class}`
 (`user`/`public`/`email`/`admin`) and logs one Debug line; a reporter drains the
@@ -165,7 +165,12 @@ func DefaultRateLimit() RateLimitConfig {
 		// because multi-device play tripped the old 120/40.
 		UserPerMinute: 300, UserBurst: 80,
 		AdminPerMinute: 60, AdminBurst: 20,
-		EmailPer10Min: 5, EmailBurst: 2,
+		// Email-code path (per IP), defence-in-depth over the backend's own per-code guards
 		// (a 5-attempt cap + 15-min TTL + per-recipient send throttle). Burst 4 so the honest flow
 		// — request a code, mistype once or twice, then enter the right one — is not throttled
 		// mid-login: a request + wrong-code + right-code sequence exhausted the old burst of 2 and
 		// tripped the limit on the correct code, which the client mis-read as going offline.
 		EmailPer10Min: 5, EmailBurst: 4,
 	}
 }
@@ -4,6 +4,7 @@ import (
 	"testing"
 	"time"
 	"scrabble/gateway/internal/config"
 	"scrabble/gateway/internal/ratelimit"
 )
@@ -44,3 +45,20 @@ func TestPerWindow(t *testing.T) {
 		t.Fatalf("per-window burst = %v, want [true true false]", got)
 	}
 }
 // TestEmailBurstAllowsHonestLoginFlow guards the default email-code burst against being
 // tightened back below the honest login sequence: requesting a code, submitting one wrong
 // code, then the correct one are three immediate email-class events from one IP, and all
 // must pass. A burst of 2 denied the correct-code login, which the client mis-read as going
 // offline and could not recover from on the session-less login screen. This is defence in
 // depth over the backend's own per-code attempt cap and code TTL.
 func TestEmailBurstAllowsHonestLoginFlow(t *testing.T) {
 	rl := config.DefaultRateLimit()
 	p := ratelimit.Per(rl.EmailPer10Min, 10*time.Minute, rl.EmailBurst)
 	l := ratelimit.New()
 	for i, want := range []bool{true, true, true} { // request code, wrong code, right code
 		if got := l.Allow("email:198.51.100.7", p); got != want {
 			t.Fatalf("honest email event %d allowed = %v, want %v", i+1, got, want)
 		}
 	}
 }
@@ -9,8 +9,9 @@ it. See [`docs/ARCHITECTURE.md`](../../docs/ARCHITECTURE.md) §1/§3/§10/§12/
  validation gRPC API the gateway calls during Telegram auth, on the trusted internal
  network with no VPN. Because it needs no Telegram reachability, **game login stays up
  even when the bot or the bot-link is down**.
- **`cmd/bot`** (remote) — runs the Bot API long-poll (Mini App launch + `/start`
+- **`cmd/bot`** (remote) — runs the Bot API long-poll (Mini App launch, `/start`
-  deep-links) and `sendMessage`, the only component reaching the Telegram Bot API. It
+  deep-links, the `/support` info reply) and `sendMessage`, the only component reaching
  the Telegram Bot API. It
  holds **no inbound port**: it dials the gateway over a reverse **mTLS bot-link** and
  executes the send commands the gateway pushes, so its egress can run on a host with
  native Telegram access (a VPN sidecar in the test contour, a separate host in prod).
@@ -49,6 +50,13 @@ Telegram identity to an account from a browser. Both map a rejection to gRPC
  chat" — rather than a dangling "@"). This is otherwise **self-contained**
  — the bot never calls back into the game, so `/start` onboarding works even when the game
  is down.
 - **Support command.** `/support` replies with a fixed support-desk info message — the
  operators' working hours and what to include (a description and, when possible,
  screenshots). Like `/start` it answers only in a private chat and is **Russian or
  English** by the sender's reported language, and it is listed in the bot's command menu
  (localized, Russian/English). It is a dedicated command handler, so it intercepts
  `/support` before the support relay below — the command line itself is not forwarded to
  operators, while the user's following description still is.
 - **Moderated-chat gating.** When `TELEGRAM_CHAT_ID` names a channel's linked discussion
  group, the bot gates who may write there. The group **allows sending by default** (a
  human setting) and the bot only **restricts** — Telegram intersects the chat default with
@@ -62,7 +70,12 @@ Telegram identity to an account from a browser. Both map a rejection to gRPC
  the bot applies it — but only to a member currently in the chat (it probes one user with
  `getChatMember`, since bots cannot list members). The bot must be an **administrator** there
  with the **"Ban users"** right (the Bot API `can_restrict_members`), and it subscribes to
-  `chat_member` updates, which Telegram delivers only to a chat admin.
+  `chat_member` updates, which Telegram delivers only to a chat admin. The bot also **removes
  the automatic pin** Telegram places on every channel post auto-forwarded into this linked
  chat (the `Message.is_automatic_forward` marker): it unpins only that one message
  (`unpinChatMessage` by id), so a pin set by a human admin — or by the bot for another
  message — is never touched. This needs the **pin-messages** right (`can_pin_messages`) in
  addition to "Ban users"; a startup self-check warns when it is missing.
 - **Support relay (optional).** When `TELEGRAM_SUPPORT_CHAT_ID` names a private **forum
  supergroup**, the bot runs a direct support channel for users who message it. A user's first
  non-`/start` message opens a dedicated **forum topic** whose first message is an info card (the
@@ -76,7 +89,8 @@ Telegram identity to an account from a browser. Both map a rejection to gRPC
  message. State (user→topic map, block list, relayed ids) is a JSON file under
  `TELEGRAM_SUPPORT_STATE_DIR` on a persistent volume — the bot host has no database. The bot must
  be an **administrator** in the group with the **manage-topics** and **delete-messages** rights.
-  The relay is bot-local (no backend, no bot-link) and the user gets no automatic reply.
+  The relay is bot-local (no backend, no bot-link) and a forwarded message gets no automatic
  reply (the `/support` command above aside).
 - **Promo bot (optional).** When `TELEGRAM_PROMO_BOT_TOKEN` is set, the container also
  runs a **second, standalone** bot whose only job is to answer `/start` with a localized
  message and a button that opens the **main** bot's Mini App. The button is a **URL** to
@@ -1,6 +1,7 @@
 // Package bot wraps the Telegram Bot API client (github.com/go-telegram/bot): it
 // runs the long-poll update loop — replying to /start (with an optional deep-link
-// payload) and any other message with a Mini App launch button — and sends the
+// payload), to /support with the support-desk info message, and to any other message
 // with a Mini App launch button — and sends the
 // notification and admin messages the connector requests. The bot token lives only
 // in this process.
 package bot
@@ -136,6 +137,7 @@ func New(cfg Config, log *zap.Logger) (*Bot, error) {
 	opts := []tgbot.Option{
 		tgbot.WithDefaultHandler(t.handleUpdate),
 		tgbot.WithMessageTextHandler("/start", tgbot.MatchTypePrefix, t.handleStart),
 		tgbot.WithMessageTextHandler("/support", tgbot.MatchTypePrefix, t.handleSupport),
 	}
 	if t.supportEnabled() {
 		t.supportLocks = newKeyedMutex()
@@ -186,11 +188,26 @@ func New(cfg Config, log *zap.Logger) (*Bot, error) {
 // Run sets the bot commands and the Mini App menu button, then blocks on the
 // long-poll update loop until ctx is cancelled.
 func (t *Bot) Run(ctx context.Context) {
 	// Command menu: the default (fallback) list is English; a Russian-scoped list
 	// localises the labels for ru clients. A language scope replaces the whole list, so
 	// it repeats /start with its own Russian label.
 	if _, err := t.api.SetMyCommands(ctx, &tgbot.SetMyCommandsParams{
-		Commands: []models.BotCommand{{Command: "start", Description: "Open Scrabble"}},
+		Commands: []models.BotCommand{
 			{Command: "start", Description: "Play Scrabble"},
 			{Command: "support", Description: "Contact the administration"},
 		},
 	}); err != nil {
 		t.log.Warn("set commands failed", zap.Error(err))
 	}
 	if _, err := t.api.SetMyCommands(ctx, &tgbot.SetMyCommandsParams{
 		LanguageCode: "ru",
 		Commands: []models.BotCommand{
 			{Command: "start", Description: "Играть в «Эрудита»"},
 			{Command: "support", Description: "Связаться с администрацией"},
 		},
 	}); err != nil {
 		t.log.Warn("set ru commands failed", zap.Error(err))
 	}
 	if _, err := t.api.SetChatMenuButton(ctx, &tgbot.SetChatMenuButtonParams{
 		MenuButton: models.MenuButtonWebApp{
 			Type:   models.MenuButtonTypeWebApp,
@@ -268,6 +285,12 @@ func (t *Bot) logChatAdminStatus(ctx context.Context) {
 		return
 	}
 	t.log.Info("chat gating ready: bot is an admin with the restrict-members right", zap.Int64("chat_id", t.chatID))
 	// The same moderated chat also gets the linked channel's auto-forwarded posts un-pinned,
 	// which needs the pin-messages right; warn (separately from gating) when it is missing.
 	if !m.Administrator.CanPinMessages {
 		t.log.Warn("auto-unpin of linked channel posts WILL NOT WORK: the bot lacks the pin-messages right",
 			zap.Int64("chat_id", t.chatID))
 	}
 }
 // Notify sends a notification message with a Mini App launch button that opens the
@@ -388,6 +411,14 @@ func (t *Bot) handleUpdate(ctx context.Context, api *tgbot.Bot, update *models.U
 		t.handleSuccessfulPayment(ctx, update.Message)
 		return
 	}
 	// A channel post automatically forwarded into the moderated discussion chat is
 	// auto-pinned by Telegram (a non-disableable behaviour). Unpin that one message so only
 	// deliberate pins remain; it targets this exact message id, so a pin set by a human admin
 	// — or by the bot for another message — is never touched.
 	if m := update.Message; m != nil && m.IsAutomaticForward && t.chatID != 0 && m.Chat.ID == t.chatID {
 		t.handleLinkedChannelPin(ctx, m)
 		return
 	}
 	// Support relay (when enabled): a non-/start message — /start has its own handler —
 	// is either an operator's reply in the support chat or a user's direct message to
 	// relay. Everything else falls through to the Mini App launch reply.
@@ -404,6 +435,24 @@ func (t *Bot) handleUpdate(ctx context.Context, api *tgbot.Bot, update *models.U
 	t.handleStart(ctx, api, update)
 }
 // handleLinkedChannelPin removes Telegram's automatic pin from a linked channel's post
 // that was auto-forwarded into the moderated discussion chat. It unpins only that exact
 // message (by id), so a pin set by a human admin — or by the bot for another message — is
 // left untouched. It needs the bot to hold the pin-messages right in the chat; a missing
 // right surfaces as a warning (the unpin then no-ops), not a crash.
 func (t *Bot) handleLinkedChannelPin(ctx context.Context, m *models.Message) {
 	if _, err := t.api.UnpinChatMessage(ctx, &tgbot.UnpinChatMessageParams{
 		ChatID:    m.Chat.ID,
 		MessageID: m.ID,
 	}); err != nil {
 		t.log.Warn("could not unpin an auto-forwarded channel post; does the bot have the pin-messages right?",
 			zap.Int64("chat_id", m.Chat.ID), zap.Int("message_id", m.ID), zap.Error(err))
 		return
 	}
 	t.log.Debug("unpinned an auto-forwarded channel post",
 		zap.Int64("chat_id", m.Chat.ID), zap.Int("message_id", m.ID))
 }
 // SetEligibilityResolver wires the chat-eligibility resolver after construction (the
 // bot-link client backing it is built after the bot).
 func (t *Bot) SetEligibilityResolver(resolve EligibilityResolver) {
@@ -19,10 +19,11 @@ const (
 )
 // chatAPI is a fake Bot API for the chat-gating tests: it answers getMe, returns a
-// scripted getChatMember status, and records restrictChatMember calls.
+// scripted getChatMember status, and records restrictChatMember and unpinChatMessage calls.
 type chatAPI struct {
 	memberStatus string // the status getChatMember reports (default "left")
 	restricts    []restrictCall
 	unpins       []unpinCall
 }
 type restrictCall struct {
@@ -30,6 +31,13 @@ type restrictCall struct {
 	canSend bool // can_send_messages in the applied permissions
 }
 // unpinCall records a single unpinChatMessage request (raw form values, mirroring the
 // restrictCall style).
 type unpinCall struct {
 	chatID    string
 	messageID string
 }
 func (a *chatAPI) ServeHTTP(w http.ResponseWriter, r *http.Request) {
 	switch {
 	case strings.HasSuffix(r.URL.Path, "/getMe"):
@@ -47,6 +55,9 @@ func (a *chatAPI) ServeHTTP(w http.ResponseWriter, r *http.Request) {
 		_ = json.Unmarshal([]byte(r.FormValue("permissions")), &perms)
 		a.restricts = append(a.restricts, restrictCall{userID: r.FormValue("user_id"), canSend: perms.CanSendMessages})
 		io.WriteString(w, `{"ok":true,"result":true}`)
 	case strings.HasSuffix(r.URL.Path, "/unpinChatMessage"):
 		a.unpins = append(a.unpins, unpinCall{chatID: r.FormValue("chat_id"), messageID: r.FormValue("message_id")})
 		io.WriteString(w, `{"ok":true,"result":true}`)
 	default:
 		io.WriteString(w, `{"ok":true,"result":true}`)
 	}
@@ -237,3 +248,44 @@ func TestApplyChatGateSkipsAbsentAndAdmin(t *testing.T) {
 		})
 	}
 }
 // autoForwardUpdate builds a message update as it lands in the discussion chat: a post in
 // chat chatID with id msgID and is_automatic_forward set to auto.
 func autoForwardUpdate(chatID int64, msgID int, auto bool) *models.Update {
 	return &models.Update{Message: &models.Message{
 		ID:                 msgID,
 		Chat:               models.Chat{ID: chatID, Type: models.ChatTypeSupergroup},
 		IsAutomaticForward: auto,
 	}}
 }
 func TestAutoForwardUnpinned(t *testing.T) {
 	// A channel post auto-forwarded into the moderated chat is unpinned by its exact id.
 	api := &chatAPI{}
 	b := newChatBot(t, api)
 	b.handleUpdate(context.Background(), b.api, autoForwardUpdate(testChatID, 42, true))
 	if len(api.unpins) != 1 || api.unpins[0].chatID != "555" || api.unpins[0].messageID != "42" {
 		t.Fatalf("unpins = %+v, want one {555, 42}", api.unpins)
 	}
 }
 func TestNonAutoForwardNotUnpinned(t *testing.T) {
 	// A normal message in the moderated chat (e.g. another admin's pinned message) is never
 	// unpinned — the is_automatic_forward filter is what guards every other pin.
 	api := &chatAPI{}
 	b := newChatBot(t, api)
 	b.handleUpdate(context.Background(), b.api, autoForwardUpdate(testChatID, 42, false))
 	if len(api.unpins) != 0 {
 		t.Fatalf("unpins = %+v, want none for a non-auto-forward message", api.unpins)
 	}
 }
 func TestAutoForwardOtherChatIgnored(t *testing.T) {
 	// An auto-forward in some other chat (not the configured moderated one) is ignored.
 	api := &chatAPI{}
 	b := newChatBot(t, api)
 	b.handleUpdate(context.Background(), b.api, autoForwardUpdate(999, 42, true))
 	if len(api.unpins) != 0 {
 		t.Fatalf("unpins = %+v, want none for a foreign chat", api.unpins)
 	}
 }
@@ -0,0 +1,63 @@
 package bot
 import (
 	"context"
 	"strings"
 	tgbot "github.com/go-telegram/bot"
 	"github.com/go-telegram/bot/models"
 	"go.uber.org/zap"
 )
 // The /support command replies with a fixed support-desk info message — the operators'
 // working hours and what to include (a description and, when possible, screenshots). It
 // is a dedicated command handler (registered like /start), so it intercepts "/support"
 // before the support relay: the command line itself is not forwarded into an operator
 // topic, while the user's following description still is.
 // handleSupport replies to /support with the localized support-desk info message. Like
 // handleStart it answers only in a private chat — in the moderated group the bot never
 // chats — and it sends a plain text message with no launch button.
 func (t *Bot) handleSupport(ctx context.Context, api *tgbot.Bot, update *models.Update) {
 	if update.Message == nil {
 		return
 	}
 	if update.Message.Chat.Type != models.ChatTypePrivate {
 		return
 	}
 	// The sender's Telegram language rides on the message itself (Message.from.language_code);
 	// fall back to English when it is absent, matching startText.
 	lang := ""
 	if update.Message.From != nil {
 		lang = update.Message.From.LanguageCode
 	}
 	if _, err := api.SendMessage(ctx, &tgbot.SendMessageParams{
 		ChatID: update.Message.Chat.ID,
 		Text:   supportText(lang),
 	}); err != nil {
 		t.log.Warn("reply to support failed", zap.Error(err))
 	}
 }
 // supportText returns the localized /support reply. Russian is used when lang (the IETF
 // language tag the Telegram client reports on the message's sender) starts with "ru",
 // English otherwise and when it is absent — mirroring startText's language choice.
 func supportText(lang string) string {
 	if strings.HasPrefix(strings.ToLower(lang), "ru") {
 		return ruSupport
 	}
 	return enSupport
 }
 // ruSupport and enSupport are the Russian and English /support replies; the English one
 // is the fallback for any non-Russian or missing sender language.
 const (
 	ruSupport = "Поддержка «Эрудита» на связи с 08:00 до 18:00 (по времени UTC). " +
 		"Если Вы столкнулись с проблемой, подробно опишите её и добавьте, по возможности, скриншоты. " +
 		"Также будем рады выслушать Ваши пожелания и предложения по функционалу игры. " +
 		"Ответим в самое ближайшее время."
 	enSupport = "“Erudite” support is available from 08:00 to 18:00 (UTC). " +
 		"If you have run into a problem, please describe it in detail and attach screenshots if you can. " +
 		"We would also be glad to hear your wishes and suggestions about the game's features. " +
 		"We will reply as soon as possible."
 )
@@ -0,0 +1,51 @@
 package bot
 import (
 	"context"
 	"strings"
 	"testing"
 	"github.com/go-telegram/bot/models"
 )
 func TestHandleSupportRepliesPrivateOnly(t *testing.T) {
 	t.Run("english by default", func(t *testing.T) {
 		api := &fakeBotAPI{}
 		b := newTestBot(t, api)
 		b.handleSupport(context.Background(), b.api, &models.Update{Message: &models.Message{
 			Chat: models.Chat{ID: 42, Type: models.ChatTypePrivate}, Text: "/support",
 		}})
 		if api.chatID != "42" {
 			t.Errorf("chat_id = %q, want 42", api.chatID)
 		}
 		// No reported language -> English support reply.
 		if !strings.Contains(api.text, "support is available") {
 			t.Errorf("text = %q, want the English support reply", api.text)
 		}
 		// A plain info message carries no launch button.
 		if api.replyMarkup != "" {
 			t.Errorf("reply_markup = %q, want none", api.replyMarkup)
 		}
 	})
 	t.Run("russian for a ru sender", func(t *testing.T) {
 		api := &fakeBotAPI{}
 		b := newTestBot(t, api)
 		b.handleSupport(context.Background(), b.api, &models.Update{Message: &models.Message{
 			Chat: models.Chat{ID: 42, Type: models.ChatTypePrivate}, Text: "/support",
 			From: &models.User{ID: 7, LanguageCode: "ru"},
 		}})
 		if !strings.Contains(api.text, "Поддержка «Эрудита»") {
 			t.Errorf("text = %q, want the Russian support reply", api.text)
 		}
 	})
 	t.Run("group ignored", func(t *testing.T) {
 		api := &fakeBotAPI{}
 		b := newTestBot(t, api)
 		b.handleSupport(context.Background(), b.api, &models.Update{Message: &models.Message{
 			Chat: models.Chat{ID: -100, Type: models.ChatTypeSupergroup}, Text: "/support",
 		}})
 		if api.chatID != "" {
 			t.Errorf("group /support got a reply (chat=%q); the bot never chats in the group", api.chatID)
 		}
 	})
 }
@@ -23,10 +23,11 @@ ENV APP_VERSION=${VERSION}
 WORKDIR /app
 COPY --from=build /src/renderer/node_modules ./node_modules
 COPY --from=build /src/renderer/dist ./dist
-COPY renderer/src/server.mjs renderer/src/render.mjs renderer/src/offer.mjs ./src/
+COPY renderer/src/server.mjs renderer/src/render.mjs renderer/src/offer.mjs renderer/src/legal.mjs ./src/
-# The public-offer prose (GET /offer/): the owner-edited markdown, read once at boot. The dynamic
+# The public legal pages: the owner-edited markdown, read once at boot. GET /offer/ also splices in
-# price list is fetched from the backend at request time and spliced in.
+# the live price list fetched from the backend at request time; GET /privacy/ and GET /eula/ are
-COPY ui/legal/offer_ru.md ./legal/offer_ru.md
+# static (no dynamic data).
 COPY ui/legal/offer_ru.md ui/legal/offer_en.md ui/legal/privacy_ru.md ui/legal/privacy_en.md ui/legal/eula_ru.md ui/legal/eula_en.md ./legal/
 USER node
 EXPOSE 8090
 CMD ["node", "src/server.mjs"]
@@ -1,10 +1,11 @@
-# renderer — the render sidecar (finished-game image + public offer page)
+# renderer — the render sidecar (finished-game image + public legal pages)
 An internal Node service that runs shared `ui/src/lib` renderers server-side — bundled verbatim at
 image build time (`src/entry.ts` → esbuild → `dist/gameimage.mjs`) so there is one renderer and no
 drift from the browser. It serves two surfaces: the finished-game export **PNG** (on
 [skia-canvas](https://github.com/samizdatco/skia-canvas), pixel-identical to the design the owner
-signed off) and the public **offer page**.
+signed off) and the public **legal pages** (the offer, the privacy policy and the EULA), each
 bilingual (RU + EN) with a language + theme switcher.
 ## Interface
@@ -16,9 +17,16 @@ signed off) and the public **offer page**.
 - `GET /offer/` — the public offer page as `text/html`: the owner-edited `ui/legal/offer_ru.md`
  (baked into the image, read at boot) with the live catalog **price list** (§4.4) fetched as
  markdown from the backend's internal `/api/v1/internal/offer/pricing` (`RENDERER_BACKEND_URL`)
-  and spliced in at the `<#pricing_template#>` marker, then rendered by the shared
+  and spliced in at the `<#pricing_template#>` marker of both language sources (`offer_ru.md` /
-  `ui/src/lib/offer.ts`. `GET /offer` → 301 `/offer/`. **The only edge-exposed route** — caddy
+  `offer_en.md`), then rendered as one bilingual page by the shared `ui/src/lib/offer.ts`
-  routes `/offer/` here; a backend outage yields a 502, never a stale price list.
+  `renderLegalHtml` (the English view transliterates the Russian product names client-side).
  `GET /offer` → 301 `/offer/`. Caddy routes `/offer/` here; a backend outage yields a 502, never a
  stale price list.
 - `GET /privacy/` — the privacy policy, and `GET /eula/` the end-user licence agreement, both as
  `text/html`: the owner-edited `ui/legal/{privacy,eula}_{ru,en}.md` (baked in, read at boot),
  rendered once at boot as one bilingual page by the same shared `renderLegalHtml` and served from
  cache. **Static** — no backend fetch. `GET /privacy` / `GET /eula` → 301 to the trailing-slash
  form. Caddy routes these here too.
 - `GET /healthz` — liveness (the compose healthcheck the backend's `depends_on` gates on).
 The service renders and nothing else: for the PNG, authentication, the participant check and the
@@ -32,10 +40,14 @@ page.
 ```sh
 pnpm install          # skia-canvas + esbuild MUST stay approved in pnpm-workspace.yaml
                      # (allowBuilds) or the native binary is silently never fetched
-pnpm test             # bundles, then node --test (PNG smoke + offer splice)
+pnpm test             # bundles, then node --test (PNG smoke + offer/legal render)
-# local run on :8090 (RENDERER_PORT overrides). For /offer/, point at the offer source and a
+# local run on :8090 (RENDERER_PORT overrides). The server reads all three legal sources at boot, so
-# reachable backend (else the boot read / the price fetch fail):
+# point each at its ui/legal source (the baked paths do not exist in a local checkout); /offer/ also
-RENDERER_OFFER_MD=../ui/legal/offer_ru.md RENDERER_BACKEND_URL=http://localhost:8080 node src/server.mjs
+# needs a reachable backend for the price fetch:
 RENDERER_OFFER_MD=../ui/legal/offer_ru.md RENDERER_OFFER_EN_MD=../ui/legal/offer_en.md \
  RENDERER_PRIVACY_MD=../ui/legal/privacy_ru.md RENDERER_PRIVACY_EN_MD=../ui/legal/privacy_en.md \
  RENDERER_EULA_MD=../ui/legal/eula_ru.md RENDERER_EULA_EN_MD=../ui/legal/eula_en.md \
  RENDERER_BACKEND_URL=http://localhost:8080 node src/server.mjs
 ```
 The runtime image (`renderer/Dockerfile`, `node:22-slim`) bakes in Liberation Sans (the
@@ -2,8 +2,9 @@
 // browser build unit-tests — so the sidecar runs them on the server. Bundled by `pnpm run bundle`
 // into dist/gameimage.mjs (type erasure only; the ui project type-checks the source):
 //   - drawGameImage + setAlphabet: the finished-game PNG export (POST /render).
-//   - renderOfferHtml: the public-offer page (GET /offer/) — the same renderer the landing build
+//   - renderOfferHtml / renderLegalHtml: the public legal pages — GET /offer/ (with the live
-//     used to invoke, now server-side so the live catalog price list can be spliced in.
+//     catalog price list spliced in), GET /privacy/ and GET /eula/ (static) — server-side so one
 //     renderer serves them all.
 export { drawGameImage, type RenderOptions } from '../../ui/src/lib/gameimage';
 export { setAlphabet } from '../../ui/src/lib/alphabet';
-export { renderOfferHtml } from '../../ui/src/lib/offer';
+export { renderOfferHtml, renderLegalHtml } from '../../ui/src/lib/offer';
@@ -0,0 +1,24 @@
 // The public legal pages (GET /privacy/, GET /eula/): the owner-edited RU + EN markdown under
 // ui/legal/, rendered by the SAME shared renderLegalHtml the offer uses (bundled from ui/src/lib/offer)
 // into one bilingual page with a language + theme switcher. Unlike the offer, these carry no dynamic
 // data — no backend fetch, no marker splice. Kept out of server.mjs so the per-page title/canonical
 // presets are unit-testable without HTTP (test/legal.test.mjs).
 import { renderLegalHtml } from '../dist/gameimage.mjs';
 // renderPrivacy renders the privacy-policy markdown (RU + EN) as the standalone /privacy/ page.
 export function renderPrivacy(ruMd, enMd) {
  return renderLegalHtml({
    ru: { md: ruMd, title: 'Политика конфиденциальности — Эрудит' },
    en: { md: enMd, title: 'Privacy Policy — Erudit' },
    canonical: 'https://erudit-game.ru/privacy/',
  });
 }
 // renderEula renders the end-user licence agreement markdown (RU + EN) as the standalone /eula/ page.
 export function renderEula(ruMd, enMd) {
  return renderLegalHtml({
    ru: { md: ruMd, title: 'Пользовательское соглашение — Эрудит' },
    en: { md: enMd, title: 'Terms of Use — Erudit' },
    canonical: 'https://erudit-game.ru/eula/',
  });
 }
@@ -1,17 +1,21 @@
-// The public-offer page renderer: splices the live catalog price list into the owner-edited offer
+// The public-offer page renderer: splices the live catalog price list into BOTH language sources of
-// markdown and renders it with the SAME renderOfferHtml the landing build used to invoke (bundled
+// the owner-edited offer markdown at the pricing marker, and renders the bilingual /offer/ page with
-// from ui/src/lib/offer). Kept out of server.mjs so the substitution is unit-testable without HTTP.
+// the SAME renderOfferHtml the browser build uses (bundled from ui/src/lib/offer). The English view
 // transliterates the Russian product names client-side (renderLegalHtml). Kept out of server.mjs so
 // the substitution is unit-testable without HTTP.
 import { renderOfferHtml } from '../dist/gameimage.mjs';
-// pricingMarker is the token ui/legal/offer_ru.md carries at §4.4 where the price list belongs. It
+// pricingMarker is the token ui/legal/offer_{ru,en}.md carry at §4.4 where the price list belongs. It
 // mirrors the backend marker (backend/internal/payments/offer.go) and is replaced with the fetched
 // tables before rendering.
 export const pricingMarker = '<#pricing_template#>';
-// renderOffer returns the standalone /offer/ HTML: the offer markdown with the pricing marker
+// renderOffer returns the standalone /offer/ HTML: the RU + EN offer markdown with the pricing marker
 // replaced by pricingTables (the two markdown tables the backend projects from the active catalog),
-// rendered to a self-contained document. The replacement is literal (a function replacer) so a "$"
+// rendered to a self-contained bilingual document. The replacement is literal (a function replacer)
-// in a product title is never read as a replacement pattern; a missing marker leaves the text as is.
+// so a "$" in a product title is never read as a replacement pattern; a missing marker leaves the
-export function renderOffer(offerMarkdown, pricingTables) {
+// text as is.
-  return renderOfferHtml(offerMarkdown.replace(pricingMarker, () => pricingTables));
+export function renderOffer(ruMarkdown, enMarkdown, pricingTables) {
  const splice = (md) => md.replace(pricingMarker, () => pricingTables);
  return renderOfferHtml(splice(ruMarkdown), splice(enMarkdown));
 }
@@ -2,29 +2,44 @@
 // renderers (bundled from ui/src/lib at image build time). It serves two surfaces:
 //
 //   POST /render  {game, moves, alphabet, labels, dateLocale, hostname, scale?} → image/png
-//   GET  /offer/  → text/html  (the public offer page: ui/legal/offer_ru.md with the live catalog
+//   GET  /offer/   → text/html (the public offer page: ui/legal/offer_ru.md with the live catalog
-//                   price list spliced in — the only edge-exposed route; caddy routes /offer/ here)
+//                    price list spliced in; caddy routes /offer/ here)
-//   GET  /offer   → 301 /offer/
+//   GET  /privacy/ → text/html (the privacy policy: ui/legal/privacy_ru.md, static)
-//   GET  /healthz → 200
+//   GET  /eula/    → text/html (the EULA: ui/legal/eula_ru.md, static)
 //   GET  /offer, /privacy, /eula → 301 to the trailing-slash form
 //   GET  /healthz  → 200
 //
 // /render is internal-only (the backend calls it; authentication, participant checks and the signed
-// public URL live in the backend). /offer/ is reachable from the edge but read-only and unprivileged
+// public URL live in the backend). The legal pages (/offer/, /privacy/, /eula/) are reachable from the
-// — it fetches the price list from the backend's internal endpoint and renders the committed offer
+// edge but read-only and unprivileged: /offer/ splices the price list fetched from the backend's
-// markdown; no user input reaches it.
+// internal endpoint into the committed offer markdown; /privacy/ and /eula/ are static committed
 // markdown. No user input reaches any of them.
 import { createServer } from 'node:http';
 import { readFileSync } from 'node:fs';
 import { renderRequest } from './render.mjs';
 import { renderOffer } from './offer.mjs';
 import { renderPrivacy, renderEula } from './legal.mjs';
 const PORT = Number(process.env.RENDERER_PORT || 8090);
 // A render request is a finished game's journal — generously capped.
 const MAX_BODY = 2 * 1024 * 1024;
-// The offer prose is baked into the image (renderer/Dockerfile) and read once at boot; only the
+// Each legal page is bilingual (RU + EN); both markdown sources are baked into the image
-// price list is dynamic (fetched per request). The backend endpoint is internal (off the edge
+// (renderer/Dockerfile) and read once at boot. The offer's price list is the only dynamic part
-// allow-list) and serves the tables from its in-memory cache. RENDERER_OFFER_MD overrides the baked
+// (fetched per request from the backend's internal endpoint and spliced in); privacy + eula carry no
-// path for a local run (point it at ../ui/legal/offer_ru.md).
+// dynamic data. The RENDERER_*_MD / RENDERER_*_EN_MD env vars override the baked paths for a local run.
-const OFFER_MD = readFileSync(process.env.RENDERER_OFFER_MD || new URL('../legal/offer_ru.md', import.meta.url), 'utf8');
+const rd = (p) => readFileSync(p, 'utf8');
 const OFFER_MD = rd(process.env.RENDERER_OFFER_MD || new URL('../legal/offer_ru.md', import.meta.url));
 const OFFER_EN_MD = rd(process.env.RENDERER_OFFER_EN_MD || new URL('../legal/offer_en.md', import.meta.url));
 const PRIVACY_MD = rd(process.env.RENDERER_PRIVACY_MD || new URL('../legal/privacy_ru.md', import.meta.url));
 const PRIVACY_EN_MD = rd(process.env.RENDERER_PRIVACY_EN_MD || new URL('../legal/privacy_en.md', import.meta.url));
 const EULA_MD = rd(process.env.RENDERER_EULA_MD || new URL('../legal/eula_ru.md', import.meta.url));
 const EULA_EN_MD = rd(process.env.RENDERER_EULA_EN_MD || new URL('../legal/eula_en.md', import.meta.url));
 // Render the static legal pages once at boot and serve the cached HTML: re-parsing the large EULA on
 // every request is slow enough under deploy-time host contention (the renderer is CPU/memory-capped)
 // to flake the contour probe. The offer stays per-request because it splices in the live price list.
 const PRIVACY_HTML = renderPrivacy(PRIVACY_MD, PRIVACY_EN_MD);
 const EULA_HTML = renderEula(EULA_MD, EULA_EN_MD);
 const OFFER_PRICING_URL =
  (process.env.RENDERER_BACKEND_URL || 'http://backend:8080') + '/api/v1/internal/offer/pricing';
@@ -68,12 +83,28 @@ const server = createServer(async (req, res) => {
      return;
    }
    if (req.method === 'GET' && path === '/offer/') {
-      const html = renderOffer(OFFER_MD, await fetchOfferPricing());
+      const html = renderOffer(OFFER_MD, OFFER_EN_MD, await fetchOfferPricing());
      res
        .writeHead(200, { 'content-type': 'text/html; charset=utf-8', 'cache-control': 'no-cache' })
        .end(html);
      return;
    }
    if (req.method === 'GET' && (path === '/privacy' || path === '/eula')) {
      res.writeHead(301, { location: path + '/' }).end();
      return;
    }
    if (req.method === 'GET' && path === '/privacy/') {
      res
        .writeHead(200, { 'content-type': 'text/html; charset=utf-8', 'cache-control': 'no-cache' })
        .end(PRIVACY_HTML);
      return;
    }
    if (req.method === 'GET' && path === '/eula/') {
      res
        .writeHead(200, { 'content-type': 'text/html; charset=utf-8', 'cache-control': 'no-cache' })
        .end(EULA_HTML);
      return;
    }
    if (req.method === 'POST' && path === '/render') {
      const png = await renderRequest(JSON.parse(await readBody(req)));
      res.writeHead(200, { 'content-type': 'image/png', 'content-length': png.length }).end(png);
@@ -0,0 +1,27 @@
 // Unit test for the static legal pages: renderPrivacy / renderEula wrap the owner-edited RU + EN
 // markdown in the shared bilingual legal-page chrome (bundled renderLegalHtml) with the right title +
 // canonical URL and no dynamic data. The prose rendering itself is unit-tested in ui/ (offer.test.ts);
 // here we assert the per-page presets and that both languages reach the document.
 import test from 'node:test';
 import assert from 'node:assert/strict';
 import { renderPrivacy, renderEula } from '../src/legal.mjs';
 test('renderPrivacy wraps the RU + EN markdown in the privacy-page chrome', () => {
  const html = renderPrivacy(
    '# Политика конфиденциальности\n\n**1.1.** ИНН 290210610742.',
    '# Privacy Policy\n\n**1.1.** TIN 290210610742.',
  );
  assert.ok(html.includes('<!doctype html>'), 'a standalone document');
  assert.ok(html.includes('<title>Политика конфиденциальности — Эрудит</title>'), 'the privacy title');
  assert.ok(html.includes('data-title-en="Privacy Policy — Erudit"'), 'the English title for the toggle');
  assert.ok(html.includes('href="https://erudit-game.ru/privacy/"'), 'the privacy canonical URL');
  assert.ok(html.includes('290210610742'), 'the prose reached the document');
  assert.ok(html.includes('<main data-lang="en" hidden>'), 'the English body is present, hidden by default');
 });
 test('renderEula wraps the RU + EN markdown in the EULA-page chrome', () => {
  const html = renderEula('# Лицензионное соглашение\n\nтекст', '# Terms of Use\n\ntext');
  assert.ok(html.includes('<title>Пользовательское соглашение — Эрудит</title>'), 'the EULA title');
  assert.ok(html.includes('data-title-en="Terms of Use — Erudit"'), 'the English title for the toggle');
  assert.ok(html.includes('href="https://erudit-game.ru/eula/"'), 'the EULA canonical URL');
 });
@@ -1,7 +1,7 @@
-// Unit test for the public-offer page assembly: renderOffer splices the backend's price-list
+// Unit test for the public-offer page assembly: renderOffer splices the backend's price-list markdown
-// markdown into the offer at the pricing marker and renders it with the shared renderOfferHtml
+// into BOTH language sources of the offer at the pricing marker and renders them with the shared
-// (bundled from ui/src/lib/offer). The prose rendering itself is unit-tested in ui/ (offer.test.ts);
+// renderOfferHtml (bundled from ui/src/lib/offer). The prose rendering itself is unit-tested in ui/
-// here we assert the substitution and that the tables reach the rendered HTML.
+// (offer.test.ts); here we assert the substitution reaches both languages and the tables render.
 import test from 'node:test';
 import assert from 'node:assert/strict';
 import { renderOffer, pricingMarker } from '../src/offer.mjs';
@@ -11,19 +11,21 @@ const tables =
  '| --- | --- | --- | --- |\n' +
  '| 50 «Фишек» | 200.00 | 30 | 100 |';
-test('splices the price list into the offer and renders the tables to HTML', () => {
+test('splices the price list into both language sources and renders the tables', () => {
-  const md = `# Публичная оферта\n\n**4.4.** Стоимость Товаров:\n\n${pricingMarker}\n`;
+  const ru = `# Публичная оферта\n\n**4.4.** Стоимость Товаров:\n\n${pricingMarker}\n`;
-  const html = renderOffer(md, tables);
+  const en = `# Public offer\n\n**4.4.** Cost of the Goods:\n\n${pricingMarker}\n`;
-  // The marker is gone and the projected table reached the document as a real HTML table.
+  const html = renderOffer(ru, en, tables);
-  assert.ok(!html.includes(pricingMarker), 'pricing marker must be substituted');
+  // The marker is gone from both languages and the projected table reached the document.
  assert.ok(!html.includes(pricingMarker), 'the pricing marker must be substituted in both languages');
  assert.ok(html.includes('<table>'), 'the price list must render as an HTML table');
  assert.ok(html.includes('<td>200.00</td>'), 'a rouble price cell must be present');
  assert.ok(html.includes('50 «Фишек»'), 'the product title must be present');
-  // The offer chrome from the shared renderer is intact.
+  assert.ok(html.includes('<h1>Публичная оферта</h1>'), 'the Russian heading rendered');
  assert.ok(html.includes('<h1>Public offer</h1>'), 'the English heading rendered');
  assert.ok(html.includes('<!doctype html>'));
 });
 test('a "$" in a title is substituted literally, not as a replacement pattern', () => {
-  const html = renderOffer(`x ${pricingMarker} y`, '| $5 pack | 1 |');
+  const html = renderOffer(`ru ${pricingMarker}`, `en ${pricingMarker}`, '| $5 pack | 1 |');
  assert.ok(html.includes('$5 pack'), 'a "$" in the tables must survive substitution');
 });
@@ -35,7 +35,7 @@ The **native (Capacitor) build** additionally reads `VITE_DICT_VERSION` (the bun
 the offline path requests, matching the packaged DAWGs), `VITE_PAYMENTS_DISABLED=1` (hide in-app purchases
 in the RuStore MVP), `VITE_RUSTORE_URL` (the update overlay's store target; empty until published) and
 `VITE_APP_VERSION` (`git describe --tags` → the `X-Client-Version` gate header) — all wired by
-`.gitea/workflows/android-build.yaml`; see `ANDROID_PLAN.md`.
+`.gitea/workflows/android-build.yaml`.
 The build has **two entries**: the game SPA (`index.html`, served at `/app/` and
 `/telegram/`) and a lightweight landing page (`landing.html`, served at `/`).
@@ -53,7 +53,7 @@ captures/
 .idea/navEditor.xml
 # Keystore files
-# Release signing material must never be committed (see ANDROID_PLAN.md — keystore loss/leak risk).
+# Release signing material must never be committed (keystore loss/leak risk).
 *.jks
 *.keystore
@@ -1,9 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
-    <background>
+    <background android:drawable="@mipmap/ic_launcher_background" />
-        <inset android:drawable="@mipmap/ic_launcher_background" android:inset="16.7%" />
+    <foreground android:drawable="@mipmap/ic_launcher_foreground" />
-    </background>
+    <monochrome android:drawable="@mipmap/ic_launcher_monochrome" />
-    <foreground>
+</adaptive-icon>
        <inset android:drawable="@mipmap/ic_launcher_foreground" android:inset="16.7%" />
    </foreground>
 </adaptive-icon>
@@ -1,9 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
-    <background>
+    <background android:drawable="@mipmap/ic_launcher_background" />
-        <inset android:drawable="@mipmap/ic_launcher_background" android:inset="16.7%" />
+    <foreground android:drawable="@mipmap/ic_launcher_foreground" />
-    </background>
+    <monochrome android:drawable="@mipmap/ic_launcher_monochrome" />
-    <foreground>
+</adaptive-icon>
        <inset android:drawable="@mipmap/ic_launcher_foreground" android:inset="16.7%" />
    </foreground>
 </adaptive-icon>
--- a/Show More
+++ b/Show More
		`@@ -0,0 +1 @@`
							<svg xmlns="http://www.w3.org/2000/svg" width="1024" height="1024" viewBox="0 0 1024 1024"><rect width="1024" height="1024" rx="0" fill="#4a3316"/><defs><clipPath id="tile"><rect width="1024" height="1024" rx="0"/></clipPath><linearGradient id="sheen" gradientUnits="userSpaceOnUse" x1="0" y1="1024" x2="1024" y2="0"><stop offset="0" stop-color="#fff" stop-opacity="0"/><stop offset="1" stop-color="#fff" stop-opacity="0.15"/></linearGradient><linearGradient id="shade" gradientUnits="userSpaceOnUse" x1="0" y1="1024" x2="1024" y2="0"><stop offset="0" stop-color="#000" stop-opacity="0.15"/><stop offset="1" stop-color="#000" stop-opacity="0"/></linearGradient></defs><g clip-path="url(#tile)"><rect x="74.67" y="-204.80" width="32.00" height="1433.60" fill="#432e14" transform="rotate(4 90.67 512.00)"/><rect x="245.33" y="-204.80" width="32.00" height="1433.60" fill="#432e14" transform="rotate(4 261.33 512.00)"/><rect x="416.00" y="-204.80" width="32.00" height="1433.60" fill="#432e14" transform="rotate(4 432.00 512.00)"/><rect x="586.67" y="-204.80" width="32.00" height="1433.60" fill="#432e14" transform="rotate(4 602.67 512.00)"/><rect x="757.33" y="-204.80" width="32.00" height="1433.60" fill="#432e14" transform="rotate(4 773.33 512.00)"/><rect x="928.00" y="-204.80" width="32.00" height="1433.60" fill="#432e14" transform="rotate(4 944.00 512.00)"/></g><rect width="1024" height="1024" fill="url(#sheen)" clip-path="url(#tile)"/><rect width="1024" height="1024" fill="url(#shade)" clip-path="url(#tile)"/></svg>