allowlist

type CountRow struct {
	Key      string
	Listed   int
	Measured int
}

type List struct {
	Path string
	// contains filtered or unexported fields
}

type Options struct {
	// Key derives a row's key from its trimmed text. Nil is FirstField.
	Key func(row string) string
	// Ceiling marks a list whose count only falls: an update drops stale rows and
	// refuses to add a row for an unlisted key.
	Ceiling bool
	// NewRow is the text an update appends for an unlisted key on a list that may
	// grow. Nil appends the key alone. Unused on a ceiling list.
	NewRow func(key string) string
	// MissingIsEmpty loads a missing file as an empty list instead of an error: a
	// tree with nothing parked in it is the goal.
	MissingIsEmpty bool
	// Counted marks a list whose rows carry a site count as the second field
	// (`key N reason`, N a positive integer); use CheckCountedMode with it.
	Counted bool
	// PackageKeys makes LoadPackages interpret a counted key as
	// `<repo-relative-package>:<kind>` instead of a file-qualified key.
	// The row key itself remains unchanged; this only selects its shard.
	PackageKeys bool
	// RepeatedKeys permits rows with duplicate keys; by default Parse rejects
	// a repeated key.
	RepeatedKeys bool
}

type Packages struct {
	Path string
	// contains filtered or unexported fields
}

type Reporter interface {
	Helper()
	Errorf(format string, args ...any)
}

type Result struct {
	// Stale are the rows whose key was not measured. Each is a red run; an update
	// drops them and returns none.
	Stale []Row
	// Unlisted are the measured keys no row carries, sorted. Each is a red run; an
	// update on a list that may grow adds them and returns none, and a ceiling list
	// keeps them (it refuses to grow).
	Unlisted []string
	// Over are the keys of a counted list measured at more sites than their row
	// allows: a new site under an existing row. Each is a red run, and an update
	// refuses to raise the count.
	Over []CountRow
	// Lowered are the keys of a counted list measured at fewer sites than their
	// row says. Each is a red run outside an update; an update lowers the count and
	// returns none.
	Lowered []CountRow
	// Updated is true when this run rewrote the file.
	Updated bool
}

type Row struct {
	Line int    // 1-based line in the file
	Text string // the row, trimmed
	Key  string
}