mdeck 3.12.0 → 3.12.1

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 3.12.1 — 2026-10-12
+
+- Fixed: on an iPhone the reaction buttons sat below the visible part of the phones' page, behind Safari's bar. The page now fits the visible height. Update your poll server for this one.
+- `mdeck --version` (or `-v`) shows which mdeck this is.
+- Fixed: with polls on your own server, the presenter view counted no phones: they join that server, while the presenter view's room stays on your computer. `mdeck run` now asks the server how many phones joined.
+- Shorter status lines in the presenter view: "Poll server needs an update to 3.12.1.", "Phones follow another screen. Change slide to take them back."
+
 ## 3.12.0 — 2026-10-12
 
 - In a word cloud each phone counts with one word: a new one replaces its earlier word, and the phone says which it sent. Before, one phone could fill the cloud.

package/docs/site/content/commands.md

@@ -27,6 +27,7 @@ For how the commands, the views and the servers fit together, see [Views, comman
 | `mdeck list`, `mdeck starter` | Look up layouts, themes and palettes |
 | `mdeck docs` | Open this documentation |
 | `mdeck --help` | Show a short list of commands |
+| `mdeck --version` | Show which version of mdeck you have |
 
 ## The launch page
 

package/examples/showcase/slides.de.results.json

@@ -2,54 +2,24 @@
   "version": 1,
   "rooms": {
     "tour": {
-      "savedAt": "2026-10-12T21:17:14.623Z",
+      "savedAt": "2026-10-12T21:42:08.047Z",
       "closed": false,
       "answers": [
         {
           "phone": 1,
-          "at": "2026-10-12T21:01:59.353Z",
-          "value": "Umfragen"
+          "at": "2026-10-12T21:37:57.968Z",
+          "value": "Zeichnen"
         }
       ]
     },
     "mood": {
-      "savedAt": "2026-10-12T21:18:16.405Z",
+      "savedAt": "2026-10-12T21:42:08.391Z",
       "closed": false,
       "answers": [
         {
           "phone": 1,
-          "at": "2026-10-12T21:17:34.435Z",
-          "value": "Bonj"
-        },
-        {
-          "phone": 1,
-          "at": "2026-10-12T21:17:38.153Z",
-          "value": "Banjf"
-        },
-        {
-          "phone": 1,
-          "at": "2026-10-12T21:17:43.867Z",
-          "value": "Hallo Herr Doktor Müller"
-        },
-        {
-          "phone": 1,
-          "at": "2026-10-12T21:17:49.791Z",
-          "value": "Hallo Herr"
-        },
-        {
-          "phone": 1,
-          "at": "2026-10-12T21:17:57.260Z",
-          "value": "Hallo Herr Doktor Müller"
-        },
-        {
-          "phone": 1,
-          "at": "2026-10-12T21:18:03.177Z",
-          "value": "Ja 👍 und die sind"
-        },
-        {
-          "phone": 1,
-          "at": "2026-10-12T21:18:15.378Z",
-          "value": "Hallo Herr Müller"
+          "at": "2026-10-12T21:38:02.812Z",
+          "value": "Gggghh"
         }
       ]
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mdeck",
-  "version": "3.12.0",
+  "version": "3.12.1",
   "type": "module",
   "description": "Write slides as a plain text file, present them in the browser, share them as one HTML file or PDF.",
   "license": "MIT",

package/src/cli/index.js

@@ -391,6 +391,7 @@ const HELP = `
                                               through it (MDECK_SERVER_KEY); put a web server in front
 
   Commands that take ${c.bold}slides.md${c.reset} use the one in the current folder when you leave it out.
+  ${c.green}mdeck --version${c.reset} shows which mdeck this is.
 
   ${c.dim}Install the${c.reset} ${c.bold}mdeck${c.reset} ${c.dim}command globally:${c.reset}
     npm link
@@ -402,6 +403,11 @@ const HELP = `
 // ── Argument parsing ──────────────────────────────────────────────────────────
 const [command, ...argv] = process.argv.slice(2)
 
+if (command === '--version' || command === '-v' || command === 'version') {
+  console.log(JSON.parse(readFileSync(new URL('../../package.json', import.meta.url), 'utf8')).version)
+  process.exit(0)
+}
+
 if (!command || command === '--help' || command === '-h') {
   console.log(HELP)
   process.exit(0)

package/src/live/answer/answer.css

@@ -6,7 +6,9 @@
 }
 * { box-sizing: border-box; }
 html, body { margin: 0; min-height: 100%; background: var(--bg); color: var(--ink); }
-body { min-height: 100vh; display: flex; flex-direction: column; font: 18px/1.45 var(--font-body); -webkit-font-smoothing: antialiased; }
+/* The visible height (dvh): on a phone, 100vh is taller than what shows beside
+   the browser's bars, and the reactions at the bottom slid out of sight. */
+body { min-height: 100vh; min-height: 100dvh; padding-bottom: env(safe-area-inset-bottom); box-sizing: border-box; display: flex; flex-direction: column; font: 18px/1.45 var(--font-body); -webkit-font-smoothing: antialiased; }
 #answer { flex: 1; display: flex; flex-direction: column; }
 .answer { flex: 1; width: 100%; max-width: 520px; margin: 0 auto; padding: 32px 20px; }
 .answer h1 {

package/src/live/rooms.js

@@ -43,13 +43,23 @@ export function createRooms({ maxMessages = 5000, maxInk = 5000, maxRooms = 500,
   const broadcast = (room, event) => { for (const listener of room.listeners) listener(event) }
   // A session is a room and the rooms named after it (`<code>.stage`, …).
   const sessionRooms = id => { const session = id.split('.')[0]; return [...rooms].filter(([name]) => name === session || name.startsWith(`${session}.`)).map(([, room]) => room) }
+  // Phones connected elsewhere, by session: mdeck run keeps the stage room
+  // here but the phones join a standalone server (src/live/server.js).
+  const awayPhones = new Map()
   const presence = id => {
     const present = sessionRooms(id).flatMap(room => [...room.present.values()])
     const views = present.filter(entry => entry.view !== 'phone').sort((a, b) => VIEWS.indexOf(a.view) - VIEWS.indexOf(b.view))
-    return { views, phones: present.length - views.length }
+    return { views, phones: present.length - views.length + (awayPhones.get(id.split('.')[0]) ?? 0) }
   }
   const announcePresence = id => { const event = { type: 'presence', presence: presence(id) }; for (const room of sessionRooms(id)) broadcast(room, event) }
   return {
+    /** Phones of session `id` that joined another server; announced when the number changes. */
+    setAwayPhones(id, n) {
+      const session = id.split('.')[0]
+      if ((awayPhones.get(session) ?? 0) === n) return
+      awayPhones.set(session, n)
+      announcePresence(session)
+    },
     post(id, { from = null, data }) {
       const room = get(id)
       // Reactions (src/core/reactions.js) are passed on and forgotten.

package/src/live/server.js

@@ -14,11 +14,25 @@ export function livePlugin({ pairing = null, upstream = null, key = null, sessio
   return {
     name: 'vite-plugin-mdeck-live',
     configureServer(server) {
+      const rooms = createRooms()
       const handler = liveHandler({
-        rooms: createRooms(),
+        rooms,
         canReset: (request, room) => isAllowedRequest(request) || (!!pairing?.allows(request) && (room == null || room === session() || room.startsWith(`${session()}.`))),
         info: () => ({ network: server.resolvedUrls?.network?.[0] ?? null }),
       })
+      // With polls on a standalone server, the phones join there: its count
+      // joins the local stage room's, so the presenter sees them.
+      const awayTimer = setInterval(async () => {
+        const address = typeof upstream === 'function' ? upstream() : upstream
+        const code = session()
+        if (!address || !code) return
+        try {
+          const response = await fetch(`${address.replace(/\/+$/, '')}/rooms/${encodeURIComponent(code)}.stage/presence`, { signal: AbortSignal.timeout(3000) })
+          if (response.ok) rooms.setAwayPhones(code, Number((await response.json()).phones) || 0)
+        } catch {}
+      }, 4000)
+      awayTimer.unref?.()
+      server.httpServer?.once('close', () => clearInterval(awayTimer))
       server.middlewares.use('/__mdeck/live', (request, response, next) => {
         const address = typeof upstream === 'function' ? upstream() : upstream
         // The stage room (position and live ink between the presenter's

package/src/runtime/PresenterChrome.jsx

@@ -99,9 +99,9 @@ const PAIR = {
 function Polls({ live, recheck }) {
   const [copied, setCopied] = useState(false)
   const copy = () => navigator.clipboard?.writeText(live.joinUrl).then(() => { setCopied(true); setTimeout(() => setCopied(false), 1500) }, () => {})
-  const problem = live.server && !live.reachable ? `The poll server does not answer${live.error ? ` (${live.error})` : ''}.`
-    : !live.joinUrl ? <>Phones cannot reach this computer: start with <code>--network</code>, or set <code>server</code> in the deck.</>
-    : live.server && live.key && !live.keyAccepted ? 'The poll server does not accept this key: phones do not follow.'
+  const problem = live.server && !live.reachable ? 'Poll server not answering.'
+    : !live.joinUrl ? <>Phones can’t reach this computer: use <code>--network</code>.</>
+    : live.server && live.key && !live.keyAccepted ? 'Poll server refuses the key.'
     : null
   // A server on an older mdeck answers, but lacks what is new (reactions came with 3.12).
   const outdated = !problem && live.server && live.serverOutdated
@@ -111,8 +111,8 @@ function Polls({ live, recheck }) {
       <a href={live.joinUrl} target="_blank" rel="noopener" title="The join link for phones" style={{ color: '#ccc', textDecoration: 'none', overflow: 'hidden', textOverflow: 'ellipsis', whiteSpace: 'nowrap' }}>{live.joinUrl.replace(/^https?:\/\//, '')}</a>
       <ToolButton class="presenter-copy-join" icon={copied ? 'check' : 'copy'} label={copied ? 'Copied' : 'Copy the join link'} size={15} style={{ minWidth: '30px', height: '30px', padding: 0, flexShrink: 0 }} onClick={copy} />
     </span>}
-    {outdated && <span class="presenter-server-outdated" style={{ color: '#f5a524' }}>
-      Your poll server runs {live.serverVersion ? `mdeck ${live.serverVersion}` : 'an older mdeck'}, this computer {live.version}: what is new, such as reactions, may not reach the phones. Update it with <code>npm install -g mdeck</code> and restart <code>mdeck server</code>.
+    {outdated && <span class="presenter-server-outdated" style={{ color: '#f5a524' }} title={`Server ${live.serverVersion ?? 'older'}, here ${live.version}: npm install -g mdeck there, then restart mdeck server`}>
+      Poll server needs an update to {live.version}.
     </span>}
     {problem && <span style={{ display: 'flex', gap: '8px', alignItems: 'center', color: '#f28b82' }}>
       <span style={{ flex: 1 }}>{problem}</span>

package/src/runtime/main.jsx

@@ -148,10 +148,10 @@ function announceSlide(deck, index, { initial = false } = {}) {
 // Whether this presenter screen moves the phones along, shown only for decks
 // with activities: a failure used to be silent.
 const STEERING = {
-  'no-code': 'Phones do not follow: this browser has no server key. Open the presenter view once with ?serverkey=… (the launch page has a link).',
-  'wrong-code': "Phones do not follow: the server does not accept this browser's presenter code.",
-  unreachable: 'Phones do not follow: the server does not answer.',
-  'other-screen': 'Phones follow another screen, where this presentation was moved on more recently. Change the slide here to take them back.',
+  'no-code': 'Phones don’t follow: no server key here.',
+  'wrong-code': 'Phones don’t follow: key refused.',
+  unreachable: 'Phones don’t follow: server not answering.',
+  'other-screen': 'Phones follow another screen. Change slide to take them back.',
 }
 
 function injectSpeakerNotes(slides) {