mdeck 3.10.1 → 3.12.0

package/src/core/icons.js

@@ -5,6 +5,7 @@
 // markup of the Lucide SVG.
 
 export const ICONS = {
+  home: '<path d="M15 21v-8a1 1 0 0 0-1-1h-4a1 1 0 0 0-1 1v8"/><path d="M3 10a2 2 0 0 1 .709-1.528l7-5.999a2 2 0 0 1 2.582 0l7 5.999A2 2 0 0 1 21 10v9a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2z"/>', // house
   presenter: '<path d="M2 3h20"/><path d="M21 3v11a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V3"/><path d="m7 21 5-5 5 5"/>', // presentation
   projector: '<path d="M5 7 3 5"/><path d="M9 6V3"/><path d="m13 7 2-2"/><circle cx="9" cy="13" r="3"/><path d="M11.83 12H20a2 2 0 0 1 2 2v4a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2v-4a2 2 0 0 1 2-2h2.17"/><path d="M16 16h2"/>', // projector
   reader: '<path d="M12 5v16"/><path d="M20.001 19A2 2 0 0022 17V5a2 2 0 00-1.999-2L16 3.002A5 5 0 0012 5a5 5 0 00-4-2H4a2 2 0 00-2 2v12a2 2 0 001.999 2H8a5 5 0 014 2 5 5 0 014-2z"/>', // book-open
@@ -26,6 +27,7 @@ export const ICONS = {
   up: '<path d="m5 12 7-7 7 7"/><path d="M12 19V5"/>', // arrow-up
   down: '<path d="M12 5v14"/><path d="m19 12-7 7-7-7"/>', // arrow-down
   add: '<path d="M5 12h14"/><path d="M12 5v14"/>', // plus
+  remove: '<path d="M5 12h14"/>', // minus
   close: '<path d="M18 6 6 18"/><path d="m6 6 12 12"/>', // x
   grid: '<rect width="7" height="7" x="3" y="3" rx="1"/><rect width="7" height="7" x="14" y="3" rx="1"/><rect width="7" height="7" x="14" y="14" rx="1"/><rect width="7" height="7" x="3" y="14" rx="1"/>', // layout-grid
   menu: '<path d="M4 5h16"/><path d="M4 12h16"/><path d="M4 19h16"/>', // menu
@@ -48,11 +50,14 @@ export const ICONS = {
   highlighter: '<path d="m9 11-6 6v3h9l3-3"/><path d="m22 12-4.6 4.6a2 2 0 0 1-2.8 0l-5.2-5.2a2 2 0 0 1 0-2.8L14 4"/>', // highlighter
   marker: '<path d="M11.017 2.814a1 1 0 0 1 1.966 0l1.051 5.558a2 2 0 0 0 1.594 1.594l5.558 1.051a1 1 0 0 1 0 1.966l-5.558 1.051a2 2 0 0 0-1.594 1.594l-1.051 5.558a1 1 0 0 1-1.966 0l-1.051-5.558a2 2 0 0 0-1.594-1.594l-5.558-1.051a1 1 0 0 1 0-1.966l5.558-1.051a2 2 0 0 0 1.594-1.594z"/><path d="M20 2v4"/><path d="M22 4h-4"/><circle cx="4" cy="20" r="2"/>', // sparkles
   select: '<path d="M5 3a2 2 0 0 0-2 2"/><path d="M19 3a2 2 0 0 1 2 2"/><path d="M21 19a2 2 0 0 1-2 2"/><path d="M5 21a2 2 0 0 1-2-2"/><path d="M9 3h1"/><path d="M9 21h1"/><path d="M14 3h1"/><path d="M14 21h1"/><path d="M3 9v1"/><path d="M21 9v1"/><path d="M3 14v1"/><path d="M21 14v1"/>', // square-dashed
-  laser: '<line x1="2" x2="5" y1="12" y2="12"/><line x1="19" x2="22" y1="12" y2="12"/><line x1="12" x2="12" y1="2" y2="5"/><line x1="12" x2="12" y1="19" y2="22"/><circle cx="12" cy="12" r="7"/><circle cx="12" cy="12" r="3"/>', // locate-fixed
+  laser: '<rect width="5" height="13" x="3.5" y="9.5" rx="2.5" transform="rotate(45 6 16)"/><path d="m11.5 12.5 3-3" stroke-dasharray="0.1 2.6"/><circle cx="17.5" cy="6.5" r="3"/><path d="M17.5 1v0.5"/><path d="M23 6.5h-.5"/><path d="m21.4 2.6-.35.35"/>', // drawn for mdeck on Lucide's grid: a laser pointer (Lucide has none; its "locate" read as a map pin)
   fold: '<path d="m7 7 10 10"/><path d="M17 7v10H7"/>', // arrow-down-right
   eraser: '<path d="M21 21H8a2 2 0 0 1-1.42-.587l-3.994-3.999a2 2 0 0 1 0-2.828l10-10a2 2 0 0 1 2.829 0l5.999 6a2 2 0 0 1 0 2.828L12.834 21"/><path d="m5.082 11.09 8.828 8.828"/>', // eraser
+  join: '<rect width="5" height="5" x="3" y="3" rx="1"/><rect width="5" height="5" x="16" y="3" rx="1"/><rect width="5" height="5" x="3" y="16" rx="1"/><path d="M21 16h-3a2 2 0 0 0-2 2v3"/><path d="M21 21v.01"/><path d="M12 7v3a2 2 0 0 1-2 2H7"/><path d="M3 12h.01"/><path d="M12 3h.01"/><path d="M12 16v.01"/><path d="M16 12h1"/><path d="M21 12v.01"/><path d="M12 21v-1"/>', // qr-code
+  settings: '<line x1="21" x2="14" y1="4" y2="4"/><line x1="10" x2="3" y1="4" y2="4"/><line x1="21" x2="12" y1="12" y2="12"/><line x1="8" x2="3" y1="12" y2="12"/><line x1="21" x2="16" y1="20" y2="20"/><line x1="12" x2="3" y1="20" y2="20"/><line x1="14" x2="14" y1="2" y2="6"/><line x1="8" x2="8" y1="10" y2="14"/><line x1="16" x2="16" y1="18" y2="22"/>', // sliders-horizontal
   people: '<path d="M16 21v-2a4 4 0 0 0-4-4H6a4 4 0 0 0-4 4v2"/><path d="M16 3.128a4 4 0 0 1 0 7.744"/><path d="M22 21v-2a4 4 0 0 0-3-3.87"/><circle cx="9" cy="7" r="4"/>', // users
   tablet: '<rect width="16" height="20" x="4" y="2" rx="2" ry="2"/><line x1="12" x2="12.01" y1="18" y2="18"/>', // tablet
+  phone: '<rect width="14" height="20" x="5" y="2" rx="2" ry="2"/><path d="M12 18h.01"/>', // smartphone
   speaker: '<rect width="18" height="18" x="3" y="3" rx="2"/><path d="M15 3v18"/>', // panel-right
   fullscreen: '<path d="M8 3H5a2 2 0 0 0-2 2v3"/><path d="M21 8V5a2 2 0 0 0-2-2h-3"/><path d="M3 16v3a2 2 0 0 0 2 2h3"/><path d="M16 21h3a2 2 0 0 0 2-2v-3"/>', // maximize
   sun: '<circle cx="12" cy="12" r="4"/><path d="M12 2v2"/><path d="M12 20v2"/><path d="m4.93 4.93 1.41 1.41"/><path d="m17.66 17.66 1.41 1.41"/><path d="M2 12h2"/><path d="M20 12h2"/><path d="m6.34 17.66-1.41 1.41"/><path d="m19.07 4.93-1.41 1.41"/>', // sun
@@ -60,6 +65,9 @@ export const ICONS = {
   'fullscreen-exit': '<path d="M8 3v3a2 2 0 0 1-2 2H3"/><path d="M21 8h-3a2 2 0 0 1-2-2V3"/><path d="M3 16h3a2 2 0 0 1 2 2v3"/><path d="M16 21v-3a2 2 0 0 1 2-2h3"/>', // minimize
   play: '<path d="M5 5a2 2 0 0 1 3.008-1.728l11.997 6.998a2 2 0 0 1 .003 3.458l-12 7A2 2 0 0 1 5 19z"/>', // play
   hotspots: '<path d="M3 7V5a2 2 0 0 1 2-2h2"/><path d="M17 3h2a2 2 0 0 1 2 2v2"/><path d="M21 17v2a2 2 0 0 1-2 2h-2"/><path d="M7 21H5a2 2 0 0 1-2-2v-2"/><circle cx="12" cy="12" r="3"/><path d="m16 16-1.9-1.9"/>', // scan-search
+  rehearse: '<line x1="10" x2="14" y1="2" y2="2"/><line x1="12" x2="15" y1="14" y2="11"/><circle cx="12" cy="14" r="8"/>', // timer
+  blank: '<path d="M17 17H4a2 2 0 0 1-2-2V5c0-1.5 1-2 1-2"/><path d="M22 15V5a2 2 0 0 0-2-2H9"/><path d="M8 21h8"/><path d="M12 17v4"/><path d="m2 2 20 20"/>', // monitor-off
+  overview: '<rect width="18" height="14" x="3" y="3" rx="2"/><path d="M4 21h1"/><path d="M9 21h1"/><path d="M14 21h1"/><path d="M19 21h1"/>', // gallery-horizontal-end
   pause: '<rect x="14" y="3" width="5" height="18" rx="1"/><rect x="5" y="3" width="5" height="18" rx="1"/>', // pause
   loading: '<path d="M21 12a9 9 0 1 1-6.219-8.56"/>', // loader-circle
 }

package/src/core/labels.js

@@ -51,6 +51,7 @@ export const LABELS = {
     'respond.waiting': 'The next question will appear here.',
     'respond.send': 'Send',
     'respond.sent': 'Sent. Thank you!',
+    'respond.react': 'React',
     'join.scan': 'Scan to join',
     'follow.scan': 'Scan to follow the slides',
     'follow.open': 'Follow the slides',
@@ -124,6 +125,7 @@ export const LABELS = {
     'respond.waiting': 'Die nächste Frage erscheint hier.',
     'respond.send': 'Senden',
     'respond.sent': 'Gesendet. Danke!',
+    'respond.react': 'Reagieren',
     'join.scan': 'Scannen und mitmachen',
     'follow.scan': 'Scannen und Folien mitverfolgen',
     'follow.open': 'Folien mitverfolgen',
@@ -151,6 +153,80 @@ export const LABELS = {
     'question.empty': 'Hier erscheinen die Antworten.',
     'scale.average': 'Durchschnitt {n}',
   },
+  ar: {
+    'reader.outline': 'المخطط',
+    'reader.untitled': 'الشرائح',
+    'reader.slides': 'الشرائح',
+    'reader.read': 'قراءة',
+    'reader.appearance': 'فاتح أو داكن',
+    'reader.light': 'فاتح',
+    'reader.dark': 'داكن',
+    'reader.drawings': 'الرسوم',
+    'reader.hideDrawings': 'إخفاء الرسوم',
+    'reader.showDrawings': 'إظهار الرسوم',
+    'reader.downloadPdf': 'تنزيل PDF',
+    'reader.savePdf': 'حفظ بصيغة PDF…',
+    'reader.savePdfHint': 'يفتح نافذة الطباعة في المتصفح؛ اختر الحفظ بصيغة PDF',
+    'reader.present': 'عرض',
+    'reader.previous': 'السابق',
+    'reader.next': 'التالي',
+    'reader.copyLink': 'نسخ رابط هذه الشريحة',
+    'reader.linkCopied': 'نُسخ الرابط',
+    'reader.slide': 'الشريحة {n}',
+    'deck.overview': 'نظرة عامة',
+    'slide.chapter': 'الفصل',
+    'deck.controls': 'أدوات التحكم في العرض',
+    'deck.previous': 'الشريحة السابقة',
+    'deck.next': 'الشريحة التالية',
+    'deck.reset': 'من البداية',
+    'deck.resetHint': 'العودة إلى الشريحة الأولى',
+    'poll.scan': 'امسح الرمز للتصويت',
+    'video.sound': 'انقر لتشغيل الصوت',
+    'poll.answer': 'إجابة واحدة',
+    'poll.answers': '{n} إجابات',
+    'poll.reset': 'من البداية',
+    'poll.showAnswer': 'إظهار الإجابة الصحيحة',
+    'poll.hideAnswer': 'إخفاء الإجابة الصحيحة',
+    'poll.showResults': 'إظهار النتائج',
+    'poll.hideResults': 'إخفاء النتائج',
+    'poll.live': 'مباشر',
+    'poll.offline': 'غير متصل بالخادم',
+    'poll.unreachable': 'لا تستطيع الهواتف الوصول إلى هذا الحاسوب. ابدأ بالأمر {command}، أو اضبط {setting}.',
+    'poll.tryHere': 'جرّب صفحة الإجابة هنا',
+    'poll.static': 'أُجيب عنه مباشرة أثناء المحاضرة.',
+    'poll.pick': 'اختر إجابة واحدة.',
+    'poll.thanks': 'شكرًا! اخترت «{choice}». اختر غيرها لتغيير إجابتك.',
+    'respond.waiting': 'سيظهر السؤال التالي هنا.',
+    'respond.send': 'إرسال',
+    'respond.sent': 'أُرسلت. شكرًا لك!',
+    'respond.react': 'تفاعل',
+    'join.scan': 'امسح الرمز للانضمام',
+    'follow.scan': 'امسح الرمز لمتابعة الشرائح',
+    'follow.open': 'متابعة الشرائح',
+    'follow.live': 'مباشر',
+    'follow.back': 'العودة إلى البث المباشر',
+    'follow.waiting': 'لم تبدأ المحاضرة بعد.',
+    'follow.tryHere': 'جرّب المتابعة هنا',
+    'join.static': 'أثناء المحاضرة انضمت الهواتف من هنا للإجابة.',
+    'poll.answeredOf': 'أجاب {n} من {of}',
+    'poll.close': 'إغلاق: لا تُحتسب الإجابات اللاحقة',
+    'poll.open': 'فتح من جديد',
+    'poll.closed': 'مغلق',
+    'poll.several': 'يمكن اختيار أكثر من إجابة.',
+    'poll.pickSeveral': 'اختر كل ما ينطبق.',
+    'poll.thanksSeveral': 'شكرًا! اخترت {choice}. اختر مجددًا للتغيير.',
+    'respond.closed': 'أُغلق: لا مزيد من الإجابات.',
+    'respond.right': 'صحيح!',
+    'respond.wrong': 'ليس تمامًا. الإجابة الصحيحة: {answer}',
+    'respond.solution': 'الإجابة الصحيحة: {answer}',
+    'numeric.placeholder': 'رقم',
+    'numeric.invalid': 'أدخل رقمًا، مثل 0.5 أو 1/2.',
+    'numeric.sent': 'أُرسل: {value}. أرسل رقمًا آخر للتغيير.',
+    'numeric.other': 'أخرى',
+    'numeric.right': '{n} صحيحة',
+    'question.empty': 'تظهر الإجابات هنا.',
+    'scale.average': 'المتوسط {n}',
+  },
 }
 
 export const LABEL_KEYS = Object.keys(LABELS.en)
@@ -162,6 +238,8 @@ export const CALLOUT_LABELS = {
     definition: 'Definition', theorem: 'Theorem', lemma: 'Lemma', corollary: 'Corollary', proof: 'Proof', example: 'Example', remark: 'Remark' },
   de: { note: 'Hinweis', tip: 'Tipp', important: 'Wichtig',   warning: 'Achtung', caution: 'Vorsicht',
     definition: 'Definition', theorem: 'Satz',    lemma: 'Lemma', corollary: 'Korollar',  proof: 'Beweis', example: 'Beispiel', remark: 'Bemerkung' },
+  ar: { note: 'ملاحظة', tip: 'نصيحة', important: 'مهم', warning: 'تحذير', caution: 'انتبه',
+    definition: 'تعريف', theorem: 'مبرهنة', lemma: 'تمهيدية', corollary: 'نتيجة', proof: 'برهان', example: 'مثال', remark: 'ملحوظة' },
 }
 
 export const CALLOUT_TYPES = Object.keys(CALLOUT_LABELS.en)

package/src/core/parseSlides.js

@@ -1,9 +1,9 @@
 import yaml from 'js-yaml'
-import { sourceLines, fenceState, scanDirectives, diagnostic } from './source.js'
+import { sourceLines, fenceState, scanDirectives, diagnostic, isIncludeLine } from './source.js'
 export { sourceLines, fenceState } from './source.js'
 
-export const DECK_KEYS = new Set('theme palette appearance params meta width height show lang labels callouts reader components server session bibliography csl nocite hotspots'.split(' '))
-export const SLIDE_KEYS = new Set('layout id title section number part description label image alt overlay eyebrow attribution props hotspots'.split(' '))
+export const DECK_KEYS = new Set('theme palette appearance params meta width height show lang labels callouts reader components server session bibliography csl nocite hotspots time reactions'.split(' '))
+export const SLIDE_KEYS = new Set('layout id title section number part description label image alt overlay eyebrow attribution props hotspots time'.split(' '))
 
 // Names from before 2.0. They are still recognised, so that an old deck gets a
 // message naming the new setting (see validateDeck) instead of being read as
@@ -32,7 +32,7 @@ function segmentsOf(source) {
     const before = fence
     fence = fenceState(line.text, fence)
     if (before || fence) continue
-    if (/^:::\s*[\w-]+/.test(line.text)) depth++
+    if (/^:::\s*[\w-]+/.test(line.text) && !isIncludeLine(line.text)) depth++
     else if (/^:::\s*$/.test(line.text)) depth = Math.max(0, depth - 1)
     if (!depth && /^---[ \t]*$/.test(line.text)) {
       segments.push({ start, end: line.start, delimiterEnd: line.end })
@@ -44,7 +44,7 @@ function segmentsOf(source) {
 }
 
 // The first block is the deck's settings when its first key is only a deck
-// key. A key both may have (hotspots) leaves it to the others: a slide's own
+// key. A key both may have (hotspots, time) leaves it to the others: a slide's own
 // key makes it the first slide's, otherwise it is the deck's.
 function isDeckBlock(text) {
   const keys = sourceLines(text).map(line => line.text.match(/^([\w-]+):/)?.[1]).filter(Boolean)
@@ -103,6 +103,15 @@ function extractBody(source, body, diagnostics) {
   return { content, notes: notes.join('\n\n'), regions, blocks }
 }
 
+// What a slide that is nothing but `:::include <file> [slides=3-7]` includes:
+// { file, slides } (slides as written, or null), or null for any other slide.
+export function includeOf(content) {
+  const match = /^:::\s*include\s+(?:"([^"]+)"|(\S+))((?:\s+[\w-]+=\S+)*)\s*$/.exec(String(content ?? '').trim())
+  if (!match) return null
+  const options = Object.fromEntries([...match[3].matchAll(/([\w-]+)=(\S+)/g)].map(([, key, value]) => [key, value]))
+  return { file: match[1] ?? match[2], slides: options.slides ?? null, options }
+}
+
 export function parseSlides(source) {
   const segments = segmentsOf(source)
   const diagnostics = []
@@ -150,9 +159,10 @@ export function parseSlides(source) {
     // source editing and validation, separate from the resolved block notes.
     delete meta.notes
     if (notes) meta.notes = notes
+    const include = Object.keys(authoredMeta).length ? null : includeOf(content)
     slides.push({ id: meta.id ?? `slide-${slides.length + 1}`, meta, authoredMeta, content, regions, blocks,
       source: { start: segment.start, end: body?.end ?? segment.end },
-      metaSource, bodySource: body ? { start: body.start, end: body.end } : null })
+      metaSource, bodySource: body ? { start: body.start, end: body.end } : null, ...(include ? { include } : {}) })
   }
   let currentSection = null
   for (const slide of slides) {

package/src/core/reactions.js

@@ -0,0 +1,27 @@
+// Reactions: people tap an emoji on the answer page, and it floats up on the
+// presenter's screen for a moment, never on the projector. A deck turns them
+// on with `reactions: true` (the set below) or its own list of up to eight,
+// such as `reactions: [👍, 🤔, 🐢]`. They go to the session's `reactions`
+// room, which the server passes on without keeping (src/live/rooms.js).
+
+export const REACTIONS_ROOM = 'reactions'
+// 🐢: "slower, please".
+export const DEFAULT_REACTIONS = ['👍', '👏', '❤️', '😮', '🤔', '🐢']
+const MAX = 8
+const MAX_LENGTH = 16
+
+/** Whether `value` is a usable `reactions` setting; a problem as text, or null. */
+export function reactionsProblem(value) {
+  if (value == null || typeof value === 'boolean') return null
+  if (!Array.isArray(value) || !value.length || value.length > MAX) return `reactions must be true, false, or a list of 1 to ${MAX} emoji or short words`
+  const bad = value.find(item => typeof item !== 'string' && typeof item !== 'number' || !String(item).trim() || String(item).trim().length > MAX_LENGTH)
+  return bad !== undefined ? `reactions: each one is an emoji or a word of up to ${MAX_LENGTH} characters, not ${JSON.stringify(bad)}` : null
+}
+
+/** The reactions a deck offers, or null when it offers none. */
+export function reactionsOf(config) {
+  const value = config?.reactions
+  if (value === true) return DEFAULT_REACTIONS
+  if (reactionsProblem(value) || !Array.isArray(value)) return null
+  return [...new Set(value.map(item => String(item).trim()))]
+}

package/src/core/resultsReport.js

@@ -0,0 +1,153 @@
+// The answers kept in a talk (<deck>.results.json, results.js) read against
+// the deck they were given in: which slide asked, what, and how it came out.
+// `mdeck results` and the launch page export them from here, as the answers
+// one by one (CSV), one row per option, word or number (summary CSV), or
+// all of it (JSON).
+//
+// The summary counts as the slide does: for a poll, a scale, a number and a
+// word cloud, each phone's latest answer; for open questions, every answer. Phones stay numbered per question; no device ids are kept.
+import { tagsIn } from './tags.js'
+import { expandPollLists, pollChoices } from './pollList.js'
+import { choicesOf } from '../components/inlineText.js'
+import { parseNumber, groupNumbers } from '../components/numbers.js'
+
+const KINDS = { poll: 'poll', scale: 'scale', numeric: 'number', wordcloud: 'words', question: 'question' }
+
+const plain = text => String(text ?? '').replace(/\$([^$]+)\$/g, '$1').replace(/[*_`]/g, '').replace(/\s+/g, ' ').trim()
+
+function headingOf(slide) {
+  const heading = String(slide?.content ?? '').replace(/^(```|~~~)[\s\S]*?^\1/gm, '').match(/^\s*#{1,3}\s+(.+?)\s*#*\s*$/m)?.[1]
+  return heading ? plain(heading) : plain(slide?.meta?.title ?? '')
+}
+
+const scaleBounds = ({ min, max }) => {
+  const low = Number.isFinite(Number(min)) && min !== '' && min != null ? Math.round(Number(min)) : 1
+  const high = Number.isFinite(Number(max)) && max !== '' && max != null ? Math.round(Number(max)) : 5
+  return high > low && high - low <= 10 ? [low, high] : [1, 5]
+}
+
+/**
+ * The activities of a parsed deck, in order: [{ room, slide, kind, tag,
+ * question, options?, multiple?, min?, max? }]. `slide` counts from 1; a
+ * room asked on several slides is listed where it is first asked.
+ */
+export function activitiesIn(deck) {
+  const found = new Map()
+  ;(deck?.slides ?? []).forEach((slide, i) => {
+    const texts = [slide.content ?? '', ...Object.values(slide.regions ?? {}).map(region => region.content ?? '')]
+    for (const text of texts) {
+      for (const tag of tagsIn(expandPollLists(text))) {
+        const room = tag.attrs.room
+        if (tag.closing || !room || found.has(room)) continue
+        const kind = KINDS[tag.name] ?? tag.name
+        const entry = { room, slide: i + 1, kind, tag: tag.name, question: plain(tag.attrs.question) || headingOf(slide) }
+        if (tag.name === 'poll') {
+          const listed = tag.attrs['data-choices'] != null && pollChoices(tag.attrs['data-choices'])
+          entry.options = listed ? listed.map(choice => choice.text) : choicesOf(tag.attrs.options)
+          if (tag.attrs.multiple != null && tag.attrs.multiple !== 'false') entry.multiple = true
+        }
+        if (tag.name === 'scale') [entry.min, entry.max] = scaleBounds(tag.attrs)
+        found.set(room, entry)
+      }
+    }
+  })
+  return [...found.values()]
+}
+
+// Each phone's last answer, in the order the phones first answered.
+function latestPerPhone(answers) {
+  const latest = new Map()
+  for (const answer of answers) latest.set(answer.phone, answer)
+  return [...latest.values()]
+}
+
+const round = value => Math.round(value * 100) / 100
+function stats(values) {
+  if (!values.length) return {}
+  const sorted = [...values].sort((a, b) => a - b)
+  const middle = sorted.length >> 1
+  const median = sorted.length % 2 ? sorted[middle] : (sorted[middle - 1] + sorted[middle]) / 2
+  return { average: round(values.reduce((sum, value) => sum + value, 0) / values.length), median: round(median), lowest: sorted[0], highest: sorted.at(-1) }
+}
+
+/** How one activity came out: { phones, answers, counts: [{ answer, count }], average?, median?, lowest?, highest? }. */
+export function summarize(activity, answers = []) {
+  const phones = new Set(answers.map(answer => answer.phone)).size
+  const base = { phones, answers: answers.length }
+  const tag = activity?.tag
+  if (tag === 'poll') {
+    const options = activity.options ?? []
+    const votes = latestPerPhone(answers)
+      .map(answer => activity.multiple ? (Array.isArray(answer.value) ? answer.value : [answer.value]) : (Array.isArray(answer.value) ? [] : [answer.value]))
+      .map(picks => picks.filter(pick => options.includes(pick)))
+      .filter(picks => picks.length)
+    return { ...base, voted: votes.length, counts: options.map(option => ({ answer: option, count: votes.filter(picks => picks.includes(option)).length })) }
+  }
+  if (tag === 'scale') {
+    const steps = Array.from({ length: activity.max - activity.min + 1 }, (_, i) => activity.min + i)
+    const values = latestPerPhone(answers).map(answer => Number(answer.value)).filter(value => steps.includes(value))
+    return { ...base, voted: values.length, counts: steps.map(step => ({ answer: String(step), count: values.filter(value => value === step).length })), ...stats(values) }
+  }
+  if (tag === 'numeric') {
+    const texts = latestPerPhone(answers).map(answer => answer.value).filter(value => parseNumber(value) != null)
+    return { ...base, voted: texts.length, counts: groupNumbers(texts).map(group => ({ answer: group.text, count: group.n })), ...stats(texts.map(parseNumber)) }
+  }
+  // Words (each phone's latest) and open answers (every one), the same words together.
+  const counts = new Map()
+  for (const answer of tag === 'wordcloud' ? latestPerPhone(answers) : answers) {
+    const text = String(answer.value ?? '').trim().replace(/\s+/g, ' ')
+    if (!text) continue
+    const key = text.toLocaleLowerCase()
+    const entry = counts.get(key) ?? { answer: text, count: 0 }
+    entry.count++
+    counts.set(key, entry)
+  }
+  return { ...base, counts: [...counts.values()].sort((a, b) => b.count - a.count || a.answer.localeCompare(b.answer)) }
+}
+
+/**
+ * The kept answers against the deck: [{ room, slide, kind, question,
+ * closed, savedAt, summary, answers }], in the order of the slides; rooms
+ * the deck no longer asks come last, with what is known of them.
+ */
+export function resultsReport(results, deck) {
+  const rooms = results?.rooms ?? {}
+  const activities = activitiesIn(deck)
+  const asked = activities.filter(activity => rooms[activity.room])
+  const gone = Object.keys(rooms).filter(room => !activities.some(activity => activity.room === room)).map(room => ({ room, slide: null, kind: null, tag: null, question: '' }))
+  return [...asked, ...gone].map(activity => {
+    const entry = rooms[activity.room]
+    const { tag, options, multiple, min, max, ...shown } = activity
+    return { ...shown, closed: entry.closed, savedAt: entry.savedAt, summary: summarize(activity, entry.answers), answers: entry.answers }
+  })
+}
+
+const csvCell = value => {
+  const text = value == null ? '' : Array.isArray(value) ? value.join('|') : String(value)
+  return /[",\n\r]/.test(text) ? `"${text.replace(/"/g, '""')}"` : text
+}
+const csv = rows => rows.map(row => row.map(csvCell).join(',')).join('\n') + '\n'
+
+/** Every answer with its question: slide, room, kind, question, phone, time, answer (several picks joined by |). */
+export function reportAnswersCsv(report) {
+  const rows = [['slide', 'room', 'kind', 'question', 'phone', 'at', 'answer']]
+  for (const entry of report) for (const answer of entry.answers) rows.push([entry.slide, entry.room, entry.kind, entry.question, answer.phone, answer.at, answer.value])
+  return csv(rows)
+}
+
+/** One row per option, step, number or word: slide, room, kind, question, answer, count, and its share of the phones that answered. */
+export function reportSummaryCsv(report) {
+  const rows = [['slide', 'room', 'kind', 'question', 'answer', 'count', 'share']]
+  for (const entry of report) {
+    const { counts = [], voted } = entry.summary
+    const total = voted ?? counts.reduce((sum, row) => sum + row.count, 0)
+    for (const row of counts) rows.push([entry.slide, entry.room, entry.kind, entry.question, row.answer, row.count, total ? `${Math.round((row.count / total) * 100)}%` : ''])
+    for (const key of ['average', 'median']) if (entry.summary[key] != null) rows.push([entry.slide, entry.room, entry.kind, entry.question, key, entry.summary[key], ''])
+  }
+  return csv(rows)
+}
+
+/** All of it, for other programs: the deck's title, when, and each question with its summary and answers. */
+export function reportJson(report, { title = '', exportedAt = new Date().toISOString() } = {}) {
+  return JSON.stringify({ version: 1, title, exportedAt, questions: report }, null, 2) + '\n'
+}

package/src/core/source.js

@@ -24,6 +24,11 @@ export function diagnostic(source, code, message, offset = 0, severity = 'error'
 }
 
 // Balanced directive scanner, shared by the document parser and Markdown lexer.
+// `:::include ./part.md`, alone on a slide, stands for the slides of another
+// deck file (build/include.js puts them in its place). Without a path, `:::include`
+// opens a block as any other name does (a callout of the deck's own).
+export const isIncludeLine = text => /^:::\s*include\s+\S/.test(text)
+
 export function scanDirectives(source) {
   const nodes = []
   const stack = []
@@ -38,7 +43,9 @@ export function scanDirectives(source) {
       const node = { name: open[1], argument: open[2].trim(), start: line.start, bodyStart: line.end, children: [] }
       if (stack.length) stack.at(-1).children.push(node)
       else nodes.push(node)
-      stack.push(node)
+      // :::include is one line: it has no body and no closing fence.
+      if (isIncludeLine(line.text)) Object.assign(node, { bodyEnd: line.end, end: line.end })
+      else stack.push(node)
     } else if (/^:::[ \t]*$/.test(line.text)) {
       const node = stack.pop()
       if (!node) diagnostics.push(diagnostic(source, 'unexpected-close', 'Directive closing fence has no opening fence', line.start))

package/src/core/timing.js

@@ -0,0 +1,83 @@
+// Timing a talk: how long each slide may take (`time: 2m` in its settings,
+// `time: 45m` for the whole deck), and where the talk stands against that
+// plan while it is given. A rehearsal (runtime/RehearsalSummary.jsx) writes
+// the times it measured back with formatTime.
+//
+// Times are written 90s, 2m, 1m30s or 1.5m; a bare number is minutes.
+
+export const TIME_STEP = 15
+
+const TIME_RE = /^(?:(\d+(?:\.\d+)?)\s*m(?:in)?)?\s*(?:(\d+(?:\.\d+)?)\s*s(?:ec)?)?$/i
+
+// Seconds, or null for something that is not a time.
+export function parseTime(value) {
+  if (typeof value === 'number') return Number.isFinite(value) && value > 0 ? Math.round(value * 60) : null
+  if (typeof value !== 'string') return null
+  const text = value.trim()
+  if (/^\d+(\.\d+)?$/.test(text)) return parseTime(Number(text))
+  const match = text.match(TIME_RE)
+  if (!text || !match || (match[1] == null && match[2] == null)) return null
+  const seconds = Math.round(Number(match[1] ?? 0) * 60 + Number(match[2] ?? 0))
+  return seconds > 0 ? seconds : null
+}
+
+// The way mdeck writes a time: 45s, 2m, 1m30s.
+export function formatTime(seconds) {
+  const s = Math.max(0, Math.round(seconds))
+  const m = Math.floor(s / 60), rest = s % 60
+  if (!m) return `${rest}s`
+  return rest ? `${m}m${rest}s` : `${m}m`
+}
+
+// A clock reading: 4:05, or 1:02:03 past an hour; negative values get a minus.
+export function formatClock(seconds) {
+  const sign = seconds < 0 ? '-' : ''
+  const s = Math.abs(Math.round(seconds))
+  const h = Math.floor(s / 3600), m = Math.floor(s / 60) % 60, rest = s % 60
+  const pad = n => String(n).padStart(2, '0')
+  return h ? `${sign}${h}:${pad(m)}:${pad(rest)}` : `${sign}${m}:${pad(rest)}`
+}
+
+// A measured time to the nearest step, never less than one step.
+export function roundTime(seconds, step = TIME_STEP) {
+  return Math.max(step, Math.round(seconds / step) * step)
+}
+
+// Each slide's share of the talk. Slides without a time share what the
+// deck's `time` leaves; without one they count as nothing. `times` replaces
+// slides' own times by id (what a rehearsal just saved).
+export function planFor(slides, deckConfig = {}, times = {}) {
+  const own = slides.map(slide => parseTime(Object.hasOwn(times, slide.id) ? times[slide.id] : slide.meta?.time))
+  const budget = parseTime(deckConfig?.time)
+  const set = own.reduce((sum, t) => sum + (t ?? 0), 0)
+  const untimed = own.filter(t => t == null).length
+  const share = budget && untimed ? Math.max(0, budget - set) / untimed : 0
+  const perSlide = own.map(t => t ?? share)
+  const start = []
+  let total = 0
+  for (const t of perSlide) { start.push(total); total += t }
+  return { perSlide, start, total, own, budget }
+}
+
+// Where the talk stands on slide `index`: the time left on it (negative when
+// over), and how far behind the plan the talk is (negative: ahead).
+export function scheduleAt(plan, index, { totalElapsed, slideElapsed }) {
+  const planned = plan.perSlide[index] ?? 0
+  const slideLeft = planned - slideElapsed
+  const due = (plan.start[index] ?? plan.total) + Math.min(slideElapsed, planned)
+  return { planned, slideLeft, delta: totalElapsed - due }
+}
+
+// A rehearsal's new time for each slide, in seconds or null for none: the
+// time it got, rounded, or for a slide it did not reach, the one it has.
+export function initialTimes(slides, spent, own = slides.map(slide => parseTime(slide.meta?.time))) {
+  return slides.map((slide, i) => spent[slide.id] >= 1 ? roundTime(spent[slide.id]) : own[i])
+}
+
+// What saving a rehearsal changes: { slideId: '1m30s' | null } for the slides
+// whose new time is not the one they have.
+export function changedTimes(slides, own, next) {
+  const times = {}
+  slides.forEach((slide, i) => { if (next[i] !== own[i]) times[slide.id] = next[i] == null ? null : formatTime(next[i]) })
+  return times
+}

package/src/core/validateDeck.js

@@ -5,9 +5,13 @@ import { LABEL_KEYS, CALLOUT_TYPES } from './labels.js'
 import { resolveLayoutProps, propertyErrors } from '../layouts/layoutProps.js'
 import { movedHint } from '../extensions/moved.js'
 import { paramValue } from '../extensions/params.js'
+import { parseTime } from './timing.js'
+import { reactionsProblem } from './reactions.js'
 
 // Hotspots (runtime/hotspots.js): the deck's setting and a slide's own.
 const HOTSPOT_SETTINGS = ['auto', 'marked', 'off', true, false]
+// Timing (core/timing.js): how long a slide, or the whole talk, may take.
+const TIME_HINT = value => `time: ${JSON.stringify(value)} is not a time; write it as 90s, 2m, 1m30s or 1.5m`
 
 // `layouts`, `themes` and `palettes` are manifest maps from the extension
 // registry (see src/extensions/discover.js). Checks for a kind are skipped when
@@ -52,6 +56,8 @@ export function validateDeck(deck, { layouts = null, themes = null, palettes = n
     if (config.session.code != null && !/^\d{4,8}$/.test(String(config.session.code))) add('invalid-config', 'session.code must be 4 to 8 digits', deck.configSource?.start)
   }
   if (config.hotspots != null && !HOTSPOT_SETTINGS.includes(config.hotspots)) add('invalid-config', 'hotspots must be auto, marked, off, true or false', deck.configSource?.start)
+  if (config.time != null && parseTime(config.time) == null) add('invalid-config', TIME_HINT(config.time), deck.configSource?.start)
+  if (reactionsProblem(config.reactions)) add('invalid-config', reactionsProblem(config.reactions), deck.configSource?.start)
   const enums = { organization: ['title', 'all', 'none'], author: ['title', 'all', 'none'], numbers: ['slides', 'all', 'none'], sections: ['all', 'none'] }
   const switches = ['citations']
   if (isPlainObject(config.show)) {
@@ -96,7 +102,9 @@ export function validateDeck(deck, { layouts = null, themes = null, palettes = n
     if (slide.meta.props != null && !isPlainObject(slide.meta.props)) add('invalid-props', 'props must be a mapping', offset)
     if (slide.meta.overlay != null && typeof slide.meta.overlay !== 'boolean') add('invalid-metadata', 'overlay must be true or false', offset)
     if (slide.meta.hotspots != null && !HOTSPOT_SETTINGS.includes(slide.meta.hotspots)) add('invalid-metadata', 'hotspots must be auto, marked, off, true or false', offset)
+    if (slide.meta.time != null && parseTime(slide.meta.time) == null) add('invalid-metadata', TIME_HINT(slide.meta.time), offset)
     for (const node of directivesIn(deck.source.slice(slide.source.start, slide.source.end))) {
+      if (node.name === 'include' && !slide.include) add('misplaced-include', ':::include stands alone on its slide, with no settings or other content: :::include ./part.md, or :::include ./part.md slides=2-5', slide.source.start + node.start, 'warning')
       if (DIRECTIVES.includes(node.name) || calloutTypes.includes(node.name.toLowerCase())) continue
       const near = closest(node.name.toLowerCase(), [...DIRECTIVES, ...calloutTypes])
       add('unknown-callout', `Unknown block "${node.name}"${near ? `; did you mean "${near}"?` : ''} It shows as a plain callout. Known: ${CALLOUT_TYPES.join(', ')}; name your own under callouts: in the settings`, slide.source.start + node.start, 'warning')
@@ -129,7 +137,7 @@ export function validateDeck(deck, { layouts = null, themes = null, palettes = n
 }
 
 // The `:::` blocks mdeck reads itself; any other name is a callout type.
-const DIRECTIVES = ['meta', 'notes', 'slot', 'steps', 'columns']
+const DIRECTIVES = ['meta', 'notes', 'slot', 'steps', 'columns', 'include']
 
 function directivesIn(source) {
   const all = []
@@ -154,6 +162,7 @@ function closest(name, names) {
   return best && best[1] <= 2 ? best[0] : null
 }
 
+// A diagnostic with a `file` of its own (one in an included deck) names it.
 export function formatDiagnostics(diagnostics, filename = 'slides.md') {
-  return diagnostics.map(d => `${filename}:${d.line}:${d.column ?? 1}: ${d.severity} [${d.code}] ${d.message}`).join('\n')
+  return diagnostics.map(d => `${d.file ?? filename}:${d.line}:${d.column ?? 1}: ${d.severity} [${d.code}] ${d.message}`).join('\n')
 }

package/src/editor/components/DeckSettings.jsx

@@ -86,6 +86,7 @@ export function DeckSettings({ state, edit }) {
     </>}
     <p class="section-title">About the talk</p>
     {META.map(([key, label]) => <Field key={key} label={label}><input type="text" value={config.meta?.[key] ?? ''} onInput={e => meta(key, e.currentTarget.value)} /></Field>)}
+    <Field label="Length" hint="how long the talk takes, e.g. 20m; slides without a time of their own share what is left"><input type="text" value={config.time ?? ''} placeholder="20m" onInput={e => text('time', e.currentTarget.value.trim())} /></Field>
     <p class="section-title">Slide frame</p>
     <div class="grid-2">
       <Field label="Width"><input type="number" value={config.width ?? 1920} onInput={e => patch({ width: Number(e.currentTarget.value) || undefined }, 'deck:width')} /></Field>

package/src/editor/components/MetaFields.jsx

@@ -20,6 +20,7 @@ export function MetaFields({ slide, slideEdit }) {
         slideEdit((deck, id) => setSlideMeta(deck, id, { hotspots: value === '' ? undefined : value === 'off' ? false : value }), { group: 'meta:hotspots' })
       }}><option value="">the deck's</option>{['auto', 'marked', 'off'].map(o => <option key={o} value={o}>{o}</option>)}</select>
     </Field>
+    <Field label="Time" hint="how long to spend on this slide: 90s, 2m or 1m30s; mdeck rehearse measures it">{text('time')}</Field>
     <Field label="Speaker notes"><TextArea rows={4} value={slide.meta.notes ?? ''} onInput={value => slideEdit((deck, id) => setSlideNotes(deck, id, value), { group: 'notes' })} /></Field>
     <details class="more" open={MORE.some(([key]) => meta[key] != null)}>
       <summary>More metadata</summary>