///|
/// Creates one app window, installs the core runtime, and applies its window settings.
fn create_app_window(
id : String,
config : WindowConfig,
entry : AppEntry,
debug : Int,
) -> AppWindow {
let webview = @webview.Webview::new(debug~)
@core.install_core_bridge(webview)
apply_window_config(webview, config)
AppWindow::{ id, webview, config, entry }
}
///|
/// Installs one configured extension onto a webview.
fn install_extension_on_webview(
webview : @webview.Webview,
installed_extension : InstalledExtension,
) -> Result[Unit, String] {
installed_extension
.build_extension()
.map(fn(extension) { @core.install_extension(webview, extension) })
}
///|
/// Installs every already-known extension onto a newly created webview.
fn install_existing_extensions(
webview : @webview.Webview,
extensions : Array[InstalledExtension],
) -> Result[Unit, String] {
for installed_extension in extensions {
match install_extension_on_webview(webview, installed_extension) {
Ok(_) => ()
Err(error) => return Err(error)
}
}
Ok(())
}
///|
/// Returns the destroy hook name associated with an app window id.
fn app_window_destroy_hook_name(window_id : String) -> String {
"app-window:" + window_id
}
///|
/// Applies title and size settings to a webview-backed window.
fn apply_window_config(
webview : @webview.Webview,
config : WindowConfig,
) -> Unit {
webview.set_title(config.title)
webview.set_size(config.width, config.height, config.size_hint)
}
///|
/// Loads the configured entry content into a webview.
fn load_app_entry(webview : @webview.Webview, entry : AppEntry) -> Unit {
match entry {
Html(html) => webview.set_html(html)
Url(url) => webview.navigate(url)
File(path) => webview.navigate(make_file_url(path))
Asset(path) => webview.navigate(make_file_url(path))
}
}
///|
/// Converts a local file path into a normalized `file:` URL.
fn make_file_url(raw_path : String) -> String {
let path : @path.Path = raw_path
let resolved = path.resolve().to_string()
let normalized = normalize_file_url_path(resolved)
if normalized.has_prefix("//") {
"file:" + normalized
} else if normalized.has_prefix("/") {
"file://" + normalized
} else {
"file:///" + normalized
}
}
///|
/// Rewrites backslashes to forward slashes for file URL generation.
fn normalize_file_url_path(path : String) -> String {
let builder = StringBuilder::new(size_hint=path.length())
for _, ch in path {
builder.write_char(if ch == '\\' { '/' } else { ch })
}
builder.to_string()
}