mdeck 3.10.0 → 3.11.0

package/src/cli/index.js

@@ -16,6 +16,7 @@ import { checkDeck, bibliographyDiagnostics } from '../build/check.js'
 import { livePlugin, startLiveServer } from '../live/server.js'
 import { inkPlugin } from '../build/inkPlugin.js'
 import { resultsPlugin } from '../build/resultsPlugin.js'
+import { timingPlugin } from '../build/timingPlugin.js'
 import { createPairing, pairingPlugin } from '../build/pairing.js'
 import { isAllowedRequest } from '../build/editorPlugin.js'
 import { renderPdf, attachPdf, findChrome } from '../build/pdf.js'
@@ -26,7 +27,7 @@ import { paramKind } from '../extensions/params.js'
 
 import { frameworkRoot } from '../paths.js'
 import { parseSlides } from '../core/parseSlides.js'
-import { stripNotes as stripNotesFrom, stripActivities as stripActivitiesFrom } from '../core/editDeck.js'
+import { stripNotes as stripNotesFrom, shareSlides } from '../core/editDeck.js'
 import { parseArgs, parseSlideNumbers, validateServerOrigin } from './args.js'
 import { assertDrawings } from '../build/drawings.js'
 import { resultsFileFor, normalizeResults, resultsCsv } from '../core/results.js'
@@ -59,6 +60,16 @@ const positionals = () => parsed.positionals
 const outputOption = () => parsed.options['--output'] ?? null
 const serverOption = () => parsed.options['--server']
 const portOption = () => parsed.options['--port'] ?? null
+// --slide 3,5-7 for build, send and pdf: only these slides, numbered as written.
+function slideOption(input) {
+  const given = parsed.options['--slide']
+  if (given == null) return null
+  try {
+    const slides = parseSlideNumbers(given)
+    shareSlides(readFileSync(resolve(input), 'utf-8'), { slides })
+    return slides
+  } catch (error) { err(error.message); process.exit(1) }
+}
 
 // Layouts, themes and palettes all come from one registry: built-ins plus the
 // extensions/ folder beside the deck. Manifest problems are reported and stop
@@ -181,13 +192,13 @@ async function runNewWizard() {
   }
 }
 
-async function copyLocalAssets(slidesPath, outDir, { stripNotes = false, stripActivities = false } = {}) {
+async function copyLocalAssets(slidesPath, outDir, { stripNotes = false, stripActivities = false, slides = null } = {}) {
   const absSlides = resolve(slidesPath)
   const deckDir = dirname(absSlides)
   const absOutDir = resolve(outDir)
   const raw = readFileSync(absSlides, 'utf-8')
   let markdown = stripNotes ? stripNotesFrom(raw) : raw
-  if (stripActivities) markdown = stripActivitiesFrom(markdown).source
+  if (stripActivities || slides) markdown = shareSlides(markdown, { activities: stripActivities, slides }).source
 
   for (const ref of collectLocalAssetRefs(markdown)) {
     const source = resolve(deckDir, ref)
@@ -314,6 +325,8 @@ const HELP = `
                              (the address, or the deck's server setting, or MDECK_SERVER;
                               the key in MDECK_SERVER_KEY)
       --no-open   --port <number>
+    ${c.green}mdeck rehearse${c.reset} [slides.md]                Like run, but opens the presenter view rehearsing: it times
+                                              each slide and saves the times into the deck (time: 1m30s)
     ${c.green}mdeck edit${c.reset} [slides.md]                    Edit slides in the browser; saves to the file
     ${c.green}mdeck design${c.reset} [folder | slides.md]         Look at and fine-tune themes and palettes on a sample deck;
                                               saves to the folder's extensions/ (default: this folder)
@@ -332,6 +345,8 @@ const HELP = `
       --notes                keep the speaker notes in the file
       --no-polls             for send, build --reader and pdf: leave out the slides with polls and join codes
       --no-pdf               do not render the PDF inside
+      --slide 3,5-7          for build, send and pdf: only these slides (numbered as in the deck,
+                             with their drawings; styles from slides left out stay)
     ${c.green}mdeck pdf${c.reset} [slides.md] [-o talk.pdf]       A PDF, one page per slide
       --no-drawings          for build, send and pdf: leave out <slides>.drawings.json
       --no-results           for build, send and pdf: leave out <slides>.results.json (the answers kept in the talk)
@@ -402,7 +417,7 @@ if (argv.includes('--help') || argv.includes('-h')) { console.log(HELP); process
 let parsed
 try {
   parsed = parseArgs(command, argv)
-  if (['run', 'server'].includes(command) && Object.hasOwn(process.env, 'MDECK_LIVE_KEY')) throw new Error('MDECK_LIVE_KEY is now MDECK_SERVER_KEY. Rename the environment variable before starting mdeck.')
+  if (['run', 'rehearse', 'server'].includes(command) && Object.hasOwn(process.env, 'MDECK_LIVE_KEY')) throw new Error('MDECK_LIVE_KEY is now MDECK_SERVER_KEY. Rename the environment variable before starting mdeck.')
 } catch (error) {
   err(error.message)
   if (Object.hasOwn(RENAMED_COMMANDS, command)) tip(`mdeck ${command} is now ${RENAMED_COMMANDS[command]}.`)
@@ -538,7 +553,7 @@ if (command === 'new') {
   else process.stdout.write(layouts[name].starter)
 
 // ── run ───────────────────────────────────────────────────────────────────────
-} else if (command === 'run') {
+} else if (command === 'run' || command === 'rehearse') {
   const input = requireInput(command)
   const abs = resolve(input)
   try { assertDrawings(abs) } catch (error) { err(error.message); process.exit(1) }
@@ -584,13 +599,13 @@ if (command === 'new') {
     ...base,
     // A paired iPad may save ink and steer the rooms, like this computer.
     ...(relay ? { base: relay.base } : {}),
-    plugins: [...(relay ? [stripRelayBase(relay.base)] : []), ...base.plugins, homePlugin(abs, { services, pairing, relay, server: relay?.server ?? null }), pairingPlugin(pairing), livePlugin({ pairing, upstream, key: process.env.MDECK_SERVER_KEY, session: () => sessionCode(parseSlides(readFileSync(abs, 'utf8')).deckConfig) }), inkPlugin(abs, { authorize: request => isAllowedRequest(request) || pairing.allows(request) }), resultsPlugin(abs, { authorize: request => isAllowedRequest(request) || pairing.allows(request) })],
+    plugins: [...(relay ? [stripRelayBase(relay.base)] : []), ...base.plugins, homePlugin(abs, { services, pairing, relay, server: relay?.server ?? null }), pairingPlugin(pairing), livePlugin({ pairing, upstream, key: process.env.MDECK_SERVER_KEY, session: () => sessionCode(parseSlides(readFileSync(abs, 'utf8')).deckConfig) }), inkPlugin(abs, { authorize: request => isAllowedRequest(request) || pairing.allows(request) }), resultsPlugin(abs, { authorize: request => isAllowedRequest(request) || pairing.allows(request) }), timingPlugin(abs, { authorize: request => isAllowedRequest(request) || pairing.allows(request) })],
     publicDir: dirname(abs),
     server: {
       ...base.server,
       ...(port ? { port, strictPort: true } : {}),
       host: exposed ? true : base.server.host,
-      open: hasFlag('--no-open') ? false : `${mountBase}home.html`,
+      open: hasFlag('--no-open') ? false : command === 'rehearse' ? `${mountBase}?view=presenter&rehearse=1` : `${mountBase}home.html`,
     },
   })
   await server.listen()
@@ -624,6 +639,7 @@ if (command === 'new') {
   console.log()
   ok(`Launch page: ${c.cyan}${new URL('home.html', local).href}${c.reset}`)
   tip(`Presenter:   ${new URL('?view=presenter', local).href}`)
+  tip(`Rehearse:    ${new URL('?view=presenter&rehearse=1', local).href}`)
   tip(`Audience:    ${new URL('?view=audience', local).href}`)
   // Phones in the room follow the talk (the reader view would show slides ahead).
   if (exposed) for (const url of server.resolvedUrls.network) tip(`Follow:      ${new URL('?view=follow', url).href}`)
@@ -696,6 +712,7 @@ if (command === 'new') {
   // Polls show as a record of the talk; --no-polls leaves their slides and join codes out.
   const stripActivities = reader && hasFlag('--no-polls')
   const wantPdf = sending && !hasFlag('--no-pdf')
+  const slides = slideOption(input)
 
   if (!hasFlag('--no-drawings')) { try { assertDrawings(input) } catch (error) { err(error.message); process.exit(1) } }
   const given = outputOption()
@@ -709,7 +726,7 @@ if (command === 'new') {
   try {
     await build({
       ...baseConfig(input, { selfContained, defaultView: reader ? 'reader' : 'deck' }),
-      plugins: [preact(), slidesPlugin(resolve(input), { inlineImages: selfContained, inlineMedia: selfContained, embedFonts: selfContained, stripNotes, stripActivities, ink: !hasFlag('--no-drawings'), results: !hasFlag('--no-results'), deckLook: reader }), viteSingleFile()],
+      plugins: [preact(), slidesPlugin(resolve(input), { inlineImages: selfContained, inlineMedia: selfContained, embedFonts: selfContained, stripNotes, stripActivities, slides, ink: !hasFlag('--no-drawings'), results: !hasFlag('--no-results'), deckLook: reader }), viteSingleFile()],
       build: {
         outDir,
         emptyOutDir: !tempDir,
@@ -727,7 +744,7 @@ if (command === 'new') {
   await mkdir(finalOutDir, { recursive: true })
 
   if (!selfContained) {
-    await copyLocalAssets(input, finalOutDir, { stripNotes, stripActivities })
+    await copyLocalAssets(input, finalOutDir, { stripNotes, stripActivities, slides })
     if (launchers) await writePresenterLaunchers(finalOutDir, htmlFilename)
   }
 
@@ -751,7 +768,12 @@ if (command === 'new') {
     } finally { await rm(pdfDir, { recursive: true, force: true }) }
   }
   if (stripNotes) tip('Speaker notes were removed from this file (use --notes to keep them).')
-  if (stripActivities && stripActivitiesFrom(readFileSync(resolve(input), 'utf-8')).removed.length) tip('Slides with polls were left out (--no-polls).')
+  // Only polls among the slides chosen with --slide were left out for --no-polls.
+  if (stripActivities) {
+    const raw = readFileSync(resolve(input), 'utf-8')
+    if (shareSlides(raw, { activities: true, slides }).removed.length > (slides ? shareSlides(raw, { slides }).removed.length : 0)) tip('Slides with polls were left out (--no-polls).')
+  }
+  if (slides) tip(`Only slides ${parsed.options['--slide']} (--slide).`)
   ok(`${sending ? 'Made' : 'Built'}: ${c.cyan}${htmlFile}${c.reset}${reader ? ' — opens in the reader view' : ''}${selfContained ? ' (single file)' : ' + local assets'}\n`)
 
 // ── skill ─────────────────────────────────────────────────────────────────────
@@ -777,11 +799,12 @@ if (command === 'new') {
   const pdfFile = resolve(process.cwd(), outputOption() ?? basename(input).replace(/\.md$/i, '') + '.pdf')
   if (!hasFlag('--no-drawings')) { try { assertDrawings(input) } catch (error) { err(error.message); process.exit(1) } }
   if (!findChrome()) { err('No Chrome or Chromium found. Set MDECK_CHROME to its executable path.'); process.exit(1) }
+  const slides = slideOption(input)
   const tempDir = mkdtempSync(resolve(tmpdir(), 'mdeck-pdf-'))
   try {
     await build({
       ...baseConfig(input, { selfContained: true }),
-      plugins: [preact(), slidesPlugin(resolve(input), { inlineImages: true, inlineMedia: true, embedFonts: true, stripActivities: hasFlag('--no-polls'), ink: !hasFlag('--no-drawings'), results: !hasFlag('--no-results'), deckLook: true }), viteSingleFile()],
+      plugins: [preact(), slidesPlugin(resolve(input), { inlineImages: true, inlineMedia: true, embedFonts: true, stripActivities: hasFlag('--no-polls'), slides, ink: !hasFlag('--no-drawings'), results: !hasFlag('--no-results'), deckLook: true }), viteSingleFile()],
       build: { outDir: tempDir, emptyOutDir: true, target: 'esnext', assetsInlineLimit: 100 * 1024 * 1024 },
       logLevel: 'warn',
     })

package/src/components/VideoPlayer.jsx

@@ -169,7 +169,12 @@ export default function VideoPlayer({ src, url, play = 'click', aspect, muted })
     >
       {url ? (
         iframeSrc
-          ? <iframe src={iframeSrc} allow="autoplay; fullscreen" allowFullScreen
+          // A deck served through a server (an iPad paired over the internet)
+          // comes with "Referrer-Policy: no-referrer", so pairing links never
+          // leak; YouTube refuses to play an embed that names no page
+          // ("This video is unavailable"). The player alone sends the
+          // deck's origin, never its path.
+          ? <iframe src={iframeSrc} allow="autoplay; fullscreen" allowFullScreen referrerpolicy="strict-origin"
               style={{ width: '100%', height: fixedAspect ? '100%' : 'auto', aspectRatio: fixedAspect ? undefined : '16 / 9', border: '0', display: 'block' }} />
           : <div class="video-player-placeholder" />
       ) : (

package/src/core/editDeck.js

@@ -4,7 +4,8 @@
 // identical; callers reparse the result.
 import { parseSlides, SLIDE_KEYS, DECK_KEYS } from './parseSlides.js'
 import { applySourceEdits, replaceRegion, normalizeBlock, detectNewline, patchYamlMapping, firstYamlKey } from './source.js'
-import { openTagsIn } from './tags.js'
+import { openTagsIn, tagsIn, closingTagOf } from './tags.js'
+import { planFor, formatTime } from './timing.js'
 
 const REGION_RE = /^[a-z][a-z0-9-]*$/
 
@@ -247,11 +248,27 @@ export function hasActivity(slide) {
 // to its id afterwards (an automatic `slide-N` moves up), `removed` the ids
 // that are gone, so saved drawings can follow their slides.
 export function stripActivities(source) {
+  return shareSlides(source, { activities: true })
+}
+
+// The slides a shared build keeps: those numbered in `slides` (1-based, as
+// written; null for all) and, with `activities`, none with a live activity.
+// A deck of nothing but activities keeps them rather than becoming empty. A
+// <style> on a slide left out styles the whole deck, so it moves to the
+// first kept slide. The deck's `time` becomes what the kept slides were
+// planned to take, so each keeps its share. Returns { source, ids, removed }
+// as stripActivities.
+export function shareSlides(source, { activities = false, slides = null } = {}) {
   const deck = parseSlides(source)
-  const dropped = deck.slides.filter(hasActivity)
   const same = () => ({ source, ids: Object.fromEntries(deck.slides.map(slide => [slide.id, slide.id])), removed: [] })
-  // A deck of nothing but activities stays as it is rather than becoming empty.
-  if (!dropped.length || dropped.length === deck.slides.length) return same()
+  if (slides) {
+    const beyond = slides.filter(n => n > deck.slides.length)
+    if (beyond.length) throw new Error(`The deck has ${deck.slides.length} slides; there is no slide ${beyond.join(', ')}`)
+  }
+  let chosen = deck.slides.filter((slide, i) => !slides || slides.includes(i + 1))
+  if (activities && !chosen.every(hasActivity)) chosen = chosen.filter(slide => !hasActivity(slide))
+  const dropped = deck.slides.filter(slide => !chosen.includes(slide))
+  if (!dropped.length) return same()
   const ranges = dropped.map(slide => {
     const bounds = slideBounds(deck, slide.id)
     const next = deck.slides[deck.slides.indexOf(slide) + 1]
@@ -266,8 +283,28 @@ export function stripActivities(source) {
     if (last && range.start <= last.end) last.end = Math.max(last.end, range.end)
     else merged.push({ ...range })
   }
-  const next = edit(deck, merged.map(range => ({ ...range, text: '', expected: expectedText(deck, range) })))
+  let next = edit(deck, merged.map(range => ({ ...range, text: '', expected: expectedText(deck, range) })))
+  const styles = dropped.flatMap(slide => styleBlocks(deck.source.slice(slide.source.start, slide.source.end)))
+  if (styles.length) {
+    const kept = parseSlides(next)
+    const nl = detectNewline(next)
+    next = appendBlock(kept, kept.slides[0], styles.join(nl) + nl)
+  }
+  if (deck.deckConfig.time != null) {
+    const plan = planFor(deck.slides, deck.deckConfig)
+    const kept = chosen.reduce((sum, slide) => sum + plan.perSlide[deck.slides.indexOf(slide)], 0)
+    if (plan.budget) next = setDeckConfig(parseSlides(next), { time: kept ? formatTime(kept) : undefined })
+  }
   const after = parseSlides(next).slides
-  const kept = deck.slides.filter(slide => !dropped.includes(slide))
-  return { source: next, ids: Object.fromEntries(kept.map((slide, i) => [slide.id, after[i]?.id ?? slide.id])), removed: dropped.map(slide => slide.id) }
+  return { source: next, ids: Object.fromEntries(chosen.map((slide, i) => [slide.id, after[i]?.id ?? slide.id])), removed: dropped.map(slide => slide.id) }
+}
+
+// The <style> elements in a slide's text, found as the slide finds them (not in code).
+function styleBlocks(text) {
+  const tags = tagsIn(text)
+  return tags.flatMap((tag, at) => {
+    if (tag.name !== 'style' || tag.closing || tag.start == null) return []
+    const close = closingTagOf(tags, at)
+    return close?.end != null ? [text.slice(tag.start, close.end)] : []
+  })
 }

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
@@ -60,6 +62,7 @@ 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
   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

@@ -151,6 +151,79 @@ 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': 'أُرسلت. شكرًا لك!',
+    '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 +235,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

@@ -2,8 +2,8 @@ import yaml from 'js-yaml'
 import { sourceLines, fenceState, scanDirectives, diagnostic } 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'.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
@@ -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)

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,12 @@ 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'
 
 // 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 +55,7 @@ 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)
   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,6 +100,7 @@ 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 (DIRECTIVES.includes(node.name) || calloutTypes.includes(node.name.toLowerCase())) continue
       const near = closest(node.name.toLowerCase(), [...DIRECTIVES, ...calloutTypes])

package/src/editor/components/DeckSettings.jsx

@@ -10,7 +10,7 @@ import { PalettePicker } from './PalettePicker.jsx'
 import { LookThumbnail } from './LookThumbnail.jsx'
 import { designUrl, DESIGN_TAB } from '../designLink.js'
 import { normalMode } from '../../runtime/hotspots.js'
-import { paramValue } from '../../extensions/params.js'
+import { paramValue, paramDefault } from '../../extensions/params.js'
 
 // What the `show` setting controls: the label for each choice and its values.
 const SHOW = { organization: ['Organization', ['title', 'all', 'none']], author: ['Author and date', ['title', 'all', 'none']], numbers: ['Slide numbers', ['slides', 'all', 'none']], sections: ['Section labels', ['all', 'none']] }
@@ -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>
@@ -112,8 +113,8 @@ function DesignLink({ kind, item }) {
 
 // The control for one theme parameter, by its type: a slider for a size or a
 // number with a range, a box to tick for a switch, a list for a choice, else
-// text (with a colour picker when the default is a colour). An empty value
-// means the theme's own.
+// a text box (with a colour picker when the default is a colour). An empty
+// value means the theme's own; a text shows the theme's without its quotes.
 function ParamInput({ def, value, onChange }) {
   const current = value != null && !paramValue(def, value).problem ? paramValue(def, value).value : def.default
   if (def.type === 'switch') return <>
@@ -137,6 +138,6 @@ function ParamInput({ def, value, onChange }) {
   const color = isColor(def.default)
   return <>
     {color ? <input type="color" value={isColor(value) ? value : def.default} onInput={e => onChange(e.currentTarget.value)} style={{ flex: '0 0 auto' }} /> : null}
-    <input type="text" value={value ?? ''} placeholder={def.default} onInput={e => onChange(e.currentTarget.value)} />
+    <input type="text" value={value ?? ''} placeholder={paramDefault(def)} onInput={e => onChange(e.currentTarget.value)} />
   </>
 }

package/src/editor/components/ExtensionForms.jsx

@@ -8,7 +8,7 @@ const isColor = value => /^#[0-9a-f]{3,8}$/i.test(String(value ?? '').trim())
 const update = (list, index, patch) => list.map((item, i) => i === index ? { ...item, ...patch } : item)
 const without = (list, index) => list.filter((_, i) => i !== index)
 // The kinds of value a theme parameter takes (see src/extensions/params.js).
-const PARAM_KINDS = [['', 'text'], ['size', 'size'], ['number', 'number'], ['switch', 'switch'], ['choice', 'choice'], ['font', 'font']]
+const PARAM_KINDS = [['', 'CSS value'], ['size', 'size'], ['number', 'number'], ['switch', 'switch'], ['choice', 'choice'], ['font', 'font'], ['text', 'text']]
 
 function Identity({ model, onChange }) {
   return <>

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>

package/src/extensions/params.js

@@ -7,11 +7,13 @@
 //   switch   1 or 0 (also true and false, on and off, yes and no)
 //   choice   one of `choices`
 //   font     a CSS font list
+//   text     words to show, such as a prompt: the author writes them plain,
+//            mdeck quotes them; the theme's own value is a quoted CSS string
 //
 // The manifest check, `mdeck check`, the slides and the editor all use these
 // functions, so they agree on what a value means.
 
-export const PARAM_TYPES = ['size', 'number', 'switch', 'choice', 'font']
+export const PARAM_TYPES = ['size', 'number', 'switch', 'choice', 'font', 'text']
 export const PARAM_KEYS = ['token', 'title', 'description', 'type', 'min', 'max', 'step', 'choices']
 const RANGED = ['size', 'number']
 const NUMBER_RE = /^-?(\d+\.?\d*|\.\d+)$/
@@ -26,6 +28,25 @@ function pixels(value) {
 
 const unit = param => param.type === 'size' ? 'px' : ''
 
+// A CSS string literal ('…' or "…") and the text in it.
+const STRING_RE = /^(['"])((?:\\[^]|(?!\1)[^\\\n])*)\1$/
+
+/** Text as a CSS string: quoted, with backslashes, quotes and line breaks escaped. */
+export function cssString(text) {
+  return '"' + String(text).replace(/\\/g, '\\\\').replace(/"/g, '\\"').replace(/\r?\n/g, '\\A ') + '"'
+}
+
+/** The text in a CSS string literal, or null when it is not one. */
+export function unquote(css) {
+  const match = STRING_RE.exec(String(css).trim())
+  return match ? match[2].replace(/\\A ?/g, '\n').replace(/\\([^])/g, '$1') : null
+}
+
+/** A parameter's default as an author would write it: a text without its quotes. */
+export function paramDefault(param) {
+  return param.type === 'text' ? unquote(param.default) ?? param.default : param.default
+}
+
 /** The range a parameter was made for, as text ("6px to 20px", "at least 0"), or ''. */
 export function paramRange(param) {
   const { min, max } = param
@@ -54,6 +75,8 @@ export function paramValue(param, raw) {
   const type = param.type
   if (raw == null || (typeof raw === 'object')) return { problem: 'needs a single value' }
   if (!type) return { value: String(raw) }
+  // Text keeps its spaces (a prompt ends in one) and may be empty.
+  if (type === 'text') return { value: cssString(raw) }
   const text = String(raw).trim()
   if (!text) return { problem: 'is empty' }
   if (type === 'font') return { value: text }
@@ -98,6 +121,10 @@ export function paramSettingProblems(param, fallback) {
     else if (new Set(choices).size !== choices.length) problems.push(['choices', 'lists a value twice'])
   } else if (param.choices != null) problems.push(['choices', `is for a choice, not a ${type}`])
   if (problems.length || fallback == null) return problems
+  if (type === 'text') {
+    if (unquote(fallback) == null) problems.push(['type', `a text's token is a quoted CSS string, such as "'~/talk $ '" (got ${JSON.stringify(fallback)})`])
+    return problems
+  }
   // The default is the token's value: it has to be a value of this type too.
   const result = paramValue(param, fallback)
   if (result.problem) problems.push(['type', `the token's value ${JSON.stringify(fallback)} ${result.problem}`])

package/src/home/Home.jsx

@@ -331,6 +331,7 @@ export function Home() {
         </div>
         <div class="home-tiles">
           <ViewTile icon="presenter" title="Presenter view" text="Present and draw, with notes, timer and next slide. Switch to slides only or fullscreen." href={`${BASE}?view=presenter&session=${SESSION}${code}`} open={openOn('presenter')} />
+          <ViewTile icon="rehearse" title="Rehearse" text="Go through the talk as if giving it: each slide is timed, and the times can be saved into the deck." href={`${BASE}?view=presenter&rehearse=1&session=${SESSION}${code}`} />
           <ViewTile icon="projector" title="Audience window" text="Slides for the projector, without notes. Navigation stays in sync with the presenter." href={`${BASE}?view=audience&session=${SESSION}${code}`} open={openOn('audience')} />
           <ViewTile icon="reader" title="Reader view" text="Outline, reading mode and look picker, as people you send it to see it." href={`${BASE}?view=reader`} />
         </div>