docs(visual): document the fade model monotonic base field

commit: 90bc06063484af7617329f8e33f26e0808ce1d98
author: brice · 21d ago · 2026-10-01 15:21 UTC
parent: 2881c25
signature: GPG VerifiedCD88F9E564E0102646FB6077A1A07C7C7C3E349D · arch-gpg Verified for the committer email

1 file · +2 -1

M internal/adapters/visual/fade.go +2 -1


@@ -24,10 +24,11 @@ type fadeCmd struct {
24	24		type fadeModel struct {
25	25		cmds chan fadeCmd
26	26		wake chan struct{}
	27	+	// base is the monotonic origin for tickUntil; fixed at construction.
	28	+	base time.Time
27	29		// tickUntil keeps redraws coming past the fade end, as nanoseconds since
28	30		// base (monotonic, like fadeAlpha). It must not depend on which surface
29	31		// drew last: a wake redraws all surfaces, but each draws at its own instant.
30		-	base time.Time
31	32		tickUntil atomic.Int64
32	33		// finish ends the run once a reveal completed; set by the runner before
33	34		// the loop starts.

 type fadeModel struct {
 	cmds chan fadeCmd
 	wake chan struct{}
+	// base is the monotonic origin for tickUntil; fixed at construction.
+	base time.Time
 	// tickUntil keeps redraws coming past the fade end, as nanoseconds since
 	// base (monotonic, like fadeAlpha). It must not depend on which surface
 	// drew last: a wake redraws all surfaces, but each draws at its own instant.
-	base      time.Time
 	tickUntil atomic.Int64
 	// finish ends the run once a reveal completed; set by the runner before
 	// the loop starts.