Modern Docker Management, Designed for Everyone
Go composecontainer-managementcontainersdockerdocker-composedocker-managementgoself-hostedsveltekittypescriptweb-ui
// Package iconcatalog resolves Arcane icon metadata into catalog URLs.
package iconcatalog
import (
"cmp"
"fmt"
"net/url"
"strings"
kit "go.getarcane.app/kit/pkg"
)
const (
CatalogSelfhst = "selfhst"
CatalogDashboardIcons = "dashboard-icons"
DefaultCatalog = CatalogSelfhst
)
type IconSet struct {
Icon string
Light string
Dark string
}
type ResolvedIconSet struct {
IconLightURL string
IconDarkURL string
}
func (s IconSet) IsEmpty() bool {
return strings.TrimSpace(s.Icon) == "" &&
strings.TrimSpace(s.Light) == "" &&
strings.TrimSpace(s.Dark) == ""
}
func Resolve(catalog string, set IconSet) ResolvedIconSet {
selectedCatalog := Normalize(catalog)
if strings.TrimSpace(set.Light) == "" && strings.TrimSpace(set.Dark) == "" {
generic := resolveValueInternal(selectedCatalog, set.Icon, "")
return ResolvedIconSet{
IconLightURL: generic,
IconDarkURL: generic,
}
}
light := cmp.Or(kit.TrimNonEmpty([]string{set.Light, set.Icon, set.Dark})...)
dark := cmp.Or(kit.TrimNonEmpty([]string{set.Dark, set.Icon, set.Light})...)
return ResolvedIconSet{
IconLightURL: resolveValueInternal(selectedCatalog, light, "light"),
IconDarkURL: resolveValueInternal(selectedCatalog, dark, "dark"),
}
}
// Normalize maps a raw catalog preference onto one of the known catalog
// constants, falling back to the default for unknown values.
func Normalize(catalog string) string {
switch strings.ToLower(strings.TrimSpace(catalog)) {
case CatalogDashboardIcons:
return CatalogDashboardIcons
default:
return DefaultCatalog
}
}
func resolveValueInternal(catalog, raw, variant string) string {
value := strings.TrimSpace(raw)
if value == "" || strings.HasPrefix(strings.ToLower(value), "data:") {
return ""
}
if isAbsoluteHTTPURLInternal(value) {
return value
}
slug := url.PathEscape(value)
switch catalog {
case CatalogDashboardIcons:
return fmt.Sprintf("https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/svg/%s.svg", slug)
default:
if variant != "" {
slug += "-" + variant
}
return fmt.Sprintf("https://cdn.jsdelivr.net/gh/selfhst/icons@main/svg/%s.svg", slug)
}
}
func isAbsoluteHTTPURLInternal(raw string) bool {
u, err := url.Parse(raw)
if err != nil {
return false
}
return u.IsAbs() && (u.Scheme == "http" || u.Scheme == "https")
}