docs: clarify demo timeline position state

This commit is contained in:
lda
2026-07-03 01:36:27 +07:00 Verified
parent a603ad78fa
commit 7dd1dc86d8
@@ -202,6 +202,12 @@ type DemoTimelineState = {
}; };
``` ```
`cursor` is an internal playback-position example, not a persisted recording
field or public UI contract. An implementation may instead keep the current
event id, split pending/applied event arrays, or derive a stage-to-position map.
Presentation meaning always comes from the ordered event and its `stage`, not
from a magic numeric value.
Invariants: Invariants:
- `cursor` is the index of the last applied event, or `-1` before playback. - `cursor` is the index of the last applied event, or `-1` before playback.
@@ -362,4 +368,3 @@ The slice is complete when:
7. live and replay use the same report, issue, trace, and evidence components; 7. live and replay use the same report, issue, trace, and evidence components;
8. mode attribution prevents recorded behavior from appearing live; 8. mode attribution prevents recorded behavior from appearing live;
9. the complete sequence can be demonstrated in under three minutes. 9. the complete sequence can be demonstrated in under three minutes.