schedule.go

package chronos

import "time"

// Schedule computes fire times. It is the single scheduling seam: it

// never sleeps and has no side effects.

type Schedule interface {

	// Next returns the next fire time strictly after the given time, or

	// the zero [time.Time] to mean "no further runs". The argument is

	// the anchor; for a recurring schedule it is typically the time of

	// the previous fire (or loop start for the first call).

	Next(after time.Time) time.Time

}

// everySchedule fires at a fixed [Span] past the anchor. It is

// stateless: each call is a single O(1) hop of after+span.

//

// It assumes a non-zero span; with a zero span Next would return after

// unchanged and violate the strictly-after contract. Constructors in

// later phases guard against an empty span, so this type may assume it.

type everySchedule struct {

	span Span

}

// Next returns after advanced by one span.

func (s everySchedule) Next(after time.Time) time.Time {

	return s.span.addTo(after)

}