config

type CustomService struct {
	Name          string            `yaml:"name"`
	Image         string            `yaml:"image"`
	Ports         []string          `yaml:"ports,omitempty"`
	Environment   map[string]string `yaml:"environment,omitempty"`
	DataDir       string            `yaml:"data_dir,omitempty"`
	Exec          string            `yaml:"exec,omitempty"`
	EnvVars       []string          `yaml:"env_vars,omitempty"`
	EnvDetect     *EnvDetect        `yaml:"env_detect,omitempty"`
	SiteInit      *SiteInit         `yaml:"site_init,omitempty"`
	Dashboard     string            `yaml:"dashboard,omitempty"`
	ConnectionURL string            `yaml:"connection_url,omitempty"`
	Description   string            `yaml:"description,omitempty"`
	DependsOn     []string          `yaml:"depends_on,omitempty"`
	Files         []FileMount       `yaml:"files,omitempty"`
	// Family groups related services so admin UIs can auto-discover every
	// member. e.g. the mysql preset declares family: mysql, and phpMyAdmin
	// uses dynamic_env to read all family members at quadlet generation time.
	Family string `yaml:"family,omitempty"`
	// Preset is the bundled preset name this service was installed from.
	// Set by InstallPresetByName. Used so the init wizard can store a
	// preset reference in .lerd.yaml instead of an inlined definition.
	Preset string `yaml:"preset,omitempty"`
	// PresetVersion is the picked version tag for multi-version presets.
	// Empty for single-version presets.
	PresetVersion string `yaml:"preset_version,omitempty"`
	// ShareHosts mounts the browser-testing hosts file
	// (~/.local/share/lerd/browser-hosts) into the container at /etc/hosts,
	// so the container can resolve .test domains to the nginx container's IP
	// on the Podman network. Used by browser testing services like Selenium
	// that need to reach lerd sites by domain name.
	ShareHosts bool `yaml:"share_hosts,omitempty" json:"share_hosts,omitempty"`
	// DynamicEnv declares container env vars whose value is computed at
	// quadlet generation time. Currently supported directive:
	//   discover_family:<name>  -> comma-joined hostnames of every installed
	//   service in the named family (built-in or custom).
	DynamicEnv map[string]string `yaml:"dynamic_env,omitempty"`
}

type EnvDetect struct {
	Key         string `yaml:"key,omitempty"`
	ValuePrefix string `yaml:"value_prefix,omitempty"`
	// Composer triggers detection when the named package is present in the
	// project's composer.json (require or require-dev). Used instead of Key
	// when the service should be auto-detected by a dependency rather than
	// an existing .env variable (e.g. selenium detected via laravel/dusk).
	Composer string `yaml:"composer,omitempty"`
}

type EnvKeyGeneration struct {
	EnvKey         string `yaml:"env_key"`                   // env var to check/set (e.g. "APP_KEY")
	Command        string `yaml:"command,omitempty"`         // artisan command to run if vendor/ exists (e.g. "key:generate")
	FallbackPrefix string `yaml:"fallback_prefix,omitempty"` // prefix for random key fallback (e.g. "base64:")
}

type FileMount struct {
	// Target is the absolute path inside the container where the file appears.
	Target string `yaml:"target"`
	// Content is the literal file body, written verbatim.
	Content string `yaml:"content"`
	// Mode is the octal permission bits, e.g. "0600". Defaults to "0644".
	Mode string `yaml:"mode,omitempty"`
	// Chown adds the :U flag to the volume mount so podman re-chowns the file
	// to match the container's expected UID. Required when the in-container
	// process runs as a non-root user (e.g. pgAdmin runs as uid 5050) and the
	// file mode would otherwise hide it from that user (e.g. 0600).
	Chown bool `yaml:"chown,omitempty"`
}

type Framework struct {
	Name  string `yaml:"name"`
	Label string `yaml:"label"`
	// Version is the framework major version this definition targets (e.g. "11", "7").
	Version string `yaml:"version,omitempty"`
	// PHP defines the supported PHP version range for this framework version.
	PHP       FrameworkPHP               `yaml:"php,omitempty"`
	Detect    []FrameworkRule            `yaml:"detect,omitempty"`
	PublicDir string                     `yaml:"public_dir"`
	Env       FrameworkEnvConf           `yaml:"env,omitempty"`
	Composer  string                     `yaml:"composer,omitempty"` // auto | true | false
	NPM       string                     `yaml:"npm,omitempty"`      // auto | true | false
	Workers   map[string]FrameworkWorker `yaml:"workers,omitempty"`
	Setup     []FrameworkSetupCmd        `yaml:"setup,omitempty"`
	// Console is the console command to run (without 'php' prefix).
	// Example: "artisan", "bin/console"
	Console string `yaml:"console,omitempty"`
	// Create is the scaffold command used by "lerd new". The target directory is appended automatically.
	// Example: "composer create-project --no-install --no-plugins --no-scripts laravel/laravel"
	Create string `yaml:"create,omitempty"`
	// Logs defines where application log files live for this framework.
	Logs []FrameworkLogSource `yaml:"logs,omitempty"`
	// Favicon is the path to the favicon file relative to the public directory.
	// When set, detectFavicon checks this path in addition to the standard candidates.
	// Example: "core/misc/favicon.ico" for Drupal.
	Favicon string `yaml:"favicon,omitempty"`
}

type FrameworkEnvConf struct {
	File           string `yaml:"file,omitempty"`            // primary env file (relative to project)
	ExampleFile    string `yaml:"example_file,omitempty"`    // example to copy from if File missing
	Format         string `yaml:"format,omitempty"`          // dotenv | php-const (default: dotenv)
	FallbackFile   string `yaml:"fallback_file,omitempty"`   // used when File doesn't exist
	FallbackFormat string `yaml:"fallback_format,omitempty"` // format for FallbackFile

	// URLKey is the env key that holds the application URL (default: APP_URL).
	URLKey string `yaml:"url_key,omitempty"`

	// Services defines per-service detection rules and env vars to apply.
	// Keys match the built-in service names: mysql, postgres, redis, meilisearch, rustfs, mailpit.
	Services map[string]FrameworkServiceDef `yaml:"services,omitempty"`

	// KeyGeneration describes how to generate an application key if missing.
	KeyGeneration *EnvKeyGeneration `yaml:"key_generation,omitempty"`
}

type FrameworkFetchFunc func(name, version string) (*Framework, error)

type FrameworkFile struct {
	Path    string
	Version string // "" for unversioned
	Source  FrameworkSource
}

type FrameworkInfo struct {
	*Framework
	Source FrameworkSource
}

type FrameworkLogSource struct {
	Path   string `yaml:"path"`             // glob relative to project root, e.g. "storage/logs/*.log"
	Format string `yaml:"format,omitempty"` // "monolog" | "raw" (default: "raw")
}

type FrameworkPHP struct {
	Min string `yaml:"min,omitempty"` // minimum PHP version (e.g. "8.2")
	Max string `yaml:"max,omitempty"` // maximum PHP version (e.g. "8.4")
}

type FrameworkRule struct {
	File             string   `yaml:"file,omitempty"`              // file must exist in project root
	Composer         string   `yaml:"composer,omitempty"`          // package must be in composer.json require/require-dev
	ComposerSections []string `yaml:"composer_sections,omitempty"` // extra composer.json keys to search (e.g. flex-require)
	VersionKey       string   `yaml:"version_key,omitempty"`       // dot-path to version in composer.json (e.g. extra.symfony.require)
	VersionFile      string   `yaml:"version_file,omitempty"`      // file to read version from (relative to project root)
	VersionPattern   string   `yaml:"version_pattern,omitempty"`   // regex with capture group for version (e.g. "\\$wp_version = '([^']+)'")
}

type FrameworkServiceDef struct {
	// Detect lists env key conditions; any match signals the service is in use.
	Detect []FrameworkServiceDetect `yaml:"detect,omitempty"`
	// Vars is the list of KEY=VALUE pairs to apply when the service is detected.
	// Use {{site}} for the per-project database name.
	Vars []string `yaml:"vars,omitempty"`
}

type FrameworkServiceDetect struct {
	Key         string `yaml:"key"`
	ValuePrefix string `yaml:"value_prefix,omitempty"`
}

type FrameworkSetupCmd struct {
	Label   string         `yaml:"label"`
	Command string         `yaml:"command"`
	Default bool           `yaml:"default,omitempty"`
	Check   *FrameworkRule `yaml:"check,omitempty"` // only show when check passes (file exists or composer package installed)
}

type FrameworkSource string

type FrameworkWorker struct {
	Label         string         `yaml:"label,omitempty"`
	Command       string         `yaml:"command"`
	Restart       string         `yaml:"restart,omitempty"`        // always | on-failure (default: always)
	Schedule      string         `yaml:"schedule,omitempty"`       // systemd OnCalendar expression (e.g. "minutely"); when set, the worker is run as a Type=oneshot service triggered by a .timer rather than a long-running daemon. Use this for Laravel <=10 schedule:run, cron-style cleanup tasks, etc.
	Check         *FrameworkRule `yaml:"check,omitempty"`          // only show when check passes (file exists or composer package installed)
	ConflictsWith []string       `yaml:"conflicts_with,omitempty"` // workers to stop before starting this one (e.g. horizon conflicts_with queue)
	Proxy         *WorkerProxy   `yaml:"proxy,omitempty"`          // WebSocket/HTTP proxy config for nginx
}

type GlobalConfig struct {
	PHP struct {
		DefaultVersion string              `yaml:"default_version" mapstructure:"default_version"`
		XdebugEnabled  map[string]bool     `yaml:"xdebug_enabled"  mapstructure:"xdebug_enabled"`
		Extensions     map[string][]string `yaml:"extensions"      mapstructure:"extensions"`
	} `yaml:"php" mapstructure:"php"`
	Node struct {
		DefaultVersion string `yaml:"default_version" mapstructure:"default_version"`
	} `yaml:"node" mapstructure:"node"`
	Nginx struct {
		HTTPPort  int `yaml:"http_port"  mapstructure:"http_port"`
		HTTPSPort int `yaml:"https_port" mapstructure:"https_port"`
	} `yaml:"nginx" mapstructure:"nginx"`
	DNS struct {
		TLD string `yaml:"tld" mapstructure:"tld"`
	} `yaml:"dns" mapstructure:"dns"`
	LAN struct {
		// Exposed controls whether lerd's services are reachable from
		// other devices on the local network. When false (the default,
		// safe-on-coffee-shop-wifi state) every container PublishPort is
		// rewritten to bind 127.0.0.1, lerd-ui binds 127.0.0.1:7073, and
		// the lerd-dns-forwarder is stopped. When true, container ports
		// bind 0.0.0.0, lerd-ui binds 0.0.0.0:7073, dnsmasq is rewritten
		// to answer .test queries with the host's LAN IP, and the
		// userspace lerd-dns-forwarder runs to bridge LAN-IP:5300 to the
		// loopback-only DNS container.
		//
		// Toggled via `lerd lan:expose on/off`. The previous standalone
		// `dns:expose` flag was folded in here because there is no
		// meaningful state where the DNS resolver answers the LAN but
		// the actual services don't.
		Exposed bool `yaml:"exposed,omitempty" mapstructure:"exposed"`
	} `yaml:"lan,omitempty" mapstructure:"lan"`
	Autostart struct {
		// Disabled controls whether lerd boots itself at login. The
		// zero value (false) means lerd autostarts as it always has:
		// every lerd-* container quadlet ships with its [Install]
		// section, the podman generator wires it into
		// default.target.wants on every daemon-reload, and the
		// lerd-ui / lerd-watcher / per-site worker units are enabled.
		// Setting this to true makes WriteQuadletDiff strip the
		// [Install] section before write (so the generator stops
		// emitting wants symlinks), disables ui/watcher and every
		// per-site worker, and stops them. Toggled via
		// `lerd autostart enable / disable` and the dashboard / tray
		// switches.
		//
		// Inverted form (Disabled rather than Enabled) so the YAML zero
		// value preserves the historical autostart-on behaviour for
		// every existing install — users who never touch the toggle
		// see no change.
		Disabled bool `yaml:"disabled,omitempty" mapstructure:"disabled"`
	} `yaml:"autostart,omitempty" mapstructure:"autostart"`
	UI struct {
		// RemoteControl gates non-loopback access to the lerd dashboard.
		// Empty PasswordHash = disabled = LAN clients get 403. With a hash
		// set, LAN clients must present matching HTTP Basic auth. Loopback
		// (127.0.0.1, ::1) always bypasses both checks.
		Username     string `yaml:"username,omitempty" mapstructure:"username"`
		PasswordHash string `yaml:"password_hash,omitempty" mapstructure:"password_hash"`
	} `yaml:"ui,omitempty" mapstructure:"ui"`
	ParkedDirectories []string                 `yaml:"parked_directories" mapstructure:"parked_directories"`
	Services          map[string]ServiceConfig `yaml:"services"           mapstructure:"services"`
}

type Preset struct {
	CustomService  `yaml:",inline"`
	Versions       []PresetVersion `yaml:"versions,omitempty"`
	DefaultVersion string          `yaml:"default_version,omitempty"`
}

type PresetMeta struct {
	Name           string          `json:"name"`
	Description    string          `json:"description"`
	Dashboard      string          `json:"dashboard,omitempty"`
	DependsOn      []string        `json:"depends_on,omitempty"`
	Image          string          `json:"image"`
	Versions       []PresetVersion `json:"versions,omitempty"`
	DefaultVersion string          `json:"default_version,omitempty"`
}

type PresetVersion struct {
	Tag   string `yaml:"tag" json:"tag"`
	Label string `yaml:"label,omitempty" json:"label,omitempty"`
	Image string `yaml:"image" json:"image"`
	// HostPort is the host-side port published for this specific version.
	// Each version gets its own fixed port so multiple alternates can run
	// side by side without colliding. Substituted into the family's
	// templated ports, env_vars and connection_url via {{host_port}}.
	HostPort int `yaml:"host_port,omitempty" json:"host_port,omitempty"`
}

type ProjectConfig struct {
	Domains          []string                   `yaml:"domains,omitempty"`
	PHPVersion       string                     `yaml:"php_version,omitempty"`
	NodeVersion      string                     `yaml:"node_version,omitempty"`
	Framework        string                     `yaml:"framework,omitempty"`
	FrameworkVersion string                     `yaml:"framework_version,omitempty"`
	FrameworkDef     *Framework                 `yaml:"framework_def,omitempty"`
	Secured          bool                       `yaml:"secured,omitempty"`
	Services         []ProjectService           `yaml:"services,omitempty"`
	Workers          []string                   `yaml:"workers,omitempty"`
	CustomWorkers    map[string]FrameworkWorker `yaml:"custom_workers,omitempty"`
	// AppURL, when set, is the value lerd writes to the project's APP_URL (or
	// the framework-configured URL key) on every `lerd env` run. Committed to
	// the repo so the choice is shared across machines. Takes precedence over
	// the per-machine override in sites.yaml.
	AppURL string `yaml:"app_url,omitempty"`
}

type ProjectService struct {
	Name          string
	Preset        string         // empty unless this is a preset reference
	PresetVersion string         // empty for single-version presets
	Custom        *CustomService // nil unless this is an inline definition
}

type ServiceConfig struct {
	Enabled    bool     `yaml:"enabled"      mapstructure:"enabled"`
	Image      string   `yaml:"image"        mapstructure:"image"`
	Port       int      `yaml:"port"         mapstructure:"port"`
	ExtraPorts []string `yaml:"extra_ports"  mapstructure:"extra_ports"`
}

type Site struct {
	Name          string   `yaml:"-"`
	Domains       []string `yaml:"-"`
	Path          string   `yaml:"path"`
	PHPVersion    string   `yaml:"php_version"`
	NodeVersion   string   `yaml:"node_version"`
	Secured       bool     `yaml:"secured"`
	Ignored       bool     `yaml:"ignored,omitempty"`
	Paused        bool     `yaml:"paused,omitempty"`
	PausedWorkers []string `yaml:"paused_workers,omitempty"`
	Framework     string   `yaml:"framework,omitempty"`
	PublicDir     string   `yaml:"public_dir,omitempty"`
	// AppURL, when set, is the per-machine override for APP_URL in the
	// project's env file. Lower priority than ProjectConfig.AppURL (which is
	// committed to the repo) and higher priority than the default generator
	// (`<scheme>://<primary-domain>`). Use this for personal customizations
	// you don't want to share via .lerd.yaml.
	AppURL string `yaml:"app_url,omitempty"`
}

type SiteInit struct {
	// Container to exec into. Defaults to lerd-<service name>.
	Container string `yaml:"container,omitempty"`
	// Exec is passed to sh -c inside the container.
	Exec string `yaml:"exec"`
}

type SiteRegistry struct {
	Sites []Site
}

type WorkerNotFoundError struct {
	Name string
}

type WorkerProxy struct {
	Path        string `yaml:"path"`                   // URL path to proxy (e.g. "/app")
	PortEnvKey  string `yaml:"port_env_key,omitempty"` // env key holding the port (e.g. "REVERB_SERVER_PORT")
	DefaultPort int    `yaml:"default_port,omitempty"` // fallback port if env key is missing (default: 8080)
}