weekly

package

v1.8.0 Latest Latest Go to latest Published: Mar 8, 2026 License: MIT Imports: 8 Imported by: 0

Details

This section is empty.

This section is empty.

func AddWeeks(weekStart time.Time, delta int) time.Time

AddWeeks moves to the next or previous ISO week.

func BonusXP(index int) int

BonusXP returns the slot-based bonus XP for a completed weekly puzzle.

func Mode(year, week, index int) (game.SeededSpawner, string, string)

Mode selects the weekly mode from the daily-eligible pool using rendezvous hashing on the canonical weekly name.

func Name(year, week, index int) string

Name returns the canonical persisted name for a weekly puzzle.

func NameForDate(date time.Time, index int) string

NameForDate returns the weekly puzzle name for the date's ISO week.

func Prefix(year, week int) string

Prefix returns the exact query prefix for all rows in a weekly gauntlet.

func RNG(year, week, index int) *rand.Rand

RNG creates a deterministic RNG seeded from the weekly identity.

func Seed(year, week, index int) uint64

Seed returns a deterministic uint64 seed derived from the weekly identity.

func StartOfWeek(year, week int, loc *time.Location) time.Time

StartOfWeek returns the Monday for the given ISO week.

type Entry struct {
	Spawner  game.SeededSpawner
	GameType string
	Mode     string
}

Entry pairs a SeededSpawner with metadata for the eligible weekly pool.

type Info struct {
	Year  int
	Week  int
	Index int
}

Info identifies a single weekly gauntlet puzzle.

func Current(date time.Time) Info

Current returns the current ISO week identity for the provided date.

func ParseName(name string) (Info, bool)

ParseName parses a canonical weekly name.