gutter

type GutterClickEvent struct {
	// ProviderID is the ID of the provider that was clicked.
	ProviderID string

	// Line is the 0-based line number that was clicked.
	Line int

	// Source indicates the pointer source (mouse, touch, etc.).
	Source pointer.Source

	// NumClicks is the number of successive clicks.
	NumClicks int

	// Modifiers indicates which modifier keys were held.
	Modifiers key.Modifiers
}

type GutterColors struct {
	// Text is the default text color for gutter content.
	Text gvcolor.Color

	// TextHighlight is the text color for highlighted content (e.g., current line number).
	TextHighlight gvcolor.Color

	// Background is the background color for the gutter area.
	Background gvcolor.Color

	// LineHighlight is the color used to highlight the current line background.
	LineHighlight gvcolor.Color

	// Custom contains provider-specific colors, keyed by provider ID or custom name.
	Custom map[string]gvcolor.Color
}

type GutterContext struct {
	// Shaper is the text shaper used for rendering text.
	Shaper *text.Shaper

	// TextParams contains the text parameters for shaping.
	TextParams text.Parameters

	// Viewport is the visible area in document coordinates.
	Viewport image.Rectangle

	// Paragraphs contains metadata for visible lines.
	Paragraphs []Paragraph

	// CurrentLine is the line number where the caret is located.
	// It is -1 if the selection spans multiple lines.
	CurrentLine int

	// LineHeight is the calculated line height in fixed-point format.
	LineHeight fixed.Int26_6

	// Colors provides the color scheme for gutter rendering.
	Colors *GutterColors
}

type GutterEvent interface {
	// contains filtered or unexported methods
}

type GutterHoverEvent struct {
	// ProviderID is the ID of the provider being hovered.
	ProviderID string

	// Line is the 0-based line number being hovered.
	Line int

	// Info contains the hover information provided by the provider.
	Info *HoverInfo
}

type GutterProvider interface {
	// ID returns a unique identifier for this provider.
	ID() string

	// Priority determines the rendering order. Lower values are rendered
	// closer to the text area (rightmost in the gutter).
	Priority() int

	// Width returns the width needed by this provider for the given context.
	// The lineCount parameter indicates the total number of lines in the document,
	// which can be used to calculate width (e.g., for line numbers).
	Width(gtx layout.Context, shaper *text.Shaper, params text.Parameters, lineCount int) unit.Dp

	// Layout renders the gutter content for the visible lines.
	Layout(gtx layout.Context, ctx GutterContext) layout.Dimensions
}

type HoverInfo struct {
	// Text is a simple text description to show in a tooltip.
	Text string

	// Widget is an optional custom widget to render for the hover effect.
	// If provided, it takes precedence over Text.
	Widget layout.Widget
}

type InteractiveGutter interface {
	GutterProvider

	// HandleClick is called when the user clicks on this provider's area.
	// It receives the line number that was clicked, the pointer source (mouse/touch),
	// the number of clicks, and active key modifiers.
	// Returns true if the event was handled.
	HandleClick(line int, source pointer.Source, numClicks int, modifiers key.Modifiers) bool

	// HandleHover is called when the user hovers over this provider's area.
	// It receives the line number being hovered and returns hover information,
	// or nil if no hover effect should be shown.
	HandleHover(line int) *HoverInfo
}

type LineHighlight struct {
	// Line is the 0-based line index to highlight.
	Line int

	// Color is the background color for the highlight.
	Color gvcolor.Color
}

type LineHighlighter interface {
	// HighlightedLines returns the lines that should be highlighted.
	// This is called after Layout to collect highlights from all providers.
	HighlightedLines() []LineHighlight
}

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

type Paragraph struct {
	// StartY is the baseline Y coordinate of the first screen line in the paragraph.
	StartY int

	// EndY is the baseline Y coordinate of the last screen line in the paragraph.
	EndY int

	// Ascent is the distance from baseline to the top of glyphs.
	Ascent fixed.Int26_6

	// Descent is the distance from baseline to the bottom of glyphs.
	Descent fixed.Int26_6

	// Runes is the number of runes in this paragraph.
	Runes int

	// RuneOff is the rune offset of the first rune in this paragraph.
	RuneOff int

	// Index is the 0-based line number of this paragraph.
	Index int
}