build

type FontCheck struct {
	// Fonts are the fonts that resolved, sorted by name
	// as a printout header holds them.
	Fonts []printout.FontEntry
	// Failures name the fonts that did not resolve, one message each.
	Failures []string
	// Warnings are diagnostics about the document: a typeface that reached
	// the substitute, a face whose style bits contradict the declaration.
	Warnings []string
	// Diagnostics describe the machine rather than the document:
	// a font file that could not be read, two faces claiming one identity.
	Diagnostics []string
}

type Options struct {
	// TextParams are values supplied as text, parsed per the parameter's type.
	TextParams map[string]string
	// Values are values supplied already typed.
	Values map[string]starlark.Value
	// BuildTime fixes BUILD_TIME. The zero value means now.
	BuildTime gotime.Time
	// StrictFonts resolves only fonts the template names by file or data.
	StrictFonts bool
	// AllowOverflow downgrades oversized-band errors to warnings
	// recorded in the printout.
	AllowOverflow bool
	// Engine names the producing engine in the printout header.
	Engine string
	// Diagnostics receives messages about the machine: fonts that
	// could not be read, faces that collided. They describe the host
	// rather than the document, so they never enter the printout's warning list.
	Diagnostics func(string)
}