render

type Birthday struct {
	Name        string
	HouseholdID string
	Month       int
	Day         string
}

type Directory struct {
	// Title is the Directory Title the Title page and the PDF's metadata
	// carry. Build supplies DefaultTitle when the Editor has set none, so it is
	// never empty in a built Directory.
	Title string

	// GeneratedAt is the stamp every export carries. Age gating is computed at
	// export time, so the same Directory exported months apart differs as people
	// turn 18 — the date is what makes that legible (§5.7).
	GeneratedAt string

	// Tier names the audience in the footer (§5.8). Distribution is the real
	// control over an exported file, and a named tier is the social pressure
	// that goes with it.
	Tier string

	// Restricted puts DO NOT DISTRIBUTE on every page. Only Full sets it (§5.2).
	Restricted bool

	Households []Household

	// Birthdays is the Birthday Calendar printed after the Households, already
	// filtered and ordered. Empty when nobody qualifies, and then no calendar
	// prints at all.
	Birthdays []Birthday
}

type Household struct {
	// ID is the Household's stored ID. It is never printed: the template turns
	// it into a label marking where this block begins, so a Birthday Calendar
	// row can link to the block and print its page.
	ID string

	// Name is the Household Name the block prints under, e.g.
	// "Daryl & Dawn (Mitchell) Yoder" (CONTEXT.md). It is not rolo's Label:
	// that compact "Daryl/Dawn" form is a Path segment, for navigation, and
	// stays in the editing UI.
	Name string

	// Memorial marks a Household whose adults have all died. It renders more
	// quietly — grey, with no contact details — because there is nothing in it
	// to act on, but it must appear in every tier so that descendants group
	// beneath it and no Path points at a missing node (§5.4).
	Memorial bool

	// Contents marks a Household the Table of Contents lists: a root, or a
	// child of a root (CONTEXT.md). A deeper Household's block follows its
	// ancestor's, so the reader finds it from that entry. It is a layout flag,
	// not a rule about what the audience may see: every tier lists the same
	// Households, because every tier prints every Household.
	Contents bool

	// AddressLines is the Household's own address. Empty when it has none, and
	// also when it shares another Household's, in which case SharedWith is set.
	AddressLines []string

	// SharedWith is the Household Name of the Household whose address this one
	// uses, matching the heading the reader will look for. A shared Address
	// renders as a back-reference rather than a repeated block (§3), so the two
	// fields are never both populated.
	SharedWith string

	Anniversary string

	Adults     []Person
	Dependents []Person
}

type Person struct {
	Name  string
	Birth string
	Death string
	Phone string
	Email string
}

type Renderer struct {
	Typst       Typst
	TemplateDir string
}

type Tier int

type Typst struct {
	// Bin is the resolved path to the typst executable.
	Bin string
}