dialog

type ColorPicker struct {
	// Title is the colour picker window title (may be empty) e.g. "Colour".
	// If omitted, defaults to en-US "Color".
	Title string

	// Palette controls the color picker mode. If false, this is a simple
	// colour picker suited for picking a colour as a "one-off" e.g. with
	// sliders or by typing in a value. If true, where supported, this is
	// an extended picker with support for a palette where the user can
	// define favourite colours and easily pick those colours again later.
	Palette bool

	// Initial specifies the colour initially picked by default in the dialog.
	// For example, in a painting tool, you might want to set a default to
	// black. Or, if your application manages its own palette of colours, you
	// might want to launch the color picker with an existing palette colour so
	// that the user can adjust it slightly.
	Initial color.Color
}

type DatePicker struct {
	// Title is the date picker window title (may be empty). For example,
	// "Date of publication".
	Title string

	// LongTitle is some extra text (may be empty) that, where supported, can
	// give the user further context for the date picker. For example, "Select
	// date article first published".
	LongTitle string

	// Initial specifies the date initially picked by default in the dialog.
	// If not set, defaults to the current day.
	Initial time.Time

	// Location is used to return a location and timezone-aware time. If nil,
	// defaults to the user's configured location and timezone (i.e. [time.Local]).
	// For example, set this to [time.UTC].
	Location *time.Location
}

type FilePicker struct {
	// Title is the file picker window title (may be empty) e.g. "Open" or
	// "Save". If the implementation has a locale-aware default, then this
	// is ignored and the default is used instead.
	Title string

	// Path is the initial file selected (if empty, defaults to
	// current working directory). To open in a specific directory without
	// specifying a file name, use a trailing slash.
	Path string

	// FileTypes is hint describing known file types and file extensions. It
	// may be used to filter visible files. May be nil. This is a slice of
	// 2-tuples. The first item in the tuple is a human-readable label, the
	// second item in the tuple is a list of patterns delimited by space. Can
	// be left as nil as default. ("All Files", "*.*") is automatically added
	// to the end if the last item doesn't have the exact filter "*.*".
	//
	// For example:
	//
	//   FileTypes: [][2]string{
	//       {"Text Document", "*.txt *.rtf"},
	//       {"Image",         "*.png"},
	//       ...
	//       {"Pob Ffeil",      "*.*"}, // suppress English "All Files"
	//   }
	FileTypes [][2]string

	// DefaultFileType is an index into the FileTypes array identifying the
	// default file type to use.
	DefaultFileType int

	// AlwaysShowHidden, if true, is a hint that hidden files should always be
	// revealed if possible. If false, is a hint that hidden files should be
	// shown, or not shown, as normal depending on the user's settings.
	AlwaysShowHidden bool

	// AddToRecent, if true, is a hint that the opened or saved file should
	// be added to the user's history of recent files. If false, is a hint
	// that the file should not be added to that history.
	AddToRecent bool
}

type IconType int

type Message struct {
	// Title is the message box window title (may be empty).
	Title string

	// Format is a printf-style format string. This is word-wrapped for you.
	Format string

	// Args are printf-style arguments
	Args []interface{}

	// Icon is a IconInfo, IconWarning, or IconError and is displayed when
	// possible on the message box.
	Icon IconType
}

type Support struct {
	MessageRaise    bool // Can use Message.Raise?
	MessageAsk      bool // Can use Message.Ask?
	FilePicker      bool // Can use FilePicker.Open, FilePicker.Save?
	MultiFilePicker bool // Can use FilePicker.OpenMultiple?
	ColorPicker     bool // Can use ColorPicker.Pick?
	DatePicker      bool // Can use DatePicker.Pick?
}