themehost

type Error struct {
	// Code names the rule the theme broke, for a client that translates it.
	Code string
	// Reason names the rule the theme broke, in words fit for an admin screen.
	Reason string
	// Detail is what went wrong underneath, for the log.
	Detail error
	// Held names the values the reason's translation asks for.
	Held map[string]any
}

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

type Installed struct {
	// Name is the directory the theme is installed under.
	Name string
	// Version is what the manifest declares, empty when the theme will not load.
	Version string
	// Broken is why the theme will not load, empty when it loads.
	Broken string
	// Active reports whether this theme is the operator's current choice.
	Active bool
	// Serving reports whether the public site is answered by this theme right now.
	Serving bool
	// StartFailed reports whether the supervisor stopped trying to start this theme.
	StartFailed bool
}

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

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

type ManagerConfig struct {
	// Library is the managed themes directory.
	Library *Library
	// Settings persists which theme is active.
	Settings Settings
	// Pinned is the theme an operator fixed by environment, empty when the stored choice governs.
	Pinned string
	// Supervision is how an activated theme is run. The manager fills in the theme itself.
	Supervision SupervisorConfig
}

type Settings interface {
	// Lookup returns the value stored under key and whether the key is set at all.
	Lookup(ctx context.Context, key string) (string, bool, error)
	// Save stores every given value, or stores none of them.
	Save(ctx context.Context, values map[string]string) error
}

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

type SupervisorConfig struct {
	Theme        *Theme
	NodeBin      string
	APIAddr      string
	Logger       *slog.Logger
	ReadyTimeout time.Duration
	Backoff      time.Duration
	MaxBackoff   time.Duration
	MaxAttempts  int
	StopGrace    time.Duration
	StubDelay    time.Duration
}

type Theme struct {
	Name    string
	Version string
	Kit     string
	Dir     string
	Entry   string
}