wave

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

type Config struct {
	// Required -- Raw Wave configuration JSON.
	// This is the single app-facing configuration input path.
	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"`
	DevBuildHookTimeoutMilliseconds  int             `json:"DevBuildHookTimeoutMilliseconds,omitempty"`
	ProdBuildHook                    string          `json:"ProdBuildHook,omitempty"`
	ProdBuildHookTimeoutMilliseconds int             `json:"ProdBuildHookTimeoutMilliseconds,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 GoBuildOverlay struct {
	OverlayConfigPath string
	Cleanup           func() error
}

type HookCallbackTimeoutConfig struct {
	PreCallbackTimeoutMilliseconds              int `json:"PreCallbackTimeoutMilliseconds,omitempty"`
	ConcurrentCallbackTimeoutMilliseconds       int `json:"ConcurrentCallbackTimeoutMilliseconds,omitempty"`
	ConcurrentNoWaitCallbackTimeoutMilliseconds int `json:"ConcurrentNoWaitCallbackTimeoutMilliseconds,omitempty"`
	PostCallbackTimeoutMilliseconds             int `json:"PostCallbackTimeoutMilliseconds,omitempty"`
}

type HookCommandTimeoutConfig struct {
	PreCommandTimeoutMilliseconds              int `json:"PreCommandTimeoutMilliseconds,omitempty"`
	ConcurrentCommandTimeoutMilliseconds       int `json:"ConcurrentCommandTimeoutMilliseconds,omitempty"`
	ConcurrentNoWaitCommandTimeoutMilliseconds int `json:"ConcurrentNoWaitCommandTimeoutMilliseconds,omitempty"`
	PostCommandTimeoutMilliseconds             int `json:"PostCommandTimeoutMilliseconds,omitempty"`
}

type HookContext struct {
	// ExecutionContext is canceled when the surrounding execution pipeline is
	// canceled (for example, concurrent stage cancellation after build failure).
	// Callback hooks can watch this context for cooperative cancellation.
	ExecutionContext context.Context
	// FilePath is the absolute path of the changed file.
	FilePath string
	// ChangedFilePaths contains all changed file paths associated with the hook
	// execution context. For deduped pattern hook execution, this includes all
	// files in the matched batch.
	ChangedFilePaths []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.
	Cmd string `json:"Cmd,omitempty"`
	// CommandTimeoutMilliseconds overrides stage-level command timeout for this hook when > 0.
	CommandTimeoutMilliseconds int `json:"CommandTimeoutMilliseconds,omitempty"`
	// DisableStageCommandTimeout disables stage-level command timeout for this hook.
	DisableStageCommandTimeout bool `json:"DisableStageCommandTimeout,omitempty"`
	// CallbackTimeoutMilliseconds overrides stage-level callback timeout for this hook when > 0.
	CallbackTimeoutMilliseconds int `json:"CallbackTimeoutMilliseconds,omitempty"`
	// DisableStageCallbackTimeout disables stage-level callback timeout for this hook.
	DisableStageCallbackTimeout bool `json:"DisableStageCallbackTimeout,omitempty"`
	// RunCombinedDevBuildHookCommands executes the configured development build
	// hooks in order (Core.DevBuildHook then framework dev build hook).
	RunCombinedDevBuildHookCommands bool `json:"RunCombinedDevBuildHookCommands,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:"-"`
	FrameworkRunBuildHook          func(context.Context, bool) error `json:"-"`
	FrameworkPrepareGoBuildOverlay func() (*GoBuildOverlay, error)   `json:"-"`

	FrameworkBrowserRuntimeNamespace              string `json:"-"`
	FrameworkBrowserPublicURLResolverFunctionName string `json:"-"`
	FrameworkBrowserRevalidateFunctionName        string `json:"-"`
	FrameworkRefreshRebuildingOverlayElementID    string `json:"-"`
	FrameworkCriticalCSSStyleElementID            string `json:"-"`
	FrameworkNonCriticalCSSLinkElementID          string `json:"-"`
}

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

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"`
	HookCommandTimeouts  HookCommandTimeoutConfig  `json:"HookCommandTimeouts,omitempty"`
	HookCallbackTimeouts HookCallbackTimeoutConfig `json:"HookCallbackTimeouts,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
}