external_theme.go RawHistoryFolder

1package port
2
3import (
4	"context"
5
6	"github.com/bnema/dumber/internal/domain/entity"
7)
8
9// ExternalThemeSource provides access to an external theme provider (e.g., Noctalia).
10// It must not import GTK, WebKit, CEF, lipgloss, fsnotify, Viper, or infrastructure config.
11type ExternalThemeSource interface {
12	// Get returns the current external theme, or nil if no external theme is available.
13	// An error indicates a transient I/O problem (e.g., connection lost).
14	// A nil theme with nil error means the source is enabled but has no theme data yet.
15	Get(ctx context.Context) (*entity.ExternalTheme, error)
16
17	// IsEnabled returns true if the external theme source is enabled.
18	// When disabled, the usecase should fall back to config/default palettes.
19	IsEnabled() bool
20}
21
22// ExternalThemeIdentityProvider exposes a stable source identity for last-good cache invalidation.
23// Implementations should change this value when the configured provider/format/path changes.
24type ExternalThemeIdentityProvider interface {
25	ExternalThemeIdentity() string
26}
27
28// ConfigurableExternalThemeSource is an external source whose settings can be
29// updated from a new config snapshot without replacing the ResolveThemeUseCase.
30type ConfigurableExternalThemeSource interface {
31	ExternalThemeSource
32	ExternalThemeIdentityProvider
33	Configure(entity.ExternalThemeConfig)
34}
35
36// ExternalThemeWatcher watches an external theme source and notifies callers
37// when they should refresh the resolved theme through the shared apply path.
38type ExternalThemeWatcher interface {
39	Start(ctx context.Context, cfg entity.ExternalThemeConfig, onChange func()) error
40	Stop() error
41}