#moonbit-community/proton

#Quick example

async fn main {
  @proton.html("Hello", "<h1>Hello</h1>")
  .identifier("dev.proton.hello")
  .run_or_abort()
}

#Application metadata and paths

#Protocol and process control

#Entry points

• @proton.html(title, html, ...) — inline HTML document.
• @proton.url(title, url, ...) — a remote or local URL.
• @proton.file(title, path, ...) — an HTML file on disk.
• @proton.asset(title, path, ...) — an HTML asset shipped with the app.

#Native images

#Commands and events

@proton.html("Commands", html)
.identifier("dev.proton.commands")
.commands(fn(registrar) raise { registrar.bind(ping_command, ping) })
.run_or_abort()

const reply = await window.__MoonBit__.core.invokeOp("ext:app/ping", {
  name: "proton",
});
window.__MoonBit__.events.on("app.tick", (event) => console.log(event.payload));

#Windows

@proton.html("Main", main_html)
.add_window(
  "settings",
  "Settings",
  @proton.AppEntry::Html(settings_html),
  width=420,
  height=320,
)

#Taskbar status

window.set_progress_bar(0.4)                                        // determinate
window.set_progress_bar(0.4, mode=@proton.ProgressBarMode::Paused)  // paused
window.set_progress_bar(-1.0, mode=@proton.ProgressBarMode::Cleared) // cleared

let overlay = @proton.native_image()
overlay.add_png(png_bytes, 16, 16)
window.set_overlay_icon(Some(overlay), "unread messages")
window.set_overlay_icon(None, "")

#Taskbar thumbnail toolbar

let previous = @proton.native_image()
previous.add_png(previous_png, 16, 16)
let applied = window.set_thumbar_buttons([
  @proton.ThumbarButton::{
    id: "previous",
    icon: previous,
    tooltip: "Previous",
    flags: [],
  },
  @proton.ThumbarButton::{
    id: "play",
    icon: play,
    tooltip: "Play or pause",
    flags: [@proton.ThumbarButtonFlag::NoBackground],
  },
])

@proton.html("Player", player_html)
.on_thumbar_button_click(fn(window, button_id) noraise {
  match button_id {
    "previous" => play_previous(window)
    "next" => play_next(window)
    _ => toggle_playback(window)
  }
})
.run_or_abort()

#Jump list

let result = @proton.set_jump_list(Some([
  @proton.JumpListCategory::{
    kind: @proton.JumpListCategoryKind::Tasks,
    name: "",
    items: [
      @proton.JumpListItem::{
        kind: @proton.JumpListItemKind::Task,
        path: executable,
        arguments: "--play",
        title: "Play or pause",
        description: "Starts playback in a new instance",
        icon_path: executable,
        icon_index: 0,
        working_directory: "",
      },
      // A separator is only allowed in the Tasks category.
      @proton.JumpListItem::{
        kind: @proton.JumpListItemKind::Separator,
        path: "",
        arguments: "",
        title: "",
        description: "",
        icon_path: "",
        icon_index: 0,
        working_directory: "",
      },
    ],
  },
  @proton.JumpListCategory::{
    kind: @proton.JumpListCategoryKind::Custom,
    name: "Recent sessions",
    items: [...],
  },
])) catch {
  error => abort(error.message())
}

#Logging

#Headless mode

#Accessibility

@proton.html("Accessible", "<main><h1>Hello</h1></main>")
.identifier("dev.proton.accessible")
.accessibility(@proton.AccessibilityMode::AlwaysEnabled)
.run_or_abort()

#Native theme

let theme = @proton.native_theme() catch {
  error => abort(error.message())
}
let dark = theme.should_use_dark_colors()
let high_contrast = theme.should_use_high_contrast_colors()
let source = theme.theme_source()

@proton.native_theme_set_source(@proton.WindowThemePreference::Dark) catch {
  error => abort(error.message())
}

@proton.html("Theme aware", "<main><h1>Hello</h1></main>")
.on_native_theme_change(fn(theme) noraise {
  // theme.should_use_dark_colors(), theme.should_use_high_contrast_colors()
})
.run_or_abort()

#Application locale

#Learn more

• Runnable demos live in the repository's examples/ directory.
• The CLI covers the project workflow: proton_cli new, proton_cli cef setup, proton_cli dev, proton_cli build, and proton_cli package.