mdeck 3.10.1 → 3.11.0

package/examples/showcase/{slides.md → slides.en.md}

@@ -1,10 +1,11 @@
 ---
-theme: glass
+theme: neue
 meta:
   title: "A tour of mdeck"
   author: "Tilman Schieber"
   organization: "FHNW"
   date: "2026-10-06"
+bibliography: refs.bib
 ---
 
 ---
@@ -14,14 +15,17 @@ image: ./img/mdeck.svg
 fit: contain
 alt: "A Markdown file turning into a stack of slides"
 id: a-talk-in-a-text-file
+time: 1m
 :::
 # A talk in a text file.
 ## A tour of mdeck: each slide shows *what is written* and what it becomes.
 
 :::notes
-This deck teaches mdeck by example. Most slides show the Markdown beside what it becomes. Open `slides.md` next to it: every slide here is written exactly as shown.
+This deck teaches mdeck by example. Most slides show the Markdown beside what it becomes. Open `slides.en.md` next to it: every slide here is written exactly as shown.
 
 Go through it with the arrow keys or the space bar. These notes are only for you; open the presenter view from the launch page to see them beside the slide.
+
+The tour also comes in German (`slides.de.md`) and Arabic (`slides.ar.md`). Start it with `mdeck run slides.en.md`, and **L** in the presenter view switches every window to the next language.
 :::
 
 ---
@@ -30,6 +34,7 @@ layout: chapter
 number: 1
 part: Writing
 description: Plain Markdown, the format AI assistants already write. You can read and change every word.
+time: 15s
 :::
 # Write it.
 
@@ -40,6 +45,7 @@ In practice an AI assistant usually writes this file from your own material: old
 ---
 :::meta
 layout: split
+time: 1m
 :::
 # Words become slides
 :::slot left
@@ -64,12 +70,13 @@ Three dashes on a line of their own start the next slide.
 :::notes
 `#` is the slide's heading. A blank line separates paragraphs.
 
-Try it: change a heading in `slides.md` and save. The slide updates while it is open.
+Try it: change a heading in `slides.en.md` and save. The slide updates while it is open.
 :::
 
 ---
 :::meta
 layout: split
+time: 45s
 :::
 # Lists and emphasis
 :::slot left
@@ -96,6 +103,9 @@ layout: split
 :::
 
 ---
+:::meta
+time: 1m
+:::
 # Reveal points one at a time
 
 :::columns
@@ -126,6 +136,7 @@ layout: chapter
 number: 2
 part: Layouts and content
 description: Layouts, pictures, code, tables and callouts. Pick a layout per slide; the theme does the rest.
+time: 15s
 :::
 # Lay it out.
 
@@ -134,6 +145,7 @@ description: Layouts, pictures, code, tables and callouts. Pick a layout per sli
 layout: split
 props:
   ratio: [3, 2]
+time: 1m
 :::
 # Choose a layout
 :::slot left
@@ -162,6 +174,7 @@ The built-in layouts are `title`, `chapter`, `focus`, `split`, `image-text` and
 :::meta
 layout: focus
 attribution: "A teacher"
+time: 30s
 :::
 # Good questions make better conversations.
 
@@ -170,6 +183,7 @@ attribution: "A teacher"
 layout: image-text
 image: ./img/image.jpg
 alt: "Contour lines like those on a map"
+time: 45s
 :::
 # A picture beside your words
 
@@ -193,6 +207,7 @@ layout: full-bleed-image
 image: ./img/image.jpg
 alt: "Contour lines like those on a map"
 overlay: true
+time: 30s
 :::
 # Or let the picture fill the slide.
 
@@ -214,6 +229,7 @@ overlay: true
 ---
 :::meta
 layout: split
+time: 1m30s
 :::
 # Code you can run
 :::slot left
@@ -240,6 +256,7 @@ Live Python downloads its runtime the first time, so it needs an internet connec
 ---
 :::meta
 layout: split
+time: 45s
 :::
 # Tables and formulas
 :::slot left
@@ -272,6 +289,7 @@ Formulas use LaTeX. Single dollar signs put a formula inside a sentence; two dol
 ---
 :::meta
 layout: split
+time: 45s
 :::
 # Tips and warnings
 :::slot left
@@ -299,6 +317,32 @@ Check the room's projector.
 The other callouts are `note`, `important` and `caution`. Add your own label after the type, for example `:::tip Before the talk`.
 :::
 
+---
+:::meta
+layout: split
+time: 1m
+:::
+# Cite your sources
+:::slot left
+```markdown
+---
+bibliography: refs.bib
+---
+
+Recalling beats rereading
+[@roediger2006].
+```
+:::
+:::slot right
+Recalling beats rereading [@roediger2006].
+
+Lectures with active learning cut failure rates by a third [@freeman2014].
+:::
+
+:::notes
+`refs.bib` is a BibTeX file, as Zotero exports it; CSL-JSON and Hayagriva work too. Each slide lists its own references above the footer, and `<bibliography />` on a slide lists them all. `csl: vancouver` switches to numbers.
+:::
+
 ---
 :::meta
 layout: chapter
@@ -306,12 +350,14 @@ number: 3
 part: Presenting
 description: Notes for you, drawing on the slides, and questions for the room.
 id: give-the-talk
+time: 15s
 :::
 # Give the talk.
 
 ---
 :::meta
 layout: split
+time: 1m
 :::
 # Notes only you can see
 :::slot left
@@ -337,12 +383,13 @@ This is what the presenter view shows for this slide. Its header also shows what
 ---
 :::meta
 id: draw-on-any-slide
+time: 1m
 :::
 # Draw on any slide
 
 Press **D** now, or the pen button. Draw with a pen, a highlighter, or a marker that fades after a moment. **Escape** stops.
 
-Drawings are kept in `slides.drawings.json` beside the slides, and appear in the PDF.
+Drawings are kept in a `.drawings.json` file beside the slides, and appear in the PDF.
 
 :::notes
 The underline and the circle on this slide were drawn with the pen and saved; they show in every view and in the PDF.
@@ -355,6 +402,7 @@ On an iPad, pair it from the launch page: you draw and steer there while the lap
 layout: split
 hotspots: auto
 id: zoom-in-on-a-part
+time: 1m30s
 :::
 # Zoom in on a part
 :::slot left
@@ -384,6 +432,34 @@ The numbered keys show on this slide only here in the presenter view, never on t
 :::
 
 ---
+:::meta
+layout: split
+time: 1m
+:::
+# Time your talk
+:::slot left
+```markdown
+:::meta
+time: 1m
+:::
+```
+:::
+:::slot right
+Give each slide a **time**. The presenter view counts it down, and tells you whether you are ahead or behind.
+
+Run `mdeck rehearse slides.md` to time the slides as you practise, then save the times into the file.
+:::
+
+:::notes
+Every slide in this tour has a time, 21 minutes in all. Press T in the presenter view to start the timer: under it you see what is left of this slide and how the talk stands.
+
+A rehearsal measures the times for you. At the end it offers them rounded to 15 seconds; change any of them before you save.
+:::
+
+---
+:::meta
+time: 1m30s
+:::
 # Which part will you try first?
 
 <poll room="tour" options="Writing|Layouts|Drawing|Polls" />
@@ -393,7 +469,34 @@ One line makes a poll; the heading is the question:
 
 `<poll room="tour" options="Writing|Layouts|Drawing|Polls" />`
 
-Phones join with the QR code. They can reach this computer when you start `mdeck run slides.md --network`. The poll example shows scales, word clouds and open questions.
+Phones join with the QR code. They can reach this computer when you start `mdeck run slides.md --network`.
+:::
+
+---
+:::meta
+layout: split
+time: 1m
+:::
+# One word from everyone
+:::slot left
+```markdown
+<wordcloud room="mood"
+  qr="false" />
+
+<scale room="pace" min="1" max="5"
+  low="Too slow" high="Too fast" />
+
+<question room="ask" />
+```
+:::
+:::slot right
+<wordcloud room="mood" placeholder="One word" qr="false" />
+:::
+
+:::notes
+Phones that joined with the poll's code stay in: `qr="false"` leaves the code out here. Answers appear as they come in.
+
+Besides polls and word clouds there are ratings (`<scale>`), numbers with a right answer (`<numeric>`) and open questions (`<question>`). With several of them, `<qrcode join />` on an early slide shows the code once. `mdeck run` keeps the answers in `slides.results.json` beside the deck.
 :::
 
 ---
@@ -402,12 +505,14 @@ layout: chapter
 number: 4
 part: Sharing
 description: One file to send, a PDF, or a folder for a website.
+time: 15s
 :::
 # Share it.
 
 ---
 :::meta
 layout: split
+time: 45s
 :::
 # Change the whole look
 :::slot left
@@ -431,6 +536,7 @@ mdeck has four built-in themes and five palettes, each light or dark. `mdeck lis
 ---
 :::meta
 layout: split
+time: 45s
 :::
 # Send it, print it, host it
 :::slot left
@@ -449,6 +555,7 @@ mdeck build slides.md
 ---
 :::meta
 layout: title
+time: 1m
 :::
 # Now make your own.
 ## Hand your slides, documents or notes to an *AI assistant*.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mdeck",
-  "version": "3.10.1",
+  "version": "3.11.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",

package/skills/write-slides/SKILL.md

@@ -18,7 +18,7 @@ The mdeck docs are the source of truth for syntax, layouts and looks. Look for t
 1. `docs/reference/` in the current folder (you are inside the mdeck repository).
 2. `$(npm root -g)/mdeck/docs/reference/` (mdeck is installed globally).
 
-Read `examples/showcase/slides.md` from the same place as a complete working deck.
+Read `examples/showcase/slides.en.md` from the same place as a complete working deck.
 
 Then ask the installed mdeck what this deck can use, because a deck may ship its own layouts, themes and palettes in an `extensions/` folder:
 
@@ -92,6 +92,7 @@ Right column
 ```
 
 - Slides are separated by `---` on its own line. Settings go in a `:::meta` block at the top of a slide.
+- `time: 2m` in a slide's settings (or `90s`, `1m30s`) is how long to spend on it; `time: 20m` in the deck settings is the length of the talk. Add times only when asked for a talk of a given length.
 - Built-in layouts: `title`, `chapter`, `focus` (one big statement), `image-text`, `split`, `full-bleed-image`, and plain content slides without a `layout:`.
 - 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.
@@ -127,6 +128,14 @@ The request is the message that invoked this skill: usually source material to t
 - Keep lists to three to five items; prefer a short bold label plus one sentence over long bullets.
 - Reference pictures under `./img/` and say which files the user still needs to add.
 
+**Diagrams**
+- When a slide explains a process, a structure or a comparison that the material shows as a figure, or that no picture shows yet, draw it as an SVG file in `./img/` and put it on the slide like a picture. Keep a diagram from the material where it is a photograph, a plot of real data or a figure you cannot redraw faithfully.
+- Colour it only with the palette's names, each with a fallback: `fill="var(--accent, #1f3fd1)"`, `var(--ink, #222)` for text and lines, `var(--surface, #eef1fb)` for boxes, `var(--muted, #667)` for what is secondary. Then it follows the theme, the palette and dark mode. Give the background no fill, and text a font size near the slide's (24–36 px at the drawing's own scale), with a `viewBox` and room around the text.
+- Start every rule in its `<style>` with a class of its own (`.flow-box`), never a bare `text` or `rect`: the drawing is part of the page, and such a rule changes every drawing on it. Markers, gradients and `<use>` with ids work.
+- For a diagram that builds up, number its parts with `data-step="1"`, `"2"` …; parts with the same number appear together, in the order of the numbers, not of the file. With `hotspots`, `data-hotspot` on a group lets the presenter zoom to it. Mention the steps in the notes.
+- On a slide of its own, a diagram goes in a layout's `image` with `fit: contain`, or alone in the slide text.
+- `mdeck check` names fixed colours, missing fallbacks and rules that reach the page; fix them. Then look at the slide with `mdeck snapshot`, in light and `--dark`.
+
 ## 4. Check and hand over
 
 Save the deck as a `.md` file named after the topic (for example `enzyme-kinetics.md`), then run:

package/src/build/check.js

@@ -11,12 +11,18 @@ import { collectLocalAssetRefs } from './slidesPlugin.js'
 import { componentFolders, isFolder } from './components.js'
 import { inkFileFor, validateInk, normalizeInk, orphanIds } from '../core/ink.js'
 import { resolveBibliography } from './bibliography.js'
+import { svgProblems } from './svgCheck.js'
 
 export function checkDeck(slidesPath, registry, source = readFileSync(slidesPath, 'utf8')) {
   const deck = parseSlides(source)
   const diagnostics = validateDeck(deck, { layouts: manifestsOf(registry, 'layout'), themes: manifestsOf(registry, 'theme'), palettes: manifestsOf(registry, 'palette') })
   for (const ref of collectLocalAssetRefs(source)) {
-    if (!existsSync(resolve(dirname(resolve(slidesPath)), ref))) diagnostics.push({ severity: 'error', code: 'missing-asset', message: `Missing local asset: ${ref}`, line: 1, column: 1 })
+    const file = resolve(dirname(resolve(slidesPath)), ref)
+    if (!existsSync(file)) { diagnostics.push({ severity: 'error', code: 'missing-asset', message: `Missing local asset: ${ref}`, line: 1, column: 1 }); continue }
+    if (!/\.svg$/i.test(ref)) continue
+    const at = source.indexOf(ref)
+    const line = at < 0 ? 1 : source.slice(0, at).split('\n').length
+    for (const problem of svgProblems(readFileSync(file, 'utf8'))) diagnostics.push({ severity: 'warning', code: problem.code, message: `${ref} ${problem.message}`, line, column: 1 })
   }
   for (const folder of componentFolders(slidesPath, source).filter(folder => folder.source === 'shared')) {
     if (!isFolder(folder.dir)) diagnostics.push({ severity: 'error', code: 'missing-components', message: `Components folder not found: ${folder.path} (${folder.dir})`, line: 1, column: 1 })

package/src/build/config.js

@@ -29,6 +29,8 @@ function preactAliases() {
     }
     aliases.push({ find: new RegExp(`^${spec.replace(/\//g, '\\/')}$`), replacement: file })
   }
+  // What deck components may use from mdeck (src/runtime/component.js).
+  aliases.push({ find: /^mdeck\/component$/, replacement: fileURLToPath(new URL('../runtime/component.js', import.meta.url)) })
   return aliases
 }
 

package/src/build/slidesPlugin.js

@@ -5,7 +5,7 @@ import { validateDeck, formatDiagnostics } from '../core/validateDeck.js'
 import { loadRegistry, extensionRoots, manifestsOf } from '../extensions/discover.js'
 import { resolvePalette } from '../extensions/appearance.js'
 import { embedFonts } from './fonts.js'
-import { stripNotes as stripNotesFrom, stripActivities as stripActivitiesFrom } from '../core/editDeck.js'
+import { stripNotes as stripNotesFrom, shareSlides } from '../core/editDeck.js'
 import { componentFolders, componentFiles } from './components.js'
 import { inkFileFor, normalizeInk, emptyInk } from '../core/ink.js'
 import { resultsFileFor, normalizeResults } from '../core/results.js'
@@ -230,13 +230,13 @@ export function deckLanguages(abs) {
 // the deck's text where there is no file (`mdeck design`, on the sample deck);
 // `slidesPath` then only says where its folder is. `languages` also brings
 // the deck's other languages along, for `mdeck run`; a built file has one.
-export function slidesPlugin(slidesPath, { languages = false, inlineImages = false, inlineMedia = false, editor = false, stripNotes = false, stripActivities = false, ink = true, results = true, embedFonts: embedThemeFonts = false, deckLook = false, source: given = null } = {}) {
+export function slidesPlugin(slidesPath, { languages = false, inlineImages = false, inlineMedia = false, editor = false, stripNotes = false, stripActivities = false, slides = null, ink = true, results = true, embedFonts: embedThemeFonts = false, deckLook = false, source: given = null } = {}) {
   const abs = resolve(slidesPath)
   const readDeck = () => given ?? readFileSync(abs, 'utf-8')
   const watchDeck = context => { if (given === null) context.addWatchFile(abs) }
   const sourceFor = raw => {
     const shared = stripNotes ? stripNotesFrom(raw) : raw
-    return stripActivities ? stripActivitiesFrom(shared).source : shared
+    return stripActivities || slides ? shareSlides(shared, { activities: stripActivities, slides }).source : shared
   }
   const inkPath = inkFileFor(abs)
   // The language the file name gives, for a deck that sets no `lang`.
@@ -346,10 +346,10 @@ export function slidesPlugin(slidesPath, { languages = false, inlineImages = fal
         if (ink && existsSync(inkPath)) {
           try { data = normalizeInk(JSON.parse(readFileSync(inkPath, 'utf-8')), size) } catch (error) { this.warn(`${inkPath}: ${error.message}; showing no ink`) }
         }
-        // Without the activity slides, drawings follow their slides to their new ids.
-        if (stripActivities) {
+        // Without the activity slides or those not chosen, drawings follow their slides to their new ids.
+        if (stripActivities || slides) {
           try {
-            const { ids, removed } = stripActivitiesFrom(readDeck())
+            const { ids, removed } = shareSlides(readDeck(), { activities: stripActivities, slides })
             const gone = new Set(removed)
             data = { ...data, slides: Object.fromEntries(Object.entries(data.slides).filter(([id]) => !gone.has(id)).map(([id, strokes]) => [ids[id] ?? id, strokes])) }
           } catch {}

package/src/build/svgCheck.js

@@ -0,0 +1,65 @@
+// What `mdeck check` says about the deck's SVG drawings. A drawing that uses
+// the palette (var(--…)) is drawn into the page, where it should follow the
+// palette everywhere, work without it, and leave the rest of the page alone.
+// One that does not is shown as a picture and cannot build up or be zoomed to.
+
+const COLOUR_ATTRIBUTE = /\s(fill|stroke|stop-color|flood-color|lighting-color|color)\s*=\s*(["'])([^"']*)\2/gi
+const COLOUR_PROPERTY = /(?<![\w-])(fill|stroke|stop-color|flood-color|lighting-color|color)\s*:\s*([^;}"']+)/gi
+const FOLLOWS = /^(none|transparent|currentcolor|inherit|initial|unset|context-fill|context-stroke)$|^(var|url)\(/i
+
+// [{ code, message }] for one drawing's markup.
+export function svgProblems(markup) {
+  markup = markup.replace(/<!--[\s\S]*?-->/g, '')
+  const problems = []
+  const themed = /var\(--/.test(markup)
+  const steps = [...markup.matchAll(/\sdata-step(?:\s*=\s*(["'])([^"']*)\1)?/g)].map(match => (match[2] ?? '').trim())
+  if (!themed) {
+    if (steps.length || /\sdata-hotspot\b/.test(markup)) problems.push({ code: 'svg-not-inline', message: 'has data-step or data-hotspot, but uses no palette colour (var(--…)), so it is shown as a picture and they do nothing; give one colour as var(--ink, #222)' })
+    return problems
+  }
+  const bare = [...markup.matchAll(/var\(\s*(--[\w-]+)\s*\)/g)].map(match => match[1])
+  if (bare.length) problems.push({ code: 'svg-fallback', message: `uses ${unique(bare).map(name => `var(${name})`).join(', ')} without a fallback, which shows nothing where the drawing is opened on its own; write var(${bare[0]}, #…)` })
+  const fixed = [
+    ...[...markup.matchAll(COLOUR_ATTRIBUTE)].map(match => [match[1], match[3].trim()]),
+    ...[...styleText(markup).matchAll(COLOUR_PROPERTY), ...inlineStyles(markup).flatMap(style => [...style.matchAll(COLOUR_PROPERTY)])].map(match => [match[1], match[2].trim()]),
+  ].filter(([, value]) => value && !FOLLOWS.test(value))
+  if (fixed.length) {
+    const examples = unique(fixed.map(([name, value]) => `${name}="${value}"`)).slice(0, 3).join(', ')
+    problems.push({ code: 'svg-fixed-colour', message: `has ${fixed.length === 1 ? 'a fixed colour' : `${fixed.length} fixed colours`} (${examples}) that stay${fixed.length === 1 ? 's' : ''} the same in every palette and in dark mode; use var(--ink, …) or another palette colour where it should follow` })
+  }
+  const unscoped = unique(selectors(styleText(markup)).filter(selector => !selector.startsWith('.')))
+  if (unscoped.length) problems.push({ code: 'svg-style', message: `has style rules that reach the whole page (${unscoped.slice(0, 3).join(', ')}), its icons, QR codes and other drawings included; start each with a class of this drawing, such as .flow-` })
+  if (steps.some(Boolean) && steps.some(step => !step)) problems.push({ code: 'svg-steps', message: 'has numbered and bare data-step parts: the numbered ones show together in their order, the bare ones in document order. Number all of them' })
+  return problems
+}
+
+const unique = items => [...new Set(items)]
+
+const styleText = markup => [...markup.matchAll(/<style\b[^>]*>([\s\S]*?)<\/style>/gi)].map(match => match[1].replace(/<!\[CDATA\[|\]\]>/g, '')).join('\n')
+const inlineStyles = markup => [...markup.matchAll(/\sstyle\s*=\s*(["'])([^"']*)\1/gi)].map(match => match[2])
+
+// The selectors of a stylesheet's rules, also inside @media; not the steps
+// of @keyframes.
+function selectors(css) {
+  css = css.replace(/\/\*[\s\S]*?\*\//g, '')
+  const found = []
+  let depth = 0
+  let skipUntil = -1
+  let start = 0
+  for (let i = 0; i < css.length; i++) {
+    if (css[i] === '{') {
+      const prelude = css.slice(start, i).trim()
+      if (skipUntil < 0) {
+        if (/^@keyframes\b|^@font-face\b/i.test(prelude)) skipUntil = depth
+        else if (prelude && !prelude.startsWith('@')) found.push(...prelude.split(',').map(s => s.trim()).filter(Boolean))
+      }
+      depth++
+      start = i + 1
+    } else if (css[i] === '}') {
+      depth--
+      if (depth === skipUntil) skipUntil = -1
+      start = i + 1
+    } else if (css[i] === ';' && depth === 0) start = i + 1
+  }
+  return found
+}

package/src/build/timingPlugin.js

@@ -0,0 +1,80 @@
+// Saving a rehearsal's times while `mdeck run` runs: the presenter view
+// sends each slide's new time, and it goes into the slide's settings as
+// `time: 1m30s` (core/timing.js). null takes a slide's time out.
+//
+//   GET  /__mdeck/timing   → { ids }
+//   POST /__mdeck/timing   { ids, times: { [slideId]: '1m30s' | null } } → { ok, changed }
+//
+// Slides without an `id:` are named by position (slide-3), so the times are
+// only written when the deck still has the slides the page saw (`ids`);
+// otherwise the answer is 409. The deck is copied to .mdeck-backups/ before
+// the first write, and the write does not reload the open windows
+// (ownWrites.js).
+import { readFileSync, writeFileSync, renameSync } from 'node:fs'
+import { resolve } from 'node:path'
+import { parseSlides } from '../core/parseSlides.js'
+import { setSlideMeta } from '../core/editDeck.js'
+import { parseTime, formatTime } from '../core/timing.js'
+import { isAllowedRequest, send, readJson, backupDeck } from './editorPlugin.js'
+import { markOwnWrite } from './ownWrites.js'
+
+export function createTimingFile(deckPath) {
+  const abs = resolve(deckPath)
+  let backedUp = false
+  const read = () => { const source = readFileSync(abs, 'utf8'); return { source, deck: parseSlides(source) } }
+
+  return {
+    path: abs,
+    ids: () => read().deck.slides.map(slide => slide.id),
+    save(ids, times) {
+      let { source, deck } = read()
+      const current = deck.slides.map(slide => slide.id)
+      if (!Array.isArray(ids) || ids.join('\n') !== current.join('\n')) return { status: 409, error: 'The deck changed since the rehearsal began; rehearse again', ids: current }
+      const before = source
+      let changed = 0
+      for (const [id, value] of Object.entries(times ?? {})) {
+        if (!current.includes(id)) return { status: 400, error: `No slide "${id}" in the deck` }
+        const seconds = value == null ? null : parseTime(value)
+        if (value != null && seconds == null) return { status: 400, error: `"${value}" is not a time` }
+        const time = seconds == null ? undefined : formatTime(seconds)
+        if (deck.slides.find(slide => slide.id === id).meta.time === time) continue
+        source = setSlideMeta(deck, id, { time })
+        deck = parseSlides(source)
+        changed++
+      }
+      if (source === before) return { status: 200, ok: true, changed: 0 }
+      if (!backedUp) { backupDeck(abs, before); backedUp = true }
+      markOwnWrite(abs, source)
+      const temp = `${abs}.${process.pid}.tmp`
+      writeFileSync(temp, source, 'utf8')
+      renameSync(temp, abs)
+      return { status: 200, ok: true, changed }
+    },
+  }
+}
+
+export function timingMiddleware(file, { authorize = isAllowedRequest } = {}) {
+  return async (request, response, next) => {
+    const { pathname } = new URL(request.url, 'http://localhost')
+    if (pathname !== '/') return next()
+    if (!authorize(request)) return send(response, 403, { error: 'Only the presenter can save times' })
+    try {
+      if (request.method === 'GET') return send(response, 200, { ids: file.ids() })
+      if (request.method !== 'POST') { response.setHeader('Allow', 'GET, POST'); return send(response, 405, { error: 'Method not allowed' }) }
+      const { ids, times } = await readJson(request)
+      const { status, ...result } = file.save(ids, times)
+      return send(response, status, result)
+    } catch (error) {
+      return send(response, error.status ?? 500, { error: error.message })
+    }
+  }
+}
+
+export function timingPlugin(slidesPath, { authorize } = {}) {
+  return {
+    name: 'vite-plugin-mdeck-timing',
+    configureServer(server) {
+      server.middlewares.use('/__mdeck/timing', timingMiddleware(createTimingFile(slidesPath), { authorize }))
+    },
+  }
+}

package/src/cli/args.js

@@ -5,13 +5,14 @@ const output = { '--output': value, '-o': '--output', '--no-drawings': flag, '--
 const commands = {
   new: { max: 0 },
   run: { ...common, '--network': flag, '--server': optional, max: 1 },
+  rehearse: { ...common, '--network': flag, '--server': optional, max: 1 },
   edit: { ...common, max: 1 },
   design: { ...common, max: 1 },
   themes: { '--local': flag, '--force': flag, '--check': flag, '--output': value, '-o': '--output', max: 4 },
   palettes: { '--local': flag, '--force': flag, max: 4 },
-  build: { ...output, '--single-file': flag, '--launchers': flag, '--reader': flag, '--notes': flag, '--no-polls': flag, max: 1 },
-  send: { ...output, '--notes': flag, '--no-polls': flag, '--no-pdf': flag, max: 1 },
-  pdf: { ...output, '--no-polls': flag, max: 1 },
+  build: { ...output, '--single-file': flag, '--launchers': flag, '--reader': flag, '--notes': flag, '--no-polls': flag, '--slide': value, max: 1 },
+  send: { ...output, '--notes': flag, '--no-polls': flag, '--no-pdf': flag, '--slide': value, max: 1 },
+  pdf: { ...output, '--no-polls': flag, '--slide': value, max: 1 },
   preview: { ...common, max: 1 },
   check: { '--strict': flag, '--render': flag, max: 1 },
   snapshot: { '--output': value, '-o': '--output', '--slide': value, '--dark': flag, '--light': flag, '--sheet': flag, max: 1 },