@homie-rocks/studio 0.24.5 → 0.26.0

package/starters/hero-rush-3d/style.json

@@ -0,0 +1,68 @@
+{
+  "v": 1,
+  "palette": {
+    "bg": "#cfe6f2",
+    "ink": "#1e2a38",
+    "accent": "#e8833a",
+    "accent2": "#4fa36a",
+    "danger": "#d9483b",
+    "good": "#5bb36a",
+    "gold": "#fdbf41",
+    "ramp": [
+      "#9fcfe6",
+      "#cfe6f2",
+      "#f6f1e4",
+      "#7cc46a",
+      "#4fa36a",
+      "#2f7a52",
+      "#007650",
+      "#fdbf41",
+      "#f68537",
+      "#e8833a",
+      "#9f5e48",
+      "#6b4a3a",
+      "#99a6ab",
+      "#a63c49",
+      "#3d395c",
+      "#ffffff"
+    ]
+  },
+  "fonts": {
+    "display": "Lilita One",
+    "body": "Nunito"
+  },
+  "light": {
+    "time": "morning",
+    "key": [
+      -0.5,
+      -1,
+      -0.35
+    ],
+    "intensity": 2.3,
+    "hardness": 0.4,
+    "sky": "#dcedf5",
+    "ground": "#86c47c",
+    "fog": 0.3,
+    "bloom": 0.1
+  },
+  "camera": {
+    "angle": "low-3/4",
+    "projection": "perspective",
+    "pitch": 38,
+    "distance": 13,
+    "fov": 42
+  },
+  "render": "painted",
+  "materials": {
+    "model": "hand-painted",
+    "outline": false,
+    "texelDensity": 256,
+    "atlas": false
+  },
+  "rev": {
+    "style.palette": 1,
+    "style.ui": 1,
+    "style.light": 1,
+    "style.camera": 1
+  }
+}

package/starters/hero-rush-3d/tunables.json

@@ -0,0 +1,32 @@
+{
+  "windupMs": { "value": 240, "min": 0, "max": 500, "step": 10, "unit": "ms", "group": "Swing", "note": "From the press to the moment the swing lands: the anticipation everyone sees coming" },
+  "swingSkip": { "value": 0.15, "min": 0, "max": 0.5, "step": 0.01, "group": "Swing", "note": "How much of the swing clip's own wind-up the hero skips (the windup above is what players wait for)" },
+  "swingRestMs": { "value": 260, "min": 0, "max": 900, "step": 10, "unit": "ms", "group": "Swing", "note": "How long after a swing lands before the next can start" },
+  "knockRange": { "value": 2.1, "min": 1.2, "max": 4, "step": 0.02, "unit": "m", "group": "Swing", "note": "How far a swing reaches" },
+  "swingArc": { "value": 200, "min": 60, "max": 360, "step": 5, "unit": "deg", "group": "Swing", "note": "How wide the swing sweeps in front of the hero" },
+  "hitStopMs": { "value": 70, "min": 0, "max": 200, "step": 5, "unit": "ms", "group": "Swing", "note": "The hit lands: the struck hero holds, flashes and flinches before it flies" },
+  "knockDistance": { "value": 3.4, "min": 0.8, "max": 8, "step": 0.1, "unit": "m", "group": "Swing", "note": "How far a hit sends a hero, the same at any frame rate" },
+  "knockMs": { "value": 420, "min": 120, "max": 1000, "step": 10, "unit": "ms", "group": "Swing", "note": "How long the slide takes" },
+  "knockEase": { "value": 4, "min": 1, "max": 6, "step": 0.1, "group": "Swing", "note": "1 slides at one speed; higher leaves faster and eases into the stop" },
+  "squash": { "value": 0.3, "min": 0, "max": 0.8, "step": 0.01, "group": "Swing", "note": "How much a flying hero stretches along the hit, and squashes when it stops" },
+  "settleMs": { "value": 260, "min": 0, "max": 700, "step": 10, "unit": "ms", "group": "Swing", "note": "The wobble after the stop (overlap)" },
+  "flashMs": { "value": 110, "min": 0, "max": 300, "step": 5, "unit": "ms", "group": "Swing", "note": "How long the struck hero flashes white" },
+  "shake": { "value": 0.16, "min": 0, "max": 0.6, "step": 0.01, "unit": "m", "group": "Swing", "note": "The camera's kick when you hit or are hit" },
+  "sparks": { "value": 9, "min": 0, "max": 24, "step": 1, "group": "Swing", "note": "Sparks thrown off the hit" },
+  "ringMs": { "value": 520, "min": 150, "max": 2000, "step": 10, "unit": "ms", "group": "Swing", "note": "How long a slash and a hit's ring last" },
+  "jumpHeight": { "value": 1.05, "min": 0.3, "max": 2.5, "step": 0.05, "unit": "m", "group": "Jump", "note": "How high a jump goes (above 0.3 m a swing passes under)" },
+  "jumpRise": { "value": 0.3, "min": 0.12, "max": 0.8, "step": 0.01, "unit": "s", "group": "Jump", "note": "How long it takes to reach the top" },
+  "fallFaster": { "value": 2.1, "min": 1, "max": 3.5, "step": 0.05, "group": "Jump", "note": "Down this much harder than up: higher feels heavier, snappier" },
+  "fade": { "value": 0.14, "min": 0, "max": 0.6, "step": 0.01, "unit": "s", "group": "Motion", "note": "How long one clip takes to blend into the next" },
+  "walkSpeed": { "value": 1.7, "min": 0.3, "max": 6, "step": 0.05, "unit": "m/s", "group": "Motion", "note": "The ground speed the walk clip's feet move at (feet slide when this is wrong)" },
+  "runSpeed": { "value": 4.6, "min": 1, "max": 12, "step": 0.05, "unit": "m/s", "group": "Motion", "note": "The ground speed the run clip's feet move at" },
+  "runFrom": { "value": 2.6, "min": 0.5, "max": 8, "step": 0.05, "unit": "m/s", "group": "Motion", "note": "From this speed up, the walk becomes a run" },
+  "actSpeed": { "value": 1.9, "min": 0.5, "max": 3, "step": 0.05, "group": "Motion", "note": "How fast the swing plays: higher is snappier" },
+  "jumpStretch": { "value": 0.22, "min": 0, "max": 0.5, "step": 0.01, "group": "Motion", "note": "How tall and thin a hero goes as it leaves the ground" },
+  "landSquash": { "value": 0.28, "min": 0, "max": 0.6, "step": 0.01, "group": "Motion", "note": "How flat it goes when it lands" },
+  "squashHz": { "value": 5.5, "min": 1, "max": 14, "step": 0.1, "unit": "Hz", "group": "Motion", "note": "How fast the squash springs back (lower wobbles longer)" },
+  "lean": { "value": 0.22, "min": 0, "max": 0.8, "step": 0.01, "group": "Motion", "note": "How far a hero banks into a turn and tips into a sprint" },
+  "flinch": { "value": 0.6, "min": 0, "max": 1.5, "step": 0.05, "group": "Motion", "note": "How strongly a hit jolts the upper body" },
+  "lookAt": { "value": 0.7, "min": 0, "max": 1, "step": 0.05, "group": "Motion", "note": "How much the head turns toward what it looks at" },
+  "spring": { "value": 0.5, "min": 0, "max": 1, "step": 0.05, "group": "Motion", "note": "How loose tails, ears and capes are (0 stiff, 1 floppy)" }
+}

package/worker/arrival.mjs

@@ -0,0 +1,207 @@
+/**
+ * THE ARRIVAL (0.26.0): the play page and the big screen never open on a blank screen. From the page's first paint
+ * until the game says it is playable, an arrival card covers the game's frame in the game's own look: its title and
+ * its pitch, its key art (the landing's hero still, a trailer's poster, or its cover) drifting slowly, a progress line
+ * that says what is happening (finding a room, Room 4 · 3 playing · 2 AI, loading the game, the game's own "loading
+ * the heroes 60%"), and the controls for this device. Then it fades and the game has the screen.
+ *
+ * Colours: the game's own palette first (games.json `ui`, from its style.json: paper, ink, accent), else its
+ * landing's (`landing.theme`, `landing.scheme`), else the studio's look. Words: game.json `landing.pitch` (else the
+ * blurb's first sentence) and `landing.controls` (phone, computer, tv). Nothing here is invented.
+ *
+ * When it lifts (NETPLAY.md section 21): at the helper's `playable` message: the game's own `net.playable()` for a
+ * game made with `arrival: 'game'`, else the helper's (seated, and the room's state in, two frames later). A game built
+ * with an older helper lifts it once it has a seat; a frame with no helper at all, 8 s after it loaded. Whatever
+ * happens it lifts 15 s after the helper attached and 30 s after the page opened, so a game is never hidden behind it.
+ * `?arrive=0` leaves it out (a test that wants the bare frame).
+ *
+ * The page's `window.__shell.arrival` says where it is ({ phase, step, p, lookMs, liftedMs, by, mode }), and the page
+ * marks `homie:look` (the card's first frame) and `homie:playable` (lifted) for `homie-studio perf`.
+ */
+import { esc } from './site.mjs';
+
+const CSS_COLOUR = /^(#[0-9a-f]{3,8}|(?:rgb|rgba|hsl|hsla|oklch|oklab|lab|lch)\([0-9a-z.,%\s/+-]{1,80}\))$/i;
+const colour = (v) => (CSS_COLOUR.test(String(v ?? '')) ? String(v) : null);
+const hex6 = (v) => /^#[0-9a-f]{6}$/i.test(String(v ?? ''));
+const SITE_PATH = /^\/[A-Za-z0-9._~%/-]{1,300}$/;
+const sitePath = (v) => (SITE_PATH.test(String(v ?? '')) && !String(v).includes('..') ? String(v) : null);
+const FOCUS = /^\d{1,3}% \d{1,3}%$/;
+
+/** The scheme words a landing uses (worker/site.mjs SCHEME_TOKENS), for a landing that sets `scheme` but no colours. */
+const SCHEME = { light: { bg: '#f7f6f1', fg: '#15161d' }, dark: { bg: '#0b0c12', fg: '#f1f3f9' } };
+
+/** The card's colours: the game's palette, else its landing's, else the studio's. */
+export function arrivalColours(cat, g) {
+  const t = cat?.studio?.theme ?? {};
+  const L = g?.landing ?? {};
+  const ui = hex6(g?.ui?.paper) && hex6(g?.ui?.text) ? g.ui : null;
+  if (ui) return { bg: ui.paper, fg: ui.text, hot: colour(ui.hot) ?? colour(L.theme?.accent) ?? colour(t.accent) ?? '#ffcf5a', from: 'game' };
+  const scheme = L.scheme === 'light' || L.scheme === 'dark' ? SCHEME[L.scheme] : null;
+  return {
+    bg: colour(L.theme?.bg) ?? scheme?.bg ?? colour(t.bg) ?? SCHEME.dark.bg,
+    fg: colour(L.theme?.fg) ?? scheme?.fg ?? colour(t.fg) ?? SCHEME.dark.fg,
+    hot: colour(L.theme?.accent) ?? colour(t.accent) ?? '#ffcf5a',
+    from: L.theme || scheme ? 'landing' : 'studio',
+  };
+}
+
+/** The first sentence of a blurb, at most `max` characters. */
+const firstSentence = (s, max = 140) => {
+  const one = String(s ?? '').split(/(?<=[.!?])\s/)[0] ?? '';
+  return one.length > max ? `${one.slice(0, max - 1).trimEnd()}…` : one;
+};
+
+/**
+ * The arrival card for a game's play page (`screen`: the big screen): its markup, its CSS, and what its script needs.
+ * `{ html, css }`; empty strings with `off`.
+ */
+export function arrivalCard(cat, g, { screen = false, off = false } = {}) {
+  if (off) return { html: '', css: '' };
+  const L = g?.landing ?? {};
+  const h = L.hero ?? {};
+  const c = arrivalColours(cat, g);
+  const wide = sitePath(h.wideImage) ?? sitePath(L.cover) ?? (g?.cover ? sitePath(`/games/${g.id}/${g.cover}`) : null);
+  const tall = sitePath(h.tallImage);
+  const focus = FOCUS.test(String(h.focus ?? '')) ? h.focus : '50% 45%';
+  const pitch = String(L.pitch ?? '').trim() || firstSentence(g?.blurb);
+  const studio = cat?.studio?.name ?? '';
+  const keys = screen
+    ? [['tv', L.controls?.tv ?? 'Phones are the controllers: scan the code to play.']]
+    : [['phone', L.controls?.phone], ['desk', L.controls?.computer]].filter(([, v]) => v);
+  const art = wide || tall
+    ? `<picture class="arrive-art">${wide && tall ? `<source media="(min-aspect-ratio: 3/4)" srcset="${esc(wide)}">` : ''}<img src="${esc(tall ?? wide)}" alt="" decoding="async" fetchpriority="high" style="object-position:${esc(focus)}"></picture>`
+    : '<div class="arrive-art bare" aria-hidden="true"></div>';
+  const html = `<div class="arrive${screen ? ' big' : ''}" data-arrive data-from="${esc(c.from)}">
+  ${art}<div class="arrive-shade" aria-hidden="true"></div>
+  <div class="arrive-in">
+    ${studio ? `<p class="arrive-kicker">${esc(studio)}</p>` : ''}
+    <h1 class="arrive-title">${esc(g?.name ?? '')}</h1>
+    ${pitch ? `<p class="arrive-pitch">${esc(pitch)}</p>` : ''}
+    <div class="arrive-meter" aria-hidden="true"><i data-arrive-bar></i></div>
+    <p class="arrive-step" role="status" aria-live="polite"><span data-arrive-step>Finding a room…</span><span class="arrive-room" data-arrive-room></span></p>
+    ${keys.map(([k, v]) => `<p class="arrive-keys" data-for="${k}">${esc(String(v).slice(0, 160))}</p>`).join('')}
+  </div>
+</div>`;
+  const css = `.arrive { --a-bg: ${c.bg}; --a-fg: ${c.fg}; --a-hot: ${c.hot}; position: fixed; inset: 0; z-index: 3; overflow: hidden; background: var(--a-bg); color: var(--a-fg); font: 15px/1.4 ui-rounded, "SF Pro Rounded", ui-sans-serif, system-ui, -apple-system, "Segoe UI", Roboto, sans-serif; pointer-events: none; transition: opacity .3s ease, visibility 0s linear .3s; }
+.arrive.lift { opacity: 0; visibility: hidden; }
+.arrive.lift .arrive-art { opacity: 0; transition: opacity .15s ease; }
+.arrive-art { position: absolute; inset: 0; display: block; }
+.arrive-art img { width: 100%; height: 100%; object-fit: cover; display: block; animation: arrive-drift 14s ease-out both; }
+.arrive-art.bare { background: radial-gradient(120% 80% at 50% 18%, color-mix(in srgb, var(--a-hot) 30%, var(--a-bg)) 0%, var(--a-bg) 62%), var(--a-bg); }
+.arrive-art.bare::after { content: ""; position: absolute; inset: -20%; background: repeating-linear-gradient(135deg, color-mix(in srgb, var(--a-fg) 4%, transparent) 0 2px, transparent 2px 22px); animation: arrive-slide 9s linear infinite; }
+.arrive-shade { position: absolute; inset: 0; background: linear-gradient(180deg, color-mix(in srgb, var(--a-bg) 92%, transparent) 0%, color-mix(in srgb, var(--a-bg) 60%, transparent) 8%, transparent 20%, transparent 44%, color-mix(in srgb, var(--a-bg) 55%, transparent) 62%, color-mix(in srgb, var(--a-bg) 92%, transparent) 80%, var(--a-bg) 100%); }
+.arrive-in { position: absolute; left: 0; right: 0; bottom: 0; box-sizing: border-box; padding: 0 max(20px, env(safe-area-inset-left)) max(calc(28px + 6vh), env(safe-area-inset-bottom)); display: flex; flex-direction: column; align-items: center; text-align: center; gap: 10px; animation: arrive-rise .35s ease-out both; }
+.arrive-kicker { margin: 0; font-size: 12px; font-weight: 800; letter-spacing: .14em; text-transform: uppercase; color: color-mix(in srgb, var(--a-fg) 70%, transparent); }
+.arrive-title { margin: 0; max-width: 16ch; font-size: clamp(40px, 9vmin, 96px); line-height: .95; font-weight: 900; letter-spacing: -.02em; color: var(--a-fg); text-wrap: balance; text-shadow: 0 2px 24px color-mix(in srgb, var(--a-bg) 70%, transparent); }
+.arrive-pitch { margin: 0; max-width: 34ch; font-size: clamp(15px, 2.3vmin, 21px); font-weight: 600; color: color-mix(in srgb, var(--a-fg) 86%, transparent); text-wrap: balance; }
+.arrive-meter { width: min(300px, 70vw); height: 6px; margin-top: 8px; border-radius: 999px; background: color-mix(in srgb, var(--a-fg) 16%, transparent); overflow: hidden; }
+.arrive-meter i { display: block; width: 6%; height: 100%; border-radius: inherit; background: var(--a-hot); transition: width .5s ease; }
+.arrive-step { margin: 0; min-height: 2.8em; font-size: 14px; font-weight: 700; color: color-mix(in srgb, var(--a-fg) 88%, transparent); font-variant-numeric: tabular-nums; }
+.arrive-room { display: block; margin-top: 2px; font-size: 12.5px; font-weight: 600; color: color-mix(in srgb, var(--a-fg) 66%, transparent); }
+.arrive-keys { display: none; margin: 4px 0 0; padding: 7px 14px; border-radius: 999px; max-width: min(520px, 92vw); font-size: 13.5px; font-weight: 700; background: color-mix(in srgb, var(--a-fg) 9%, transparent); border: 1px solid color-mix(in srgb, var(--a-fg) 14%, transparent); }
+.arrive-keys[data-for="desk"], .arrive-keys[data-for="tv"] { display: block; }
+@media (max-width: 540px), (max-height: 540px) { .arrive-keys[data-for="desk"] { display: none; } .arrive-keys[data-for="phone"] { display: block; } }
+.arrive.big .arrive-title { font-size: clamp(56px, 11vmin, 150px); }
+.arrive.big .arrive-pitch { font-size: clamp(20px, 2.8vmin, 34px); }
+.arrive.big .arrive-step, .arrive.big .arrive-keys { font-size: clamp(16px, 2vmin, 26px); }
+.arrive.big .arrive-room { font-size: clamp(14px, 1.7vmin, 22px); }
+@media (min-aspect-ratio: 4/3) and (min-width: 720px) { .arrive-in { padding-bottom: max(calc(36px + 8vh), env(safe-area-inset-bottom)); } }
+@keyframes arrive-drift { from { transform: scale(1.08); } to { transform: scale(1); } }
+@keyframes arrive-slide { from { transform: translateX(0); } to { transform: translateX(31px); } }
+@keyframes arrive-rise { from { transform: translateY(10px); } }
+@media (prefers-reduced-motion: reduce) { .arrive-art img, .arrive-art.bare::after, .arrive-in { animation: none; } .arrive { transition: none; } }
+/* While the card is up it says the room's facts itself; the chip shows them once the game has the screen. */
+.chip.held { opacity: 0; }
+`;
+  return { html, css };
+}
+
+/**
+ * The card's script: runs before the shell's (worker/pages.mjs SHELL_JS), which calls `window.__homieArrival`:
+ * `room(label)`, `facts(text)`, `full(text)`, `loadingGame()`, `message(m)` (the helper's postMessage), `lift(by)`, and
+ * reads `done`. Without the card (`?arrive=0`, or no card) it is a no-op object whose `done` is true.
+ */
+export const ARRIVAL_JS = String.raw`(function () {
+  'use strict';
+  var el = document.querySelector('[data-arrive]');
+  var off = new URLSearchParams(location.search).get('arrive') === '0';
+  if (el && off) { el.remove(); el = null; }
+  var api = { done: !el, room: noop, facts: noop, full: noop, loadingGame: noop, message: noop, lift: noop, frameLoaded: noop };
+  function noop() {}
+  window.__homieArrival = api;
+  if (!el) return;
+  var now = function () { return typeof performance !== 'undefined' && performance.now ? performance.now() : Date.now(); };
+  var mark = function (name) { try { performance.mark(name); } catch (e) {} };
+  var frame = typeof requestAnimationFrame === 'function' ? requestAnimationFrame : function (fn) { return setTimeout(fn, 16); };
+  var stepEl = el.querySelector('[data-arrive-step]');
+  var roomEl = el.querySelector('[data-arrive-room]');
+  var bar = el.querySelector('[data-arrive-bar]');
+  var a = { phase: 'room', step: stepEl.textContent, p: 0.06, lookMs: null, liftedMs: null, by: null, mode: null };
+  api.state = a;
+  // The card's first frame on the screen: what perf reads as the time to the first meaningful frame.
+  frame(function () { frame(function () { a.lookMs = Math.round(now()); mark('homie:look'); }); });
+  // Each phase's ceiling: between the real steps the bar creeps toward it (never past it), so a wait never looks stuck.
+  var CEIL = { room: 0.18, game: 0.33, wait: 0.33, join: 0.47, world: 0.95 };
+  var stopCreep = function () {};
+  if (typeof setInterval === 'function') {
+    var creep = setInterval(function () {
+      if (api.done) { stopCreep(); return; }
+      var top = CEIL[a.phase] || 0.95;
+      if (a.p < top) { a.p = Math.min(top, a.p + (top - a.p) * 0.04 + 0.002); bar.style.width = Math.round(a.p * 100) + '%'; }
+    }, 150);
+    stopCreep = function () { clearInterval(creep); };
+  }
+  function set(phase, step, p) {
+    if (api.done) return;
+    a.phase = phase;
+    if (step && step !== a.step) { a.step = step; stepEl.textContent = step; }
+    if (typeof p === 'number' && p > a.p) { a.p = Math.min(0.98, p); bar.style.width = Math.round(a.p * 100) + '%'; }
+  }
+  bar.style.width = Math.round(a.p * 100) + '%';
+  var timers = [];
+  function later(ms, why) { timers.push(setTimeout(function () { api.lift(why); }, ms)); }
+  // Whatever happens, the game gets the screen within 30 s of the page opening.
+  later(30000, 'timeout');
+  var roomLabel = '';
+  // A full server's wait ("you're next for a seat") stays said while its room loads.
+  api.room = function (label) { roomLabel = label || ''; if (a.phase === 'wait') set('wait', a.step, 0.22); else set('game', 'Loading the game…', 0.22); if (!roomEl.textContent) roomEl.textContent = roomLabel; };
+  api.facts = function (text) { if (!api.done && text) roomEl.textContent = text; };
+  api.full = function (text) { set('wait', text, 0.3); };
+  var attachedAt = 0;
+  var seatedTimer = null;
+  api.frameLoaded = function () {
+    // A frame with no netplay helper never says anything: 8 s after it loaded, it has the screen.
+    if (!attachedAt) later(8000, 'no-helper');
+  };
+  api.message = function (m) {
+    if (api.done || !m) return;
+    if (m.what === 'attached') {
+      attachedAt = Date.now();
+      a.mode = m.arrival === 'game' || m.arrival === 'auto' ? m.arrival : 'seat';
+      set('join', 'Joining ' + (roomLabel || 'the room') + '…', 0.36);
+      later(15000, 'cap');
+    } else if (m.what === 'role' || m.what === 'token') {
+      set('world', 'Loading the world…', 0.5);
+      // A game built with a helper older than the arrival says nothing more: it has the screen once it has a seat.
+      if (a.mode === 'seat' && !seatedTimer) seatedTimer = setTimeout(function () { api.lift('seated'); }, 600);
+    } else if (m.what === 'loading') {
+      var p = Math.max(0, Math.min(1, Number(m.p) || 0));
+      var what = typeof m.label === 'string' && m.label ? m.label : 'the world';
+      set('world', 'Loading ' + what + '… ' + Math.round(p * 100) + '%', 0.5 + 0.46 * p);
+    } else if (m.what === 'playable') {
+      api.lift(m.by === 'game' ? 'game' : 'auto');
+    }
+  };
+  api.lift = function (by) {
+    if (api.done) return;
+    api.done = true;
+    a.phase = 'done'; a.by = by || 'shell'; a.p = 1; a.liftedMs = Math.round(now());
+    mark('homie:playable');
+    timers.forEach(clearTimeout); clearTimeout(seatedTimer); stopCreep();
+    bar.style.width = '100%';
+    stepEl.textContent = 'Ready';
+    el.classList.add('lift');
+    setTimeout(function () { el.hidden = true; }, 450);
+    try { window.dispatchEvent(new CustomEvent('homie-arrived', { detail: { by: a.by } })); } catch (e) {}
+  };
+}());`;

package/worker/pages.mjs

@@ -9,6 +9,7 @@ import { KIDS_LINE, POLICY_WORDS } from './servers.mjs';
 import { SAVES_SHELL_CSS, SAVES_SHELL_JS } from './saves-shell.mjs';
 import { CHAT_CSS, CHAT_JS, CHAT_OWNER_JS, chatBoot } from './chat-page.mjs';
 import { SHOP_SHELL_CSS, SHOP_SHELL_JS } from './shop-page.mjs';
+import { ARRIVAL_JS, arrivalCard } from './arrival.mjs';
 
 export { homePage, mediaIndexPage, notFoundPage, songPage, videoPage } from './site.mjs';
 
@@ -96,6 +97,8 @@ export function playPage(cat, g, { screen = false, joinUrl = null, qr = null, lo
   const okHex = (v) => /^#[0-9a-f]{6}$/i.test(String(v ?? ''));
   const ui = okHex(g.ui?.paper) && okHex(g.ui?.text) ? g.ui : null;
   const pillUi = ui ? `\n.pill, .chip, .pill.dim { background: ${ui.paper}e6; color: ${ui.text}; border-color: ${ui.text}22; }\n.pill svg { color: ${ui.text}; }` : '';
+  // The arrival card (worker/arrival.mjs): the game's own look until the game says it is playable, never a blank screen.
+  const arrive = arrivalCard(cat, g, { screen });
   const css = `:root{--hot:${/^#[0-9a-f]{3,8}$/i.test(accent) ? accent : '#ffcf5a'}}
 html, body { height: 100%; margin: 0; overflow: hidden; overscroll-behavior: none; background: #04060c; touch-action: none; -webkit-user-select: none; user-select: none; -webkit-touch-callout: none; -webkit-tap-highlight-color: transparent; }
 iframe.game { position: fixed; inset: 0; width: 100%; height: 100%; border: 0; display: block; background: #04060c; touch-action: none; }
@@ -161,7 +164,7 @@ iframe.game { position: fixed; inset: 0; width: 100%; height: 100%; border: 0; d
 .notice .acts a { display: inline-flex; align-items: center; min-height: 44px; padding: 0 16px; border-radius: 12px; text-decoration: none; font-weight: 700; color: #eef1f8; border: 1px solid rgba(255,255,255,.18); }
 .notice .acts a.primary { background: var(--hot); color: #0b0b10; border-color: transparent; }
 [hidden] { display: none !important; }
-${SERVER_CSS}${CHAT_CSS}${g.saves && !screen ? SAVES_SHELL_CSS : ''}${shop ? SHOP_SHELL_CSS : ''}${pillUi}`;
+${arrive.css}${SERVER_CSS}${CHAT_CSS}${g.saves && !screen ? SAVES_SHELL_CSS : ''}${shop ? SHOP_SHELL_CSS : ''}${pillUi}`;
   // The room button's place on each device (sharePlaces); the shell moves it to this browser's once it knows the device.
   // A ticket (a game that is not public) and the owner's overlay ride along only for the browser they are for.
   // The server this page plays on (0.16.0): its pool (the Lobby), its badge and line for the chip, its ceiling.
@@ -198,7 +201,8 @@ ${SERVER_CSS}${CHAT_CSS}${g.saves && !screen ? SAVES_SHELL_CSS : ''}${shop ? SHO
 <div class="toast" data-toast role="status" hidden></div>`;
   return layoutless(`${g.name} · play`, `
 <iframe class="game" title="${esc(g.name)}" sandbox="allow-scripts allow-pointer-lock allow-forms allow-modals allow-popups" allow="fullscreen *; autoplay *; gamepad *"></iframe>
-<div class="chip" data-chip><span data-status>finding a room…</span></div>
+${arrive.html}
+<div class="chip${arrive.html ? ' held' : ''}" data-chip><span data-status>finding a room…</span></div>
 <div class="vote" data-vote role="dialog" aria-label="How strong should the AI be?" data-keep-focus hidden></div>
 <div class="card" data-results hidden></div>
 <div class="card" data-screen hidden></div>
@@ -206,6 +210,7 @@ ${joinCard}${share}
 <script>window.__HOMIE_PLAY=${JSON.stringify(boot).replace(/</g, '\\u003c')};</script>
 <script>window.__HOMIE_CHAT=${JSON.stringify(chatBoot(g, { surface: screen ? 'tv' : 'play', owner, acct, member })).replace(/</g, '\\u003c')};</script>
 <script>${CHAT_JS}</script>
+<script>${ARRIVAL_JS}</script>
 <script>${SHELL_JS}</script>${g.saves && !screen ? `
 <script>${SAVES_SHELL_JS}</script>` : ''}${shop ? `
 <script>${SHOP_SHELL_JS}</script>` : ''}${owner ? `<style>${OWNER_CSS}</style><script>${OWNER_JS}</script><script>${CHAT_OWNER_JS}</script>` : ''}`, css, frameAncestors(cat));
@@ -289,6 +294,9 @@ const SHELL_JS = String.raw`(function () {
   var screenCard = document.querySelector('[data-screen]');
   var state = { game: boot.game, room: null, device: device, want: want, attached: false, stats: null, round: null, roster: null, facts: null, seat: null, results: [], closed: null, link: null, notice: null, banner: null, muted: null, server: boot.server || null, vote: null, myVote: {}, quietAi: false, full: false };
   window.__shell = state;
+  // The arrival card (worker/arrival.mjs): the game's look while the room connects and the game loads.
+  var A = window.__homieArrival || { done: true, room: function () {}, facts: function () {}, full: function () {}, message: function () {}, lift: function () {}, frameLoaded: function () {} };
+  state.arrival = A.state || null;
   // This browser's room key: random, kept in this site's own storage, and sent only to this site's rooms. It is what
   // an owner's kick holds out of a room for a while (section 15); it says nothing about who the player is.
   function rnd() {
@@ -302,8 +310,11 @@ const SHELL_JS = String.raw`(function () {
   var chip = document.querySelector('[data-chip]');
   var quietTimer = null;
   function say(text) {
-    if (statusEl.textContent === text) return;
+    // While the arrival card is up it says this itself; the chip waits for the game to have the screen.
+    if (!A.done) { statusEl.textContent = text; return; }
+    if (statusEl.textContent === text && !chip.classList.contains('held')) return;
     statusEl.textContent = text;
+    chip.classList.remove('held');
     chip.classList.remove('quiet');
     clearTimeout(quietTimer);
     quietTimer = setTimeout(function () { chip.classList.add('quiet'); }, 5000);
@@ -409,12 +420,14 @@ const SHELL_JS = String.raw`(function () {
     // The frame cannot read this page's address (it is an opaque origin): hand it the game's own switches.
     ['touchdebug', 'cam', 'view'].forEach(function (k) { var v = params.get(k); if (v && /^[A-Za-z0-9_-]{1,16}$/.test(v)) q.set(k, v); });
     frame.src = '/' + boot.game + '/__game/?' + q.toString();
-    frame.addEventListener('load', function () { try { frame.focus(); frame.contentWindow.focus(); } catch (e) {} });
+    A.room(labelOf(room));
+    frame.addEventListener('load', function () { A.frameLoaded(); try { frame.focus(); frame.contentWindow.focus(); } catch (e) {} });
     window.addEventListener('pointerdown', function (e) { if ((ui && ui.contains(e.target)) || (e.target.closest && e.target.closest('[data-keep-focus]'))) return; try { frame.focus(); } catch (e2) {} }, { passive: true });
     window.addEventListener('message', function (ev) {
       if (ev.source !== frame.contentWindow) return;
       var m = ev.data;
       if (!m || typeof m !== 'object' || m.t !== 'homie-net') return;
+      A.message(m);
       if (m.what === 'attached') state.attached = true;
       if (m.what === 'token' && typeof m.token === 'string') { state.seat = m.seat; try { sessionStorage.setItem(KEY, m.token); } catch (e) {} if (window.__homieChat) window.__homieChat.seat(); }
       if (m.what === 'stats') state.stats = m.stats;
@@ -517,6 +530,7 @@ const SHELL_JS = String.raw`(function () {
   // again), and the page says what happened, when they can come back, and where to play now.
   function notice(kind, m) {
     if (state.notice) return;
+    A.lift('notice');
     state.notice = { kind: kind, until: m && m.until ? m.until : null, message: m && m.message ? String(m.message) : '' };
     try { frame.src = 'about:blank'; } catch (e) {}
     if (state.watchSocket) { try { state.watchSocket.close(); } catch (e) {} }
@@ -552,6 +566,8 @@ const SHELL_JS = String.raw`(function () {
     if (f && f.counts && f.counts.watchers) bits.push(f.counts.watchers + ' watching');
     if (state.full) bits.push('waiting for a seat');
     if (state.closed) bits.push(state.closed === 'replaced' ? 'opened in another tab' : 'reconnecting');
+    // The arrival card's line: the room and who is in it ("Room 2 · 3 playing · 2 AI").
+    if (!A.done && state.room) A.facts([labelOf(state.room), n ? n + ' playing' : '', aiN ? aiN + ' AI' : ''].filter(Boolean).join(' · '));
     say(bits.join(' · ') || 'joining…');
     var count = ui && ui.querySelector('[data-room-count]');
     if (count && n !== null) count.textContent = n + (n === 1 ? ' player here' : ' players here') + (aiN ? ' · ' + aiN + ' AI' : '');
@@ -669,6 +685,8 @@ const SHELL_JS = String.raw`(function () {
   var lobbyQ = [];
   if (state.server) lobbyQ.push('server=' + encodeURIComponent(state.server.id));
   if (/^[A-Za-z0-9_,-]{1,140}$/.test(params.get('not') || '')) lobbyQ.push('not=' + encodeURIComponent(params.get('not')));
+  // Once the game has the screen, the chip says the room's facts for a few seconds, then gets out of the way.
+  window.addEventListener('homie-arrived', function () { paint(); });
   if (boot.room) start(boot.room);
   else if (askedRoom !== null && /^[A-Za-z0-9_-]{1,32}$/.test(askedRoom)) start(askedRoom);
   else if (askedRoom !== null) { say('that room link does not work'); }
@@ -676,7 +694,7 @@ const SHELL_JS = String.raw`(function () {
     .then(function (r) { return r.json(); })
     .then(function (j) {
       // Every room this server may have is full: the fullest one, watched until a seat frees (the relay seats it).
-      if (j.full) { state.full = true; flash((state.server ? state.server.name : 'This server') + ' is full. You\u2019re next for a seat.'); }
+      if (j.full) { state.full = true; flash((state.server ? state.server.name : 'This server') + ' is full. You\u2019re next for a seat.'); A.full((state.server ? state.server.name : 'This server') + ' is full: you\u2019re next for a seat…'); }
       start(j.room || 'main');
     })
     .catch(function () { start('main'); });

package/worker/site.mjs

@@ -143,6 +143,19 @@ img,video{display:block;max-width:100%}
 .also:hover{color:var(--fg)}
 .also+.also{margin-left:18px}
 @media (min-aspect-ratio:3/4){.hero-media picture.tall-only{display:none}}
+/* A landing in its game's own palette (0.26.0): the footage keeps its colour (a third of the tint), and the words sit
+   on a soft panel of the game's paper instead of a page-wide wash. */
+[data-look="game"] .hero-media::before{background:color-mix(in srgb,var(--bg) calc(var(--tint,16%) * .3),transparent)}
+[data-look="game"] .hero-media.drift::before{background:color-mix(in srgb,var(--bg) calc(var(--tint,40%) * .3),transparent)}
+[data-look="game"] .hero-shade{background:linear-gradient(to top,var(--bg) 0%,color-mix(in srgb,var(--bg) 70%,transparent) 14%,transparent 34%),
+  linear-gradient(to bottom,color-mix(in srgb,var(--bg) 94%,transparent) 0%,color-mix(in srgb,var(--bg) 70%,transparent) 9%,transparent 22%)}
+[data-look="game"] .hero-copy>*{position:relative}
+/* Footage captured from play carries the game's own HUD at its edges (a clock, a scoreboard): a little closer in. */
+[data-look="game"] .hero-media video,[data-look="game"] .hero-media:not(.drift) img{transform:scale(1.1);transform-origin:var(--focus,50% 50%)}
+[data-look="game"] .hero-copy::before{content:"";position:absolute;z-index:-1;left:0;right:0;bottom:0;height:min(64%,520px);pointer-events:none;
+  background:linear-gradient(to top,color-mix(in srgb,var(--bg) 96%,transparent) 0%,color-mix(in srgb,var(--bg) 86%,transparent) 55%,transparent 100%)}
+[data-look="game"] .title{text-shadow:0 2px 0 color-mix(in srgb,var(--bg) 70%,transparent),0 0 30px color-mix(in srgb,var(--bg) 90%,transparent)}
+[data-look="game"] .line,[data-look="game"] .live,[data-look="game"] .also{color:color-mix(in srgb,var(--fg) 86%,transparent)}
 @media (min-width:760px){
   .hero-shade{background:
     linear-gradient(to top,var(--bg) 0%,color-mix(in srgb,var(--bg) 70%,transparent) 18%,transparent 52%),
@@ -158,6 +171,10 @@ img,video{display:block;max-width:100%}
   .row{display:flex;align-items:center;flex-wrap:wrap;gap:12px 26px}
   .row .live{margin:0}
   .also{margin-top:18px}
+  [data-look="game"] .hero-shade{background:linear-gradient(to top,var(--bg) 0%,color-mix(in srgb,var(--bg) 60%,transparent) 12%,transparent 30%),
+    linear-gradient(to bottom,color-mix(in srgb,var(--bg) 94%,transparent) 0%,color-mix(in srgb,var(--bg) 70%,transparent) 9%,transparent 20%)}
+  [data-look="game"] .hero-copy::before{left:0;right:auto;width:min(1000px,72vw);height:100%;
+    background:radial-gradient(110% 85% at 0% 100%,color-mix(in srgb,var(--bg) 92%,transparent) 0%,color-mix(in srgb,var(--bg) 72%,transparent) 36%,transparent 66%)}
 }
 @media (max-height:540px) and (min-aspect-ratio:4/3){
   .hero{padding-top:calc(env(safe-area-inset-top,0px) + 62px)}
@@ -514,12 +531,17 @@ function tokensCss(theme = {}, over = null) {
 @media (max-width:719px){:root{--top-h:112px}}`;
 }
 
-/** A landing's `over` tokens: its scheme's (light or dark, when it differs from the studio's), then its own colours. */
+/**
+ * A landing's `over` tokens: its scheme's (light or dark, when it differs from the studio's), then its own colours.
+ * A landing drawn in its game's own palette (0.26.0: style.json, when game.json sets no landing colours or scheme)
+ * says so (`look: 'game'`): its footage keeps its colour, and the words get a soft panel of the game's paper instead.
+ */
 function landingTokens(cat, L) {
   const studio = cat.studio?.theme?.scheme === 'light' ? 'light' : 'dark';
   const want = L.scheme === 'light' || L.scheme === 'dark' ? L.scheme : null;
-  if (!want || want === studio) return L.theme ?? null;
-  return { ...SCHEME_TOKENS[want], ...(L.theme ?? {}), scheme: want };
+  const look = L.schemeFrom === 'style' ? { look: 'game' } : null;
+  if (!want || want === studio) return L.theme || look ? { ...(L.theme ?? {}), ...(look ?? {}) } : null;
+  return { ...SCHEME_TOKENS[want], ...(L.theme ?? {}), scheme: want, ...(look ?? {}) };
 }
 
 const studioName = (cat) => cat.studio?.name ?? 'Studio';
@@ -596,7 +618,7 @@ ${icon}${feeds}${head}
 <style>${tokensCss(theme, over)}${BASE_CSS}${cat.site?.css ?? ''}</style>
 ${partial(cat, 'head') ?? ''}
 </head>
-<body class="${hero ? 'has-hero' : ''}" data-page="${esc(page)}" data-scheme="${(over?.scheme ?? theme.scheme) === 'light' ? 'light' : 'dark'}">
+<body class="${hero ? 'has-hero' : ''}" data-page="${esc(page)}" data-scheme="${(over?.scheme ?? theme.scheme) === 'light' ? 'light' : 'dark'}"${over?.look === 'game' ? ' data-look="game"' : ''}>
 <a class="skip" href="#main">Skip to content</a>
 ${header(cat, active)}
 <main id="main">

package/worker/version.mjs

@@ -1,2 +1,2 @@
 /** The @homie-rocks/studio version this Worker code is (package.json's; a test keeps them equal). Cache-busts /_homie/site.js. */
-export const STUDIO_VERSION_TAG = '0.24.5';
+export const STUDIO_VERSION_TAG = '0.26.0';