font_detector.go RawHistoryFolder

1package port
2
3import "context"
4
5// FontCategory represents a category of fonts for fallback selection.
6type FontCategory string
7
8const (
9	// FontCategorySansSerif is for sans-serif fonts (UI text).
10	FontCategorySansSerif FontCategory = "sans-serif"
11	// FontCategorySerif is for serif fonts (reading content).
12	FontCategorySerif FontCategory = "serif"
13	// FontCategoryMonospace is for monospace fonts (code, fixed-width).
14	FontCategoryMonospace FontCategory = "monospace"
15)
16
17// FontDetector detects available system fonts and selects the best
18// font from a fallback chain. This is used during first-run config
19// creation to ensure configured fonts are actually installed.
20type FontDetector interface {
21	// GetAvailableFonts returns a list of font family names installed on the system.
22	// Returns an error if font detection is not available (e.g., fc-list missing).
23	GetAvailableFonts(ctx context.Context) ([]string, error)
24
25	// SelectBestFont returns the first available font from the fallback chain,
26	// or the generic CSS fallback (e.g., "sans-serif") if none are installed.
27	// The category is used to determine the generic fallback.
28	SelectBestFont(ctx context.Context, category FontCategory, fallbackChain []string) string
29
30	// IsAvailable returns true if font detection is available on this system.
31	IsAvailable(ctx context.Context) bool
32}