text

type EngineLayout interface {
	// Text returns a readonly slice of the text in the layout
	Text() []rune

	// Metrics may return nil when [TextDecorationLine] is empty
	Metrics() *LineMetrics

	// Justification returns the current justification
	Justification() pr.Float
	// SetJustification add an additional spacing between words
	// to justify text. Depending on the implementation, it
	// may be ignored until [ApplyJustification] is called.
	SetJustification(spacing pr.Float)

	ApplyJustification()
}

type Feature struct {
	Tag   [4]byte
	Value int
}

type FontConfiguration interface {
	// FontContent returns the content of the given font, which may be needed
	// in the final output.
	FontContent(font FontOrigin) []byte

	// AddFontFace load a font file from an external source, using
	// the given [urlFetcher], which must be valid.
	//
	// It returns the file name of the loaded file.
	AddFontFace(ruleDescriptors validation.FontFaceDescriptors, urlFetcher utils.UrlFetcher) string
	// contains filtered or unexported methods
}

type FontConfigurationPango struct {
	// contains filtered or unexported fields
}

type FontOrigin struct {
	File string // The filename or identifier of the font file.

	// The index of the face in a collection. It is always 0 for
	// single font files.
	Index uint16

	// For variable fonts, stores 1 + the instance index.
	// (0 to ignore variations).
	Instance uint16
}

type FontStretch uint8

type FontStyle uint8

type HyphenDictKey struct {
	// contains filtered or unexported fields
}

type HyphenateZone struct {
	Limit        pr.Fl
	IsPercentage bool
}

type Hyphens uint8

type LineMetrics struct {
	// Distance from the baseline to the logical top of a line of text.
	// (The logical top may be above or below the top of the
	// actual drawn ink. It is necessary to lay out the text to figure
	// where the ink will be.)
	Ascent pr.Fl

	// Distance above the baseline of the top of the underline.
	// Since most fonts have underline positions beneath the baseline, this value is typically negative.
	UnderlinePosition pr.Fl

	// Suggested thickness to draw for the underline.
	UnderlineThickness pr.Fl

	// Distance above the baseline of the top of the strikethrough.
	StrikethroughPosition pr.Fl
	// Suggested thickness to draw for the strikethrough.
	StrikethroughThickness pr.Fl
}

type OverflowWrap uint8

type Splitted struct {
	// Output layout containing (at least) the first line
	Layout EngineLayout

	// Length in runes of the first line
	Length int

	// ResumeAt is the number of runes to skip for the next line.
	// May be -1 if the whole text fits in one line.
	// This may be greater than [Length] in case of preserved
	// newline characters.
	ResumeAt int

	// Width is the width in pixels of the first line
	Width pr.Float

	// Height is the height in pixels of the first line
	Height pr.Float

	// Baseline is the baseline in pixels of the first line
	Baseline pr.Float

	FirstLineRTL bool // true is the first line direction is RTL
}

type StrutLayoutKey struct {
	// contains filtered or unexported fields
}

type TabSize struct {
	Width      int
	IsMultiple bool // true to use Width * <space character width>
}

type TextLayoutContext interface {
	Fonts() FontConfiguration
	HyphenCache() map[HyphenDictKey]hyphen.Hyphener
	StrutLayoutsCache() map[StrutLayoutKey][2]pr.Float
}

type TextLayoutPango struct {
	Style *TextStyle

	MaxWidth pr.MaybeFloat

	Layout pango.Layout
	// contains filtered or unexported fields
}

type TextStyle struct {
	TextDecorationLine pr.Decorations

	// FontFeatures stores the resolved value
	// for all the CSS properties related :
	// 	"font-kerning"
	// 	"font-variant-ligatures"
	// 	"font-variant-position"
	// 	"font-variant-caps"
	// 	"font-variant-numeric"
	// 	"font-variant-alternates"
	// 	"font-variant-east-asian"
	// 	"font-feature-settings"
	FontFeatures []Feature

	FontFamily            []string
	FontStyle             FontStyle
	FontStretch           FontStretch
	FontWeight            int
	FontSize              pr.Fl
	FontVariationSettings []Variation // empty for 'normal'

	FontLanguageOverride fontLanguageOverride
	Lang                 string

	WhiteSpace   Whitespace
	OverflowWrap OverflowWrap
	WordBreak    WordBreak

	Hyphens             Hyphens
	HyphenateCharacter  string
	HyphenateLimitChars pr.Ints3
	HyphenateLimitZone  HyphenateZone

	WordSpacing   pr.Fl
	LetterSpacing pr.Fl // 0 for 'normal'
	TabSize       TabSize
}

type Variation struct {
	Tag   [4]byte
	Value pr.Fl
}

type Whitespace uint8

type WordBreak uint8