Ocideck/lib/models/rehearsal.dart
Brenno de Winter b719c43991 Add presentation timer / rehearsal mode to the presenter
The presenter view now doubles as a rehearsal clock that measures without
coaching: a countdown against a target time, the time spent on the current
slide, and an end-of-run summary (total vs. target and per-slide times, with
copy-to-clipboard). Timing lives in a plain, unit-tested RehearsalController fed
via an idempotent observe() on every build, so it captures every navigation
path. The default target is stored in AppSettings; live adjustment is the K key
(typed as MMSS). All rehearsal state is session-only -- nothing is written to
disk or into the .md file.

- New: models/rehearsal.dart, services/rehearsal_controller.dart,
  widgets/presentation/rehearsal_summary.dart, plus a controller unit test.
- Presenter: countdown + per-slide timer in the clock bar, K to set the target,
  R resets the run, end-of-run summary dialog, and help/cheatsheet entries.
- Settings: presentationTargetSeconds (default target) with a dropdown in the
  General tab, threaded into FullscreenPresenter.present().
- l10n: new Dutch source strings translated in all seven languages.
- Docs: README, CHANGELOG, USER_GUIDE, SHORTCUTS, ARCHITECTURE.

Also bundles a pre-existing in-progress change already in the working tree: wire
the existing ThemeProfile.tableHeaderBackgroundColor into table rendering
(preview, HTML export, file_service) and the settings dialog, plus its
translations.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-13 07:03:08 +02:00

46 lines
1.4 KiB
Dart

import 'package:flutter/foundation.dart';
/// Tijd die tijdens een oefenrun aan één slide is besteed.
///
/// Sessie-only: niets hiervan wordt op schijf bewaard (geen prefs, geen `.md`).
/// Het bestand blijft inhoud; oefentijden leven alleen in het draaiende
/// presenter-venster.
@immutable
class SlideTiming {
/// Stabiele slide-id binnen de sessie ([Slide.id]).
final String slideId;
/// 0-gebaseerde positie waarop de slide voor het eerst werd getoond. Dient
/// alleen voor een stabiele weergavevolgorde in de samenvatting.
final int index;
/// Opgetelde wandkloktijd op deze slide over de hele run (een slide kan
/// meerdere keren bezocht zijn).
final Duration spent;
const SlideTiming({
required this.slideId,
required this.index,
required this.spent,
});
}
/// Samenvatting van één oefenrun in de huidige sessie: totale tijd, de
/// (optionele) doeltijd en de tijd per slide. Puur beschrijvend — er zit
/// geen pacing-advies in, alleen gemeten tijd.
@immutable
class RehearsalRun {
final Duration total;
final Duration? target;
final List<SlideTiming> perSlide;
const RehearsalRun({
required this.total,
required this.target,
required this.perSlide,
});
/// Verschil t.o.v. de doeltijd: positief = over de tijd, negatief = ruim
/// binnen. Null wanneer er geen doeltijd was.
Duration? get delta => target == null ? null : total - target!;
}