wave

type CSSEntryFiles struct {
	Critical    string `json:"Critical,omitempty"`
	NonCritical string `json:"NonCritical,omitempty"`
}

type Config struct {
	// Required -- the bytes of your wave.config.json file.
	// You can use go:embed or just read the file in yourself.
	// Using go:embed is recommended for simpler deployments and improved performance.
	WaveConfigJSON []byte

	// Required -- be sure to pass in a file system that has your
	// <distDir>/static directory as its ROOT.
	// If you are using an embedded filesystem, you may need to use fs.Sub to get the
	// correct subdirectory.
	// Using go:embed is recommended for simpler deployments and improved performance.
	DistStaticFS fs.FS

	// Optional -- a logger instance.
	// If not provided, a default logger will be created that writes to standard out.
	Logger *slog.Logger
}

type CoreConfig struct {
	ConfigLocation    string          `json:"ConfigLocation,omitempty"`
	DevBuildHook      string          `json:"DevBuildHook,omitempty"`
	ProdBuildHook     string          `json:"ProdBuildHook,omitempty"`
	MainAppEntry      string          `json:"MainAppEntry"`
	DistDir           string          `json:"DistDir"`
	StaticAssetDirs   StaticAssetDirs `json:"StaticAssetDirs"`
	CSSEntryFiles     CSSEntryFiles   `json:"CSSEntryFiles,omitempty"`
	PublicPathPrefix  string          `json:"PublicPathPrefix,omitempty"`
	ServerOnlyMode    bool            `json:"ServerOnlyMode,omitempty"`
	SequentialGoBuild bool            `json:"SequentialGoBuild,omitempty"`
}

type DistLayout struct {
	Root string
}

type FileMap map[string]FileVal

type FileVal struct {
	DistName    string
	ContentHash string
	IsPrehashed bool
}

type HookContext struct {
	// FilePath is the absolute path of the changed file.
	FilePath string
	// AppStoppedForBatch is true when the app has been stopped as part of batch
	// processing (e.g., a Go file changed in the same batch). When true, HTTP
	// endpoints on the running app cannot be called.
	AppStoppedForBatch bool
}

type OnChangeHook struct {
	// Cmd is a shell command to run. Can be any shell command or "DevBuildHook"
	// to run the configured dev build hook.
	Cmd string `json:"Cmd,omitempty"`
	// Timing controls when the hook runs relative to Wave's rebuild process.
	Timing Timing `json:"Timing,omitempty"`
	// Exclude contains glob patterns for files to exclude from triggering this hook.
	Exclude []string `json:"Exclude,omitempty"`
	// Callback is a Go function to run. Framework use only (not JSON-configurable).
	// If the callback returns a non-nil RefreshAction, it controls what Wave does
	// after all hooks complete. Multiple RefreshActions are merged with OR semantics.
	Callback func(*HookContext) (*RefreshAction, error) `json:"-"`
}

type ParsedConfig struct {
	Core  *CoreConfig  `json:"Core"`
	Vite  *ViteConfig  `json:"Vite,omitempty"`
	Watch *WatchConfig `json:"Watch,omitempty"`

	Dist DistLayout `json:"-"`

	FrameworkWatchPatterns       []WatchedFile               `json:"-"`
	FrameworkIgnoredPatterns     []string                    `json:"-"`
	FrameworkPublicFileMapOutDir string                      `json:"-"`
	FrameworkSchemaExtensions    map[string]jsonschema.Entry `json:"-"`
	FrameworkDevBuildHook        string                      `json:"-"`
	FrameworkProdBuildHook       string                      `json:"-"`
}

type RefreshAction struct {
	// ReloadBrowser triggers a browser reload via WebSocket.
	// Ignored if TriggerRestart is true.
	ReloadBrowser bool
	// WaitForApp polls the app's healthcheck before reloading the browser.
	// Ignored if TriggerRestart is true.
	WaitForApp bool
	// WaitForVite waits for Vite dev server to be ready before reloading.
	// Ignored if TriggerRestart is true.
	WaitForVite bool
	// TriggerRestart causes Wave to restart the app process.
	// When true, ReloadBrowser/WaitForApp/WaitForVite are ignored.
	TriggerRestart bool
	// RecompileGo recompiles the Go binary before restart.
	// Only relevant when TriggerRestart is true.
	RecompileGo bool
}

type SortedHooks struct {
	Pre              []OnChangeHook
	Concurrent       []OnChangeHook
	ConcurrentNoWait []OnChangeHook
	Post             []OnChangeHook
}

type StaticAssetDirs struct {
	Private string `json:"Private"`
	Public  string `json:"Public"`
}

type Timing string

type ViteConfig struct {
	JSPackageManagerBaseCmd string `json:"JSPackageManagerBaseCmd"`
	JSPackageManagerCmdDir  string `json:"JSPackageManagerCmdDir,omitempty"`
	DefaultPort             int    `json:"DefaultPort,omitempty"`
	ViteConfigFile          string `json:"ViteConfigFile,omitempty"`
}

type WatchConfig struct {
	WatchRoot           string        `json:"WatchRoot,omitempty"`
	HealthcheckEndpoint string        `json:"HealthcheckEndpoint,omitempty"`
	Include             []WatchedFile `json:"Include,omitempty"`
	Exclude             struct {
		Dirs  []string `json:"Dirs,omitempty"`
		Files []string `json:"Files,omitempty"`
	} `json:"Exclude,omitempty"`
}

type WatchedFile struct {
	Pattern                            string         `json:"Pattern"`
	OnChangeHooks                      []OnChangeHook `json:"OnChangeHooks,omitempty"`
	RecompileGoBinary                  bool           `json:"RecompileGoBinary,omitempty"`
	RestartApp                         bool           `json:"RestartApp,omitempty"`
	OnlyRunClientDefinedRevalidateFunc bool           `json:"OnlyRunClientDefinedRevalidateFunc,omitempty"`
	RunOnChangeOnly                    bool           `json:"RunOnChangeOnly,omitempty"`
	SkipRebuildingNotification         bool           `json:"SkipRebuildingNotification,omitempty"`
	TreatAsNonGo                       bool           `json:"TreatAsNonGo,omitempty"`
	SortedHooks                        *SortedHooks   `json:"-"`
}

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