# Guscio della sessione di ELX Client (mockup, standard «Un filo solo»)

Proprietario: lane GUSCIO. Le altre lane lo **includono e non lo modificano**; per un cambio si chiede al leader.
Fonti (sola lettura): `ElxClient/src/lib/clean-menu/prototypes/BladeSwitchMenu.svelte`, `src/lib/shell/*` (SidebarProfile, SessionStatusBar,
SessionGroups, SidebarServices, ClientFocusSurface), `src/lib/desktop-apps/PowerMenu.svelte` e `DesktopAppTaskbar.svelte` (chat),
`src/lib/GamingProfile.svelte` (notifiche), testi `src/lib/i18n/it.json`.

## Come includerlo

```html
<html lang="it" class="hud-root">
<head>
  <!-- cambio pagina: la pagina si mostra solo quando è costruita tutta (DESIGN.md «Cambio pagina») -->
  <link rel="expect" href="#g-pagina-pronta" blocking="render">
  <!-- caratteri dello standard -->
  <link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Big+Shoulders+Stencil+Display:wght@800&family=Chakra+Petch:wght@500;600;700&family=JetBrains+Mono:wght@500;600&display=swap">
  <link rel="stylesheet" href="../guscio/stelle.css">
  <link rel="stylesheet" href="../guscio/guscio.css">
  <link rel="stylesheet" href="../guscio/hover.css">   <!-- passaggio del mouse sulle carte stile Razer (DESIGN.md) -->
  <link rel="stylesheet" href="la-mia-pagina.css">
</head>
<body>
<div id="stage" class="g-stage is-entering" data-route="premi">   <!-- data-route = chiave della voce del menu -->
  <main class="g-page">
    <header class="g-head"><div class="g-head__copy">
      <span class="g-kicker">Premi</span><h1 class="g-title">Premi</h1><p class="g-desc">…</p>
    </div></header>
    …contenuto della pagina…
  </main>
</div>
<script src="../guscio/guscio.js"></script>   <!-- prima del proprio script -->
<script src="la-mia-pagina.js"></script>
</body></html>
```

`guscio.js` disegna da solo, subito nella forma FINALE (niente pezzi costruiti in un posto e spostati in un altro; 04/11): striscia a sinistra (`aside.g-menu`, solo icone, indicatore rosso `.l2-mark`),
filo d'oro col fascio, barra in alto a destra (`header.l-top`: icone rapide e riquadro del giocatore `.l-chip`), popup del profilo (`#l-chip`: profilo, Sessione, Tariffe, Credito, Vantaggi), pannelli Chat e
Notifiche, Missioni, Bacheca, Riscatta codice, barra di prova `#tools` (il controllo la nasconde; disegno in `barra-prova.js`: cassetto a destra chiuso di serie, linguetta «⚙ prova», Esc chiude). La pagina mette solo `<main class="g-page">`.

## Voci del menu e cartelle

| Voce | `data-route` | cartella `pagine/…` |
|---|---|---|
| Dashboard | `dashboard` | `dashboard` |
| Giochi | `giochi` | `giochi` |
| Tutte le app | `tutte-le-app` | `tutte-le-app` |
| Premi | `premi` | `premi-l3-c` (Owner 31/10: versione C; la vecchia `premi` resta per confronto) |
| Eventi e tornei | `eventi` | `eventi-fuoco` (31/10; nella striscia L3 «Eventi»; la griglia `eventi3` si apre da «Mostra tutti» e torna con «← Eventi») |
| Eventi live | `eventi-live` | `eventi-live` |
| Shop | `shop` | `shop` |
| Promozioni | `promozioni` | `promozioni` |
| Sticker | `sticker` | `sticker` |
| Profilo (clic sul riquadro del profilo) | `profilo` | `profilo` |

Il clic su una voce chiede al server se `../<cartella>/index.html` esiste: se manca, si resta sulla pagina (nessun errore all'apertura).
Le lane che fanno altre pagine usano **queste** cartelle e questo `data-route`.

## Misure (2K, adattate con `zoom`, mai `transform: scale`)

- Striscia 0-48, filo d'oro 48-50 (2 px, oro .62, alto 1440). Contenuto da x 114 (`--g-x`) a 2496 (margine 64) (schermo.css).
- Barra in alto: y 48, alta 56 (l2.css). Pagina (`.g-page`) e pannelli (`.g-surface`): da y 192 (48 nelle pagine con titolo) a 1376.

## Gettoni (`:root`)

Standard (uguali a STANDARD-LOGIN): `--hud-ink` `#f5f5f7`, `--hud-ink-2` `#9aa3ad`, `--hud-ink-3` `#5c6470`, `--hud-line` / `--hud-line-hi`,
`--hud-field` / `--hud-field-on`, `--hud-red` `#e11d48` / `--hud-red-lo`, `--hud-err` `#ff5c5c`, `--hud-ok` `#3ddc84`, `--hud-warn` (tempo in esaurimento),
`--hud-group` `#2dd4bf` (**solo** cornice del profilo), `--hud-gold`, `--hud-glass` rgba(23,26,28,.64) + `--hud-blur` 74px,
`--hud-font` Chakra Petch, `--hud-mono` JetBrains Mono, `--hud-stencil` Big Shoulders Stencil, distanze `--hud-s1`…`--hud-s8` (8-64),
`--hud-ctl` 48, `--hud-ease` (.23,1,.32,1), `--hud-t-press` 120, `--hud-t-color` 180, `--hud-t-shape` 260.
Guscio: `--g-menu-w`, `--g-edge`, `--g-x`, `--g-y`.

## Classi per le pagine

| Classe | Cosa è |
|---|---|
| `.g-page` | area della pagina; al cambio pagina entra solo lei (sale di 12 px e compare in 260 ms), menu e barra in alto restano fermi |
| `.g-head` `.g-head__copy` `.g-kicker` `.g-title` `.g-desc` `.g-index` | titolo di pagina: occhiello 13, nome a stampino 88, riga 17, indice in cifre |
| `.g-card` | riquadro: linea sottile, angoli dritti, niente vetro |
| `.g-btn` (`--icon`, `--quiet`) | pulsante a linea alto 48 (passaggio, pressione .97, spento) |
| `.hud-btn-primary` + `.hud-btn__lbl` + `.hud-spin`, stato `.is-wait` | l'unico momento speciale (rosso, spigoli tagliati, staffe); id `go` per il controllo |
| `.hud-input`, `.g-search` (lente dentro) | campo alto 48, un solo bordo bianco quando è selezionato |
| `.g-tabs` + `<button><span>…</span></button>` + `.g-tabs__bar` | schede con la linea da 100 px che scorre; si attivano con `Guscio.tabs(el, onChange)` |
| `.hud-label`, `.g-num` / `.hud-num`, `.g-empty`, `.g-err` | etichetta 13 maiuscola, cifre mono, stato vuoto, errore calmo su una riga |
| `.g-skel` | blocco di caricamento fermo (solo un respiro lento) |
| `.g-pop` + `.is-open` | pannello di vetro che galleggia (es. popover); uno solo alla volta, mai sopra un altro vetro |
| `.rz` + `.rz-edge` (o `.rz-edge-b`), `.rz-free` | passaggio del mouse sulle carte stile Razer (hover.css): `.rz` riceve mouse e fuoco, `.rz-edge` è il bordo che si illumina; variabili e uso in DESIGN.md |

## `window.Guscio`

- `Guscio.tool(etichetta, [[testo, valore], …], onPick, iniziale)`: aggiunge un gruppo alla barra di prova.
- `Guscio.tabs(el, (valore, bottone) => …)`, `Guscio.placeTabs(el)`: schede con la linea.
- `Guscio.go(route)`: cambio pagina con la transizione (stessa strada del menu).
- `Guscio.openSurface('chat'|'notifiche')`, `Guscio.closeSurface()`; evento `guscio:surface` sullo stage.
- `Guscio.data`: dati della sessione; si cambiano con `window.GUSCIO_DATI = {…}` prima di includere `guscio.js`
  (`venue`, `name`, `group`, `level`, `xp`, `xpNext`, `progression`, `remaining`, `session`, `credit`, `rate`,
  `chatCount`, `tournaments` (false = niente Eventi e tornei/Eventi live)).
- `Guscio.esc(testo)`, `Guscio.h(html)`: piccoli aiuti.
- **Esc**: la pagina ascolta su `document` e chiama `preventDefault()` quando chiude qualcosa suo; il guscio (su `window`) chiude poi i pannelli solo se nessuno l'ha già usato.

## Interazioni del guscio

Cambio pagina dal menu (31/10: subito, menu, filo d'oro e barra fermi, l'indicatore scivola sulla voce nuova, il contenuto entra in 260 ms; DESIGN.md «Cambio pagina»);
passaggio e pressione su voci, riquadro del profilo (clic, tasto; Esc e clic fuori lo chiudono), pulsanti;
Bacheca (31/10, al posto dell'altoparlante: notizie che scorrono, Partner e social fermi in fondo; bacheca.js), Chat e Notifiche si aprono e si chiudono (stesso pulsante, ← Indietro, Esc);
orologi che scorrono. Barra di prova: Notifiche (esempio, nessuna, errore, caricamento), Tempo (normale, in esaurimento),
Eventi live (punto acceso), Livello (pronto, caricamento, massimo).

## Foto

`node guscio/foto.mjs <pagina> [passi]` dalla cartella `pagine/` (Edge): senza passi fa `foto.png` 2560x1440, `foto/zoom.png` 1280x720 e
`foto/zoom-125.png` (1366x768 con zoom 125%). Passi: `profilo`, `chat`, `chat-msg`, `notifiche`, `notifiche-vuote`,
`cambio`, oppure `nome@tool=Gruppo/Etichetta+click=selettore+hover=selettore+fill=selettore|testo+wait=ms`.

## Stato vuoto (VUOTO-ELX01, 04/11): senza Elx, un disegno per sezione

window.ElxVuoto({ disegno, titolo, testo, azione, compatto }) (alias Guscio.vuoto): un solo componente per sessione, barra e prelogin.
disegno = chiave di vuoto-disegni.js (games, apps, backpack, passes, cart, shop, rewards, missions, cards, promotions, events, tournaments, live,
community, friends, chat, notifications, orders, search, centers, stickers, nickname, activity, wallet, favorites, websites, board, generic): tratto 1,5 px tondo
non scalato, un solo colore tenue, macchia morbida, riga d'ombra, 3 scintille uguali per tutti, nessuna animazione. PESO OTTICO UGUALE: ogni oggetto e' portato
(tabella NORM, generata da CODEX/DEMO-VUOTO/misure/normalizza.mjs dal getBBox del tratto) a radice(larghezza x altezza) = 54, lato massimo 64, centro 80,78 nella scatola 160.
Ogni chiamante passa il disegno della SUA sezione e un titolo/riga specifici (cosa manca; cosa fare solo se il giocatore puo' farlo).
Misure e posizione solo in vuoto.css: sezione dentro una pagina o un pannello = disegno 72, altezza 112, spazio 16, bordo sinistro sul titolo della sezione,
16 sotto il titolo (o sotto l'inizio dell'area se non ha titolo); pagina intera vuota (.g-vuoto--pagina) = disegno 160 con lo stesso centro in ogni pagina.
REGOLA (Owner 04/11): pagina con PIU' sezioni (Premi, Zaino, Profilo, Shop con solo il carrello vuoto) = un blocco compatto per sezione, mai la pagina intera; pagina con UNA lista (Home, Giochi, Tutte le app, Promozioni, Eventi, Tornei, Live, Shop a catalogo vuoto, Community senza sticker e tornei) = lista vuota = blocco pagina.
La pagina a lista vuota NON disegna i suoi comandi (filtri, ricerca, schede, carrello, «+»): vuoto.js (ElxVuoto.pagina; PAGINE in demo ?vuoto=1; Home, Shop e Community la chiamano da sé) li toglie dal documento, mai display:none sopra.
Posizione del blocco pagina: solo vuoto.css, da --g-y-pag (schermo.css) e --g-y della cornice, quindi nota al primo disegno; il blocco entra nel documento prima che il guscio scopra la pagina (DOMContentLoaded), mai dopo un misura o un caricamento.
Controllo: node CODEX/DEMO-VUOTO/misure.mjs (tabella di ogni blocco, exit 1 a ogni differenza).
