mdeck 3.3.0 → 3.5.0

package/docs/site/content/appearance.md

@@ -5,7 +5,7 @@ A **theme** chooses the fonts and the style of the slides. A **palette** chooses
 Ask your assistant by name or by description:
 
 ```prompt
-Use the aurora theme, dark. Or suggest a look that suits a talk for
+Use the glass theme, light. Or suggest a look that suits a talk for
 a design conference.
 ```
 
@@ -26,9 +26,11 @@ If you already have a settings block there, change the existing lines rather tha
 | Name to use | What it looks like |
 |---|---|
 | `neue` | Swiss style: large type, clear lines, red on white |
-| `aurora` | Northern lights: curtains of light, night-sky chapters and glass |
+| `plain` | Black on white and lots of room, the heading beside the content |
 | `minimal` | Nothing but the content: system fonts, calm type, no decoration; works offline |
 | `academic` | A lecture: compact slides, theorem and definition boxes, tables like in a paper |
+| `work` | An everyday company template: a coloured band, your logo, numbered sections, a footer |
+| `glass` | Liquid glass: soft light behind frosted panes; it starts dark |
 
 Each theme comes with colours that suit it, so you do not have to choose any. More themes are in the theme repository (see “Themes that moved to the repository” below).
 
@@ -42,11 +44,11 @@ Each theme in its own colours, on the title slide of the tour example. Click a p
 
 Default colours: `swiss`.
 
-### Aurora
+### Plain
 
-[![The tour's title slide in the Aurora theme](images/themes/aurora.webp)](images/themes/aurora.webp)
+[![The tour's title slide in the Plain theme](images/themes/plain.webp)](images/themes/plain.webp)
 
-Default colours: `neon`.
+Default colours: `greyscale`. In the dark it is the same, inverted.
 
 ### Academic
 
@@ -60,6 +62,18 @@ Default colours: `nordic`.
 
 Default colours: `paper`. It uses the fonts already on the computer, so it needs no internet connection and looks plain on purpose.
 
+### Work
+
+[![The tour's title slide in the Work theme](images/themes/work.webp)](images/themes/work.webp)
+
+Default colours: `cobalt`. Set `meta.logo` and it shows top left; any palette makes it your company's colours.
+
+### Glass
+
+[![The tour's title slide in the Glass theme](images/themes/glass.webp)](images/themes/glass.webp)
+
+Default colours: `nordic`, dark.
+
 ## Choose colours
 
 To use other colours, set `palette` to one of these:
@@ -67,8 +81,9 @@ To use other colours, set `palette` to one of these:
 | Name to use | Colours |
 |---|---|
 | `swiss` | White, black and signal red (neue's own) |
-| `nordic` | Ice grey, deep navy and a cool steel blue (academic's own) |
-| `neon` | Violet and magenta, loud (aurora's own) |
+| `nordic` | Ice grey, deep navy and a cool steel blue (academic's and glass's own) |
+| `cobalt` | Strong ultramarine on white with vivid orange (work's own) |
+| `greyscale` | Black, white and greys only, good for printing (plain's own) |
 | `lagoon` | Teal on warm stone |
 | `paper` | Off-white and near-black with one orange accent (minimal's own) |
 
@@ -97,8 +112,6 @@ Some slides use the other version on purpose: neue's statement slides are dark i
 
 The first chapter slide of the tour in each palette a theme offers. Choose a theme above the pictures; click a sheet to see it larger. A theme that offers only its own colours is not shown here.
 
-Some themes turn their chapter slides around on purpose: aurora's are a night sky in a light talk, and light in a dark one.
-
 ### Light
 
 <!-- theme-sheets light -->
@@ -127,7 +140,8 @@ Earlier versions of mdeck came with more themes and palettes. They are now in th
 
 | Theme | What it looks like (its palette) |
 |---|---|
-| `duet` | Two accent colours that take turns, slab headings (`cobalt`) |
+| `aurora` | Northern lights: curtains of light, night-sky chapters (`neon`) |
+| `duet` | Two accent colours that take turns, slab headings (`cobalt`, which comes with mdeck) |
 | `editorial` | A magazine spread with serif headlines and pull quotes (`terra`) |
 | `fhnw` | The FHNW visual identity, with its own `brand` palette only |
 | `terminal` | Headings typed at a prompt, a status bar; it starts dark (`phosphor`) |

package/docs/site/content/audience.md

@@ -28,19 +28,61 @@ Every poll in a presentation shows the same code, so people scan once. Their pho
 | Setting | Meaning |
 |---|---|
 | `room` | A short name for this question, different for each poll in the deck. Letters, digits, hyphens and underscores. |
-| `answer` | Optional: the right answer, written exactly like the option. A button with a tick then appears under the bars; tapping it outlines the right answer, its bar and its number in green, and tapping again hides it. The audience window shows it too. |
+| `answer` | Optional: the right answer, written exactly like the option (several separated by `\|`). A button with a tick then appears under the bars; tapping it outlines the right answer, its bar and its number in green, and each phone says whether its vote was right. Tapping again hides it. |
 | `options` | The answers, separated by `\|` |
 | `question` | Optional question text. Without it, phones show the slide's heading. |
+| `multiple` | Each phone may pick several options. The slide and the phones say “Several answers possible”. Without it, one option per phone. |
+| `buttons` | `letters` puts A, B, C … before the options on the slide, and the phones show only those letters; `numbers` does the same with 1, 2, 3 … For options that are pictures or long formulas, better read on the big screen. |
+| `results` | `hidden` starts with the bars hidden, e.g. to let people vote before they see what others chose. |
 | `qr` | `false` leaves out the QR code, when an earlier slide showed it with `<qrcode join />`. |
 
+The question and the options may contain formatting and formulas, written as on a slide, so a maths lecture can ask:
+
+```markdown
+<poll room="derivative" question="What is $\frac{d}{dx}\, x^2$?" options="$2x$|$x^2$|$\frac{x^3}{3}$" answer="$2x$" />
+```
+
+Both the slide and the phones show the formulas. A `|` inside a formula stays in it, so `$|x|$` is one option; to put a `|` in plain text, write `\|`.
+
+When the options get long, write them as a list inside the tag instead, one option per line, and tick the right one with `[x]`:
+
+```markdown
+<poll room="derivative" question="What is $\frac{d}{dx}\, x^2$?">
+
+- [x] $2x$
+- [ ] $x^2$
+- [ ] $\frac{x^3}{3}$
+
+</poll>
+```
+
+Nothing needs escaping there, and the right answer is marked where it stands.
+
+Options can also be pictures. Show only letters on the phones then:
+
+```markdown
+<poll room="graph" question="Which graph shows $f(x) = e^{-x}$?" options="![](a.svg)|![](b.svg)|![](c.svg)" answer="![](b.svg)" buttons="letters" />
+```
+
+### During the poll
+
+Below the bars, the slide counts the answers, “12 of 31 answered” while phones are connected. The presenter has three buttons there (the audience window does not show them):
+
+- **The lock** closes the poll. Answers after that do not count, and the phones say the poll is closed until you open it again.
+- **The eye** hides or shows the bars. Hidden, the audience sees no bars; your own screens show them faint.
+- **The tick** (with `answer`) shows the right answer: on the slide, and on each phone, which says whether its answer was right.
+
+Together they make a peer-instruction round: start with `results="hidden"`, let people vote, close, show the bars, let them discuss, and show the answer. **Reset** clears the answers and opens the poll again.
+
 With `lang: de` in the settings, the slide and the phones show German words, such as “Scannen und abstimmen”. The phones use the presentation's colours and fonts; if you pick another theme or palette in the presenter view, the phones change with it.
 
 ## Other kinds of questions
 
-Besides a poll, three more kinds work the same way: one line on a slide, answered on the phones.
+Besides a poll, four more kinds work the same way: one line on a slide, answered on the phones.
 
 ```markdown
 <scale room="pace" min="1" max="5" low="Too slow" high="Too fast" />
+<numeric room="limit" question="What is $\lim_{x \to 0} \frac{\sin x}{x}$?" answer="1" />
 <wordcloud room="mood" placeholder="One word" />
 <question room="ask" placeholder="Your question" />
 ```
@@ -48,10 +90,11 @@ Besides a poll, three more kinds work the same way: one line on a slide, answere
 | Tag | Phones show | The slide shows |
 |---|---|---|
 | `<scale>` | The numbers from `min` to `max` (1 to 5 unless set, at most 11 steps), with `low` and `high` as labels at the ends | How many chose each number, and the average. Each phone's latest answer counts |
+| `<numeric>` | A field for a number: `0.5`, `0,5`, `1/2` or `1e-3` | The most frequent answers as bars, six unless `limit` says otherwise, and the rest as Other. With `answer`, the tick marks the right ones and counts them, and each phone hears whether it was right; `tolerance` (0 unless set) says how far off still counts. Each phone's latest answer counts |
 | `<wordcloud>` | A short text field | A cloud of every answer, packed around the middle, larger the more often it came in and some upright. Capitals and extra spaces do not matter. People may send several. `height` sets its height (520). Colours come from the palette; `--cloud-1` to `--cloud-6` override them |
 | `<question>` | A text field | The newest answers as cards, eight unless `limit` says otherwise. People may send several |
 
-All of them take `room`, `question` and `qr` like a poll, and `placeholder` for the text fields.
+All of them take `room`, `question` and `qr` like a poll, and `placeholder` for the text fields. Their `question`, and the scale's `low` and `high`, may contain formatting and formulas like a poll's options. All of them have the lock that closes them; `<numeric>` also has the eye and the tick, and takes `results="hidden"`.
 
 ## Show the code once
 
@@ -175,9 +218,11 @@ Two presentations with the same title share a session code. Give one of them `se
 
 Answers are anonymous. Each phone gets a random number so it can change its vote; nothing else identifies it. The server keeps answers in memory only. It forgets a room after twelve hours without visitors and everything when it restarts. Each phone can send a limited number of answers in a short time.
 
+While you present with `mdeck run`, the answers are also kept beside the presentation, in `my-talk.results.json`. It holds each answer with its time, and the phones numbered 1, 2, 3 … per question instead of their random numbers. Once a question was closed, only the answers that counted. **Reset** takes a question's answers out of the file; a new server that starts empty leaves the file as it is. `mdeck results my-talk.md` prints the answers as CSV (question, phone, time, answer), to open in a spreadsheet; `-o answers.csv` saves them to a file. A deck hosted with its own `server` keeps nothing beside it.
+
 ## In a PDF or a shared file
 
-A PDF, a file made with `mdeck send` and a folder hosted without a poll server keep your questions as a record of the talk: each shows its question and options, with a note that it was answered live, and no join code. If the deck's `server` still answers when the file is made or opened, the results it holds appear instead. Printed slides never show the join code or the presenter's buttons.
+A PDF, a file made with `mdeck send` and a folder hosted without a poll server keep your questions as a record of the talk, without a join code. With answers kept in `my-talk.results.json`, each shows its results as they were at the end of the talk; without, its question and options with a note that it was answered live. `--no-results` leaves the kept answers out. If the deck's `server` still answers when the file is opened, the results it holds appear instead. Printed slides never show the join code or the presenter's buttons.
 
 ## Make your own activity
 

package/docs/site/content/commands.md

@@ -97,6 +97,8 @@ The design page shows themes and palettes on a sample deck with every kind of sl
 | `mdeck send my-talk.md --no-pdf` | The same, without rendering the PDF |
 | `mdeck pdf my-talk.md -o talk.pdf` | Render the slides to a PDF file (`--no-polls` leaves out the slides with polls) |
 | `--no-drawings` | Leave out the drawings from `my-talk.drawings.json`, for `build`, `send` and `pdf` |
+| `--no-results` | Leave out the answers kept in `my-talk.results.json`, for `build`, `send` and `pdf`; the polls then show their questions only |
+| `mdeck results my-talk.md` | The answers kept during the talk, as CSV; `-o answers.csv` saves them to a file |
 
 See [Send, host or print your slides](sharing.html) for help choosing between them. Unknown options, missing option values and extra filenames stop the command before it changes any output. `--output=path` and `-o path` are both accepted. `mdeck preview --no-open --port 4200` previews without opening a browser and chooses a port.
 

package/docs/site/content/theme-repository.md

@@ -1,6 +1,6 @@
 # Install, remove or share a theme
 
-mdeck comes with four themes, `neue`, `academic`, `aurora` and `minimal`, and five palettes, `swiss`, `nordic`, `neon`, `paper` and `lagoon`. They work right away, also without an internet connection. More themes and palettes are in the **theme repository**; try every one on a sample deck, light and dark, at <https://gh.tschieber.de/mdeck-themes/>.
+mdeck comes with six themes, `neue`, `plain`, `academic`, `minimal`, `work` and `glass`, and six palettes, `swiss`, `nordic`, `cobalt`, `greyscale`, `paper` and `lagoon`. They work right away, also without an internet connection. More themes and palettes are in the **theme repository**; try every one on a sample deck, light and dark, at <https://gh.tschieber.de/mdeck-themes/>.
 
 ## Find and install one
 
@@ -15,16 +15,16 @@ mdeck palettes search
 Install a theme:
 
 ```sh
-mdeck themes install duet
+mdeck themes install terminal
 ```
 
-A theme comes with its default palette, so this installs the palette `cobalt` too. A palette installs on its own:
+A theme comes with its default palette, so this installs the palette `phosphor` too. A palette installs on its own:
 
 ```sh
 mdeck palettes install solarized
 ```
 
-They are installed for every deck on this computer, in a folder in your home folder (`~/.mdeck/extensions`). Then choose one at the top of a slide file (`theme: duet`, `palette: solarized`) or in the editor's **Deck** tab.
+They are installed for every deck on this computer, in a folder in your home folder (`~/.mdeck/extensions`). Then choose one at the top of a slide file (`theme: terminal`, `palette: solarized`) or in the editor's **Deck** tab.
 
 The design page has the same: open it with `mdeck design`, choose **Show what you can install**, and press **Install** beside a theme or palette.
 
@@ -44,15 +44,15 @@ The slide folder then carries the theme and its palette, so it works on a comput
 mdeck themes list                  # what comes with mdeck, and what is installed
 mdeck themes update                # newer versions of the installed themes
 mdeck palettes update
-mdeck themes remove duet
-mdeck palettes remove cobalt
+mdeck themes remove terminal
+mdeck palettes remove phosphor
 ```
 
 Add a slide file, or `--local`, to work beside that deck. If you changed an installed file by hand, `update` and `remove` stop and tell you which one, so your change is not lost; add `--force` to go ahead anyway.
 
 A palette that an installed theme uses by default stays until that theme is removed. A palette made for one theme only (like FHNW's `brand`) comes and goes with that theme.
 
-The themes and palettes that come with mdeck can be removed too: `mdeck themes remove aurora` hides it from every deck and from the lists, and `mdeck themes install aurora` brings it back, without the internet. The last theme always stays. A deck without a `theme:` setting uses `neue`; if you removed it, `mdeck check` tells you.
+The themes and palettes that come with mdeck can be removed too: `mdeck themes remove glass` hides it from every deck and from the lists, and `mdeck themes install glass` brings it back, without the internet. The last theme always stays. A deck without a `theme:` setting uses `neue`; if you removed it, `mdeck check` tells you.
 
 ## What may be in one
 

package/examples/showcase/slides.md

@@ -1,5 +1,5 @@
 ---
-theme: aurora
+theme: glass
 meta:
   title: "A tour of mdeck"
   author: "Tilman Schieber"
@@ -380,7 +380,7 @@ layout: split
 :::slot left
 ```markdown
 ---
-theme: aurora
+theme: work
 palette: lagoon
 ---
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mdeck",
-  "version": "3.3.0",
+  "version": "3.5.0",
   "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",
@@ -75,5 +75,8 @@
     "vite": "^8.3.1",
     "vite-plugin-singlefile": "^2.3.3",
     "ws": "^8.22.0"
+  },
+  "devDependencies": {
+    "parse5": "^8.0.1"
   }
 }

package/skills/write-slides/SKILL.md

@@ -34,7 +34,7 @@ If `mdeck` is not installed, rely on the quick reference below.
 ```markdown
 ---
 theme: neue            # theme id from `mdeck list themes`
-palette: nordic         # optional: swiss, nordic, neon, lagoon, paper, or one installed from the theme repository (`mdeck themes search`)
+palette: nordic         # optional: swiss, nordic, cobalt, greyscale, lagoon, paper, or one installed from the theme repository (`mdeck themes search`)
 appearance: light       # optional: light or dark
 meta:
   title: "Talk title"
@@ -94,7 +94,7 @@ Right column
 - Named areas use `:::slot name … :::`; the layout's regions and settings come from `mdeck list layouts --json`.
 - `:::notes … :::` holds speaker notes. `:::steps … :::` reveals list items one at a time. `:::note`, `:::tip`, `:::important`, `:::warning` and `:::caution` are callouts (`mdeck check` warns about other names); for lectures, `:::definition`, `:::theorem`, `:::lemma`, `:::proof`, `:::example` and `:::remark`, numbered in the title (`::: theorem Theorem 2.4 (Lagrange)`). `:::columns … +++ … :::` makes columns inside a slide.
 - Code fences get syntax highlighting; `$…$` and `$$…$$` render math.
-- `<poll room="lunch" options="Mensa|Thai|Pizza" />` lets the audience vote on their phones through a QR code on the slide; each poll needs its own `room`. `<scale room="pace" min="1" max="5" low="Too slow" high="Too fast" />`, `<wordcloud room="mood" />` and `<question room="ask" />` ask for a rating, short words or open answers the same way. With several of them, put `<qrcode join />` (the deck's join code) on an early slide to show the QR code once, and add `qr="false"` to the questions. It works when the deck is presented with `mdeck run <deck>.md --network` or with a server set as `server:` in the deck settings.
+- `<poll room="lunch" options="Mensa|Thai|Pizza" />` lets the audience vote on their phones through a QR code on the slide; each poll needs its own `room`. `question` and `options` may use Markdown and `$…$` maths (`options="$2x$|$x^2$"`); `answer` repeats the right option's text. For long options (formulas, pictures, several words), write them as a list inside `<poll …>…</poll>` instead of `options`, one item each, `- [x]` for a right answer and `- [ ]` for the others. `multiple` allows several picks; `buttons="letters"` shows only A, B, C on the phones, for options that are pictures or long formulas. `<numeric room="lim" question="…" answer="1/2" tolerance="0.01" />` asks for a number. `<scale room="pace" min="1" max="5" low="Too slow" high="Too fast" />`, `<wordcloud room="mood" />` and `<question room="ask" />` ask for a rating, short words or open answers the same way. With several of them, put `<qrcode join />` (the deck's join code) on an early slide to show the QR code once, and add `qr="false"` to the questions. It works when the deck is presented with `mdeck run <deck>.md --network` or with a server set as `server:` in the deck settings.
 
 ## 3. Write the deck
 

package/src/build/bibliography.js

@@ -1,8 +1,9 @@
-import { readFileSync, statSync } from 'fs'
-import { resolve, dirname, extname } from 'path'
+import { readFileSync, statSync, existsSync } from 'fs'
+import { resolve, dirname, extname, basename } from 'path'
 import yaml from 'js-yaml'
 import { parseSlides } from '../core/parseSlides.js'
 import { scanCitations, citedKeys } from '../core/citations.js'
+import { sampleDeck, SAMPLE_REFERENCES, SAMPLE_REFERENCES_FILE } from '../editor/sampleDeck.js'
 
 // The deck's references, formatted here in Node with citeproc so that none of
 // it travels in the deck: the page receives finished HTML for every citation
@@ -26,8 +27,14 @@ async function readItems(file) {
   const { mtimeMs } = statSync(file)
   const cached = parsed.get(file)
   if (cached?.mtimeMs === mtimeMs) return cached.items
-  const text = readFileSync(file, 'utf-8')
-  const ext = extname(file).toLowerCase()
+  const items = await parseReferences(readFileSync(file, 'utf-8'), extname(file))
+  parsed.set(file, { mtimeMs, items })
+  return items
+}
+
+// Reference file text as CSL-JSON items; `ext` names the format.
+export async function parseReferences(text, ext) {
+  ext = ext.toLowerCase()
   let items
   if (ext === '.json') items = JSON.parse(text)
   else if (ext === '.yml' || ext === '.yaml') {
@@ -40,18 +47,20 @@ async function readItems(file) {
     items = new Cite(text, { forceType: '@biblatex/text' }).data
   } else throw new Error(`unknown reference format "${ext}" (use .bib, .json or .yml)`)
   if (!Array.isArray(items)) throw new Error('expected a list of references')
-  items = items.filter(item => item && item.id != null).map(item => ({ ...item, id: String(item.id) }))
-  parsed.set(file, { mtimeMs, items })
-  return items
+  return items.filter(item => item && item.id != null).map(item => ({ ...item, id: String(item.id) }))
 }
 
-export async function loadBibliography(files) {
+// `sample`: the sample deck's references stand in for a missing file of
+// theirs (the dev and edit servers show the sample deck without a folder).
+export async function loadBibliography(files, { sample = false } = {}) {
   const items = []
   const seen = new Set()
   const diagnostics = []
   for (const file of files) {
     let found
-    try { found = await readItems(file) } catch (error) {
+    try {
+      found = sample && basename(file) === SAMPLE_REFERENCES_FILE && !existsSync(file) ? await parseReferences(SAMPLE_REFERENCES, '.bib') : await readItems(file)
+    } catch (error) {
       diagnostics.push({ severity: 'warning', code: 'bibliography-file', message: error.code === 'ENOENT' ? `Bibliography ${file} not found` : `Bibliography ${file}: ${error.message}` })
       continue
     }
@@ -275,15 +284,24 @@ export async function formatBibliography({ items, texts, csl, lang, nocite = [],
 
 // Everything the deck's `bibliography`, `csl`, `nocite` and `lang` ask for,
 // or null when the deck has no bibliography.
-export async function resolveBibliography(deckPath, source) {
+export async function resolveBibliography(deckPath, source, { sample = false } = {}) {
   let deckConfig
   try { deckConfig = parseSlides(source).deckConfig ?? {} } catch { return null }
   const files = bibliographyFiles(deckPath, deckConfig)
   if (!files.length) return null
-  const loaded = await loadBibliography(files)
+  const loaded = await loadBibliography(files, { sample })
   const formatted = await formatBibliography({
     items: loaded.items, texts: deckTexts(source), csl: deckConfig.csl, lang: deckConfig.lang,
     nocite: deckConfig.nocite ?? [], deckDir: dirname(resolve(deckPath)),
   })
   return { ...formatted, diagnostics: [...loaded.diagnostics, ...formatted.diagnostics], files, style: styleFile(deckPath, deckConfig) }
 }
+
+// The sample deck's citations, formatted once: the design page previews it
+// in the editor of any deck, whose own references are another matter.
+let sampleFormatted = null
+export function sampleBibliography() {
+  sampleFormatted ??= parseReferences(SAMPLE_REFERENCES, '.bib')
+    .then(items => formatBibliography({ items, texts: deckTexts(sampleDeck()) }))
+  return sampleFormatted
+}

package/src/build/resultsPlugin.js

@@ -0,0 +1,77 @@
+// Keeping the answers while `mdeck run` runs: the presenter's screens send
+// each activity's answers as they come in (src/live/client.js), and they go
+// into <deck>.results.json beside the deck (src/core/results.js).
+//
+//   POST /__mdeck/results   { room, closed, answers } → { ok }
+//
+// Answers of none take the room out of the file, as Reset does. Writes wait
+// a moment, so a burst of votes is one write, and do not reload the open
+// windows (ownWrites.js).
+import { existsSync, readFileSync, writeFileSync, renameSync } from 'node:fs'
+import { resolve } from 'node:path'
+import { resultsFileFor, normalizeResults, withRoom, serializeResults } from '../core/results.js'
+import { isAllowedRequest, send, readJson } from './editorPlugin.js'
+import { markOwnWrite } from './ownWrites.js'
+
+export function createResultsFile(deckPath, { debounceMs = 500 } = {}) {
+  const path = resultsFileFor(resolve(deckPath))
+  let results = null, timer = null
+
+  const current = () => {
+    if (results) return results
+    try { results = existsSync(path) ? normalizeResults(JSON.parse(readFileSync(path, 'utf8'))) : normalizeResults({}) }
+    catch { results = normalizeResults({}) }
+    return results
+  }
+
+  function flush() {
+    clearTimeout(timer)
+    timer = null
+    if (!results) return
+    // A deck that never kept answers gets no empty file.
+    if (!Object.keys(results.rooms).length && !existsSync(path)) return
+    const text = serializeResults(results)
+    markOwnWrite(path, text)
+    const temp = `${path}.${process.pid}.tmp`
+    writeFileSync(temp, text, 'utf8')
+    renameSync(temp, path)
+  }
+
+  return {
+    path,
+    read: current,
+    save(room, entry) {
+      results = withRoom(current(), room, entry)
+      clearTimeout(timer)
+      timer = setTimeout(flush, debounceMs)
+    },
+    flush,
+  }
+}
+
+export function resultsMiddleware(file, { authorize = isAllowedRequest } = {}) {
+  return async (request, response, next) => {
+    const { pathname } = new URL(request.url, 'http://localhost')
+    if (pathname !== '/') return next()
+    if (request.method !== 'POST') { response.setHeader('Allow', 'POST'); return send(response, 405, { error: 'Method not allowed' }) }
+    if (!authorize(request)) return send(response, 403, { error: 'Only the presenter keeps the results' })
+    try {
+      const { room, closed, answers } = await readJson(request)
+      file.save(String(room ?? ''), { closed, answers })
+      return send(response, 200, { ok: true })
+    } catch (error) {
+      return send(response, error.status ?? 500, { error: error.message })
+    }
+  }
+}
+
+export function resultsPlugin(slidesPath, { authorize } = {}) {
+  return {
+    name: 'vite-plugin-mdeck-results',
+    configureServer(server) {
+      const file = createResultsFile(slidesPath)
+      server.middlewares.use('/__mdeck/results', resultsMiddleware(file, { authorize }))
+      server.httpServer?.once('close', () => file.flush())
+    },
+  }
+}