///|
/// Entry content loaded by an `App`.
pub(all) enum AppEntry {
  Html(String)
  Url(String)
  File(String)
  Asset(String)
}

///|
/// Window settings used when creating an `App`.
pub struct WindowConfig {
  title : String
  width : Int
  height : Int
  size_hint : @webview.SizeHint
} derive(Debug)

///|
/// Additional window registered on an `App` before the runtime loop starts.
pub struct AppWindowConfig {
  id : String
  window : WindowConfig
  entry : AppEntry
}

///|
/// Application-level settings for the runtime core.
pub struct AppConfig {
  window : WindowConfig
  entry : AppEntry
  windows : Array[AppWindowConfig]
  debug : Int
}

///|
/// Builds a window configuration.
/// Use `size_hint` to communicate fixed, minimum, or maximum sizing behavior to
/// the underlying native window backend.
pub fn WindowConfig::new(
  title : String,
  width : Int,
  height : Int,
  size_hint? : @webview.SizeHint = @webview.SizeHint::None,
) -> WindowConfig {
  WindowConfig::{ title, width, height, size_hint }
}

///|
/// Describes a secondary app window.
/// The `id` must be unique within the owning app and is used for later window
/// lookup and replacement operations.
pub fn AppWindowConfig::new(
  id : String,
  window : WindowConfig,
  entry : AppEntry,
) -> AppWindowConfig {
  AppWindowConfig::{ id, window, entry }
}

///|
/// Builds a runtime-core application configuration.
/// Additional windows are registered up front, while their entries are only
/// loaded once `App::run` starts the runtime loop.
pub fn AppConfig::new(
  window : WindowConfig,
  entry : AppEntry,
  debug? : Int = 0,
  windows? : Array[AppWindowConfig] = [],
) -> AppConfig {
  AppConfig::{ window, entry, windows: copy_app_window_configs(windows), debug }
}

///|
fn copy_app_window_configs(
  windows : Array[AppWindowConfig],
) -> Array[AppWindowConfig] {
  windows.map(fn(window) { window })
}