#@alepha/desktop - Shell

#Installation

npm install @alepha/desktop

#Overview

The main thread of a compiled desktop app: the native window, the instance lock, and the supervisor that owns the server Worker.

alepha compile --desktop generates the entry that runs it: it creates an Alepha container with this module, points WorkerSupervisorProvider at the generated supervisor Worker, and exits with what DesktopShell``.run() answers.

Native code (webview-bun, the Objective-C runtime, flock) loads lazily on first use, so importing this module has no native side effect. In tests the window, the lock and the supervisor are memory implementations.

macOS only.

#API Reference

#Providers

• InstanceLockProvider - One running instance per app identifier.
• LogFileProvider - Points the process's stdout and stderr at a file.
• MemoryInstanceLockProvider - InstanceLockProvider for specs: held plays another process
• MemoryLogFileProvider - LogFileProvider for specs: records the redirects, and fails when
• MemorySupervisorProvider - A scripted supervisor for specs. crash plays the server dying
• MemoryWindowProvider - A window that only records what was asked of it.
• NativeInstanceLockProvider - InstanceLockProvider on an exclusive flock, which the kernel
• NativeLogFileProvider - LogFileProvider with dup2.
• NativeWindowProvider - The macOS window: webview-bun on the main thread, plus a menu and alerts
• SupervisorProvider - The shell's view of the supervisor: the thread that owns the server Worker
• WindowProvider - The native window of a desktop app, behind which the webview binding and
• WorkerSupervisorProvider - SupervisorProvider on a real supervisor Worker running