menu

type Bar struct {
	widget.WidgetBase
	// contains filtered or unexported fields
}

type BarOption func(*Bar)

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

type ContextMenuOption func(*ContextMenu)

type DefaultPainter struct{}

type MenuBarPaintState struct {
	// Bounds is the menu bar's bounds.
	Bounds geometry.Rect

	// Menus is the list of top-level menu definitions.
	Menus []TopMenu

	// MenuRects contains the bounding rectangles for each top-level menu label.
	MenuRects []geometry.Rect

	// OpenIndex is the index of the currently open top-level menu (-1 for none).
	OpenIndex int

	// HoveredIndex is the index of the hovered top-level menu label (-1 for none).
	HoveredIndex int

	// Focused is true if the menu bar has keyboard focus.
	Focused bool

	// ColorScheme provides theme-derived colors. Zero value means use defaults.
	ColorScheme MenuColorScheme
}

type MenuColorScheme struct {
	BarBackground    widget.Color
	BarText          widget.Color
	BarHover         widget.Color
	BarActiveText    widget.Color
	MenuBackground   widget.Color
	MenuBorder       widget.Color
	ItemText         widget.Color
	ItemHover        widget.Color
	ItemDisabledText widget.Color
	ShortcutText     widget.Color
	SeparatorColor   widget.Color
	SubMenuArrow     widget.Color
}

type MenuItem struct {
	// Label is the display text for this item.
	Label string

	// Shortcut is the keyboard shortcut display text (e.g., "Ctrl+S").
	// This is cosmetic only; actual shortcut handling is separate.
	Shortcut string

	// OnAction is the callback invoked when the item is activated.
	// Nil for separators and submenu parents.
	OnAction func()

	// Disabled prevents this item from being activated.
	Disabled bool

	// Children holds submenu items. If non-empty, this item opens a submenu
	// on hover instead of invoking OnAction.
	Children []MenuItem
	// contains filtered or unexported fields
}

type MenuPaintState struct {
	// Bounds is the menu panel's bounds in window coordinates.
	Bounds geometry.Rect

	// Items is the list of menu items.
	Items []MenuItem

	// HighlightedIndex is the index of the currently highlighted item (-1 for none).
	HighlightedIndex int

	// ItemHeight is the height of each regular item row.
	ItemHeight float32

	// SeparatorHeight is the height of separator rows.
	SeparatorHeight float32

	// SubMenuOpenIndex is the index of the item whose submenu is open (-1 for none).
	SubMenuOpenIndex int

	// ColorScheme provides theme-derived colors. Zero value means use defaults.
	ColorScheme MenuColorScheme
}

type Painter interface {
	// PaintMenuBar draws the horizontal menu bar background and top-level labels.
	PaintMenuBar(canvas widget.Canvas, state *MenuBarPaintState)

	// PaintMenu draws a popup menu panel with its items.
	PaintMenu(canvas widget.Canvas, state *MenuPaintState)
}

type PanelState interface {
	widget.Widget

	// Bounds returns the panel's bounding rectangle.
	Bounds() geometry.Rect

	// HighlightedIndex returns the currently highlighted item index (-1 for none).
	HighlightedIndex() int

	// SubMenuIndex returns the index of the item whose submenu is open (-1 for none).
	SubMenuIndex() int

	// SubMenuPanel returns the open submenu panel, or nil.
	SubMenuPanel() PanelState
}

type TopMenu struct {
	// Label is the text displayed in the menu bar.
	Label string

	// Items are the menu entries shown when this top-level menu is opened.
	Items []MenuItem
}