app

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

type Clock interface {
	Now() time.Time
	AfterFunc(d time.Duration, f func()) (stop func() bool)
}

type Deps struct {
	Svc      *core.Service
	Platform Platform
	Post     func(func())
	Clock    Clock
	OAuth    OAuthFlow

	// SystemLanguage is the system's language tag; the interface uses it
	// while Settings.UILanguage is "".
	SystemLanguage string
	// SetLanguage applies the UI preference; an empty tag follows the system.
	// By default only the catalog changes; the desktop also updates MyGo.
	SetLanguage func(string)

	// Vibrancy: the window has a material, which shows around the panel.
	Vibrancy bool

	// Logf logs what fails out of the user's sight (log.Printf by default).
	// Lines carry no secrets and no mail content.
	Logf func(format string, args ...any)

	// Dev: the build is a development one: the rail offers the Kit gallery.
	Dev bool
}

type Notification struct {
	ID, Title, Subtitle, Body string
	MessageID                 int64
	Sender                    string // only set when preview is enabled
	ThreadID                  int64
}

type OAuthFlow interface {
	Begin(ctx context.Context, provider, loginHint string) (flowID, authURL string, err error)
	Await(ctx context.Context, flowID string) (email string, err error)
	Cancel(flowID string)
}

type Page int

type Platform interface {
	OpenURL(url string) error
	OpenPath(path string) error
	OpenFiles(multiple bool) ([]string, error)
	OpenDirectory() (string, error)
	SaveFile(defaultName string) (string, error)
	Notify(n Notification) error
	NotificationsSupported() bool
	SetOpenAtLogin(on bool) error
	SetTrayUnread(n int)              // the inboxes' unread total on the tray; 0 clears it
	SetAppUnread(n int)               // the inboxes' unread total on the app icon; 0 clears it
	SetSignInCodes([]core.SignInCode) // replaces the tray's recent codes; UI thread
	ShowSignInCode(*core.SignInCode)  // a nonactivating copy card; nil dismisses it; UI thread
	SignInCodeBannerSupported() bool  // UI thread; false keeps ordinary mail notifications
	ShowWindow()                      // shows the window, in front
	SetThemeSource(theme string)
	TempDir() string
	// SetLocalAPI starts (on) or stops the Local API server for request
	// gen, returning its socket's path while on. Off when it fails. Blocks:
	// call off the UI thread.
	SetLocalAPI(gen uint64, on bool) (path string, err error)
	// DataDir is the data directory; custom: it is not the default one.
	DataDir() (dir string, custom bool)
	// OpenCompose shows draftID in a compose window of its own.
	OpenCompose(draftID int64)
	// ComposeOpen reports whether draftID's compose window is open or opening.
	// The platform tells the App when that changes: ComposeWindowsChanged.
	ComposeOpen(draftID int64) bool
	// DraftDeleted is told draft id was deleted here: its compose window,
	// if one is open, closes.
	DraftDeleted(id int64)
	// SettingsChanged is told the settings after every change.
	SettingsChanged(st core.Settings)
	// NewBodyView makes a reader page in the main window showing message's
	// body (bound to it before it loads); close unbinds and destroys it.
	// The page reports to BodyHeight, BodyWheel, BodyLink, BodyNavigate,
	// BodyBuilt and BodyFailed with the view. UI thread only; it may run
	// the event loop.
	NewBodyView(message int64) (view ui.NativeWebView, close func(), err error)
	// AllowImages lets the pages showing message load its remote images
	// (加载图片). Call it after NewBodyView: it forgets once the last page
	// of the message closes.
	AllowImages(message int64)
	// TranslateBody replaces only the body's text nodes; nil shows the original.
	TranslateBody(message int64, texts map[string]string)
	// NewSignatureView makes the signature page (the account settings'
	// rich-text editor) in the main window; the App makes one and closes
	// it (unregistered and destroyed) as it closes. show
	// switches it to account: the page saves the shown account's edit as
	// that account first. flush asks the page to save now; done hears
	// whether it did, on the UI thread, at most once. UI thread only.
	NewSignatureView() (view ui.NativeWebView, show func(account int64), flush func(done func(ok bool)), close func(), err error)
}

type Route struct {
	Page                                Page
	View                                core.View
	ThreadID, MessageID, ConversationID int64
	Settings                            string
}