mirinjs 0.1.0-alpha.1 → 0.1.0-alpha.11

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mirinjs",
-  "version": "0.1.0-alpha.1",
+  "version": "0.1.0-alpha.11",
   "description": "Build desktop apps with Bun, TypeScript, and Chromium (CEF). The Bun-native Electron alternative.",
   "type": "module",
   "license": "MIT",

package/src/app.ts

@@ -289,6 +289,25 @@ class MirinApp extends Emitter<AppEvents> {
   /** Auto-updater (macOS). Inert unless the app was built with `release` set. */
   readonly updater: Updater = updater;
 
+  /** This app's bundle id (mirin.config `id`). `undefined` when run detached. */
+  get id(): string | undefined {
+    try {
+      return runtime().id;
+    } catch {
+      return undefined;
+    }
+  }
+
+  /** True under `mirin dev`; false in a packaged build (and when detached). Use it
+   *  to keep dev and installed data (caches, databases) separate. */
+  get isDev(): boolean {
+    try {
+      return runtime().isDev;
+    } catch {
+      return false;
+    }
+  }
+
   /** macOS Dock-icon controls. Hiding suits resident, hotkey-summoned apps. */
   readonly dock: Dock = {
     hide: () => this.#setDock(false),

package/src/config.ts

@@ -42,6 +42,9 @@ export interface WindowConfig {
   title?: string;
   width?: number;
   height?: number;
+  /** Minimum window size; the OS prevents resizing below it. */
+  minWidth?: number;
+  minHeight?: number;
   /** Screen position (bottom-left origin, points). Centered when absent. */
   x?: number;
   y?: number;
@@ -78,12 +81,20 @@ export interface MirinConfig {
   /** Reverse-DNS app id, e.g. "dev.peje.hello". */
   id: string;
   name: string;
+  /**
+   * Publisher / company name (e.g. "Netko Labs"). Shown in the Windows installer,
+   * the exe's file properties (CompanyName), and Add/Remove Programs. Defaults to
+   * the app `name`.
+   */
+  publisher?: string;
   /** Main-process entry, relative to the project root (runs in the Bun Worker). */
   main: string;
   /**
-   * App icon, relative to the project root (macOS). Accepts a `.icns`, a
-   * `.iconset` directory, or a single square `.png` (≥512px) that mirin renders
-   * into an `.icns`. Embedded in the bundle for the Dock and Finder.
+   * App icon, relative to the project root. Accepts a `.icns`, a `.iconset`
+   * directory, or a single square `.png` (≥512px). macOS renders it into an
+   * `.icns` embedded in the bundle for the Dock and Finder; Linux resolves a PNG
+   * and sets it as the window's `_NET_WM_ICON` (taskbar/dock); Windows uses the
+   * `.ico` for the exe and window.
    */
   icon?: string;
   /**
@@ -109,6 +120,23 @@ export interface MirinConfig {
    * `.zip`. Requires `makensis` (NSIS) on the build machine.
    */
   nsis?: boolean | NsisConfig;
+  /**
+   * Windows installer via **Inno Setup** — a modern flat wizard
+   * (`WizardStyle=modern`, the installer VS Code ships). Preferred over `nsis`
+   * when both are available; `true`/omitted builds the default installer, an
+   * object customizes it, `false` falls back to NSIS / the portable `.zip`.
+   * Requires `iscc` (Inno Setup 6+) on the build machine.
+   */
+  inno?: boolean | InnoConfig;
+  /**
+   * Linux distributable packages produced by `mirin release` (and by `mirin build`
+   * when packaging is requested): an **AppImage** (single-file, run-anywhere), a
+   * **.deb** (Debian/Ubuntu), and an **.rpm** (Fedora/RHEL/openSUSE). `true`/omitted
+   * builds all three with sensible defaults; an object customizes them (which
+   * `formats`, maintainer, runtime `depends`, …); `false` disables Linux packaging.
+   * Requires `fpm` (deb + rpm) and `appimagetool` (AppImage) on the build machine.
+   */
+  linux?: boolean | LinuxConfig;
   /**
    * External binaries bundled into the `.app` and spawned at runtime with
    * `app.sidecar(name)`. Maps a logical name to a path (relative to the project
@@ -138,6 +166,12 @@ export interface MirinConfig {
    */
   urlSchemes?: string[];
   windows: Record<string, WindowConfig>;
+  /**
+   * Single-instance app (default true): a second launch focuses the running
+   * window and exits, instead of opening another window. Set false to allow
+   * multiple instances (each gets its own CEF cache dir).
+   */
+  singleInstance?: boolean;
 }
 
 /** A bundled sidecar binary with optional hardened-runtime entitlements. */
@@ -222,6 +256,52 @@ export interface NsisConfig {
   include?: string;
 }
 
+/**
+ * Inno Setup installer options — the same knobs as {@link NsisConfig}
+ * (perMachine, oneClick, shortcuts, license, publisher, runAfterFinish,
+ * installerIcon, and a raw `include` injected as `.iss` instead of NSIS script).
+ */
+export type InnoConfig = NsisConfig;
+
+/** A Linux distributable package format `mirin` can emit. */
+export type LinuxPackageFormat = "appimage" | "deb" | "rpm";
+
+/**
+ * Linux packaging options. Every format ships the same relocatable app payload
+ * (host binary + libcef.so + the CEF runtime + `resources/`) under a single
+ * prefix, with a launcher and a freedesktop `.desktop` entry + hicolor icon.
+ */
+export interface LinuxConfig {
+  /** Which package formats to emit. Default: all three (`appimage`, `deb`, `rpm`). */
+  formats?: LinuxPackageFormat[];
+  /**
+   * The `/usr/bin` launcher command name and the deb/rpm package name. Defaults to
+   * the last dot-segment of the app `id` (e.g. `dev.netko.anko` → `anko`),
+   * lowercased and sanitized to a valid package name.
+   */
+  binName?: string;
+  /** Package maintainer for deb/rpm (`"Name <email>"`). Defaults to `publisher`. */
+  maintainer?: string;
+  /** One-line package description / `.desktop` `Comment`. Defaults to the app name. */
+  description?: string;
+  /** License identifier for deb/rpm metadata (e.g. `"MIT"`). Omitted when unset. */
+  license?: string;
+  /** Homepage URL for deb/rpm metadata. Omitted when unset. */
+  homepage?: string;
+  /** Freedesktop `.desktop` category (e.g. `"Development"`). Default `"Utility"`. */
+  category?: string;
+  /**
+   * Debian runtime dependency package names, replacing the built-in CEF/GTK
+   * defaults (`libgtk-3-0`, `libnss3`, `libasound2`, …). Advanced.
+   */
+  debDepends?: string[];
+  /**
+   * RPM runtime dependency package names, replacing the built-in CEF/GTK defaults
+   * (`gtk3`, `nss`, `alsa-lib`, …). Advanced.
+   */
+  rpmDepends?: string[];
+}
+
 export interface ReleaseConfig {
   /** Flat directory URL hosting `{channel}-{platform}-{arch}-*` update files. */
   baseUrl: string;

package/src/host.ts

@@ -20,15 +20,20 @@ import { existsSync, readFileSync } from "node:fs";
 import { Core } from "./native.ts";
 
 // Bundle layout differs by platform: macOS `.app` puts the host in
-// `Contents/MacOS` with resources in `../Resources`; Windows is a flat app folder
-// where the host exe sits beside `mirin_core.dll` with resources in `resources/`.
+// `Contents/MacOS` with resources in `../Resources`; Windows and Linux are flat app
+// folders where the host binary sits beside the core lib (`mirin_core.dll` /
+// `libmirin_core.so`) with resources in `resources/`.
 const isWindows = process.platform === "win32";
+const isMac = process.platform === "darwin";
 const exeDir = dirname(process.execPath);
-const resourcesDir = isWindows ? join(exeDir, "resources") : join(exeDir, "..", "Resources");
+const resourcesDir = isMac ? join(exeDir, "..", "Resources") : join(exeDir, "resources");
 
-const corePath =
-  process.env.MIRIN_CORE ??
-  join(exeDir, isWindows ? "mirin_core.dll" : "libmirin_core.dylib");
+const coreFileName = isWindows
+  ? "mirin_core.dll"
+  : isMac
+    ? "libmirin_core.dylib"
+    : "libmirin_core.so";
+const corePath = process.env.MIRIN_CORE ?? join(exeDir, coreFileName);
 const workerPath = process.env.MIRIN_WORKER ?? join(resourcesDir, "worker.js");
 // Bundled-asset dirs for sidecars (Bun.spawn binaries) and extra workers. Dev
 // overrides via env (dev.ts stages them under .mirin); prod resolves in-bundle.
@@ -50,6 +55,17 @@ const coreConfig = JSON.parse(
       process.env.MIRIN_DEV_URL ? { dev: true } : { resources_path: resourcesDir },
     ),
 );
+// Opt out of single-instance (the core default) when the app allows multiple.
+if (manifest.singleInstance === false) coreConfig.single_instance = false;
+// The app's bundle id keys the per-app CEF cache dir (Windows has no OS bundle id).
+if (typeof manifest.id === "string") coreConfig.identifier = manifest.id;
+// Linux prod: the CLI stages the resolved app icon at resources/icon.png; the core
+// stamps it onto each window as `_NET_WM_ICON` (taskbar/dock). Dev supplies this via
+// MIRIN_CONFIG_JSON instead. macOS/Windows take the icon from the bundle.
+if (process.platform === "linux" && !coreConfig.icon_path) {
+  const iconPng = join(resourcesDir, "icon.png");
+  if (existsSync(iconPng)) coreConfig.icon_path = iconPng;
+}
 
 // Load the native core on the main thread FIRST. The Worker also dlopens the
 // same dylib in its boot; doing the main-thread dlopen before spawning the
@@ -61,6 +77,7 @@ const worker = new Worker(workerPath, {
   workerData: {
     corePath,
     manifest,
+    id: typeof manifest.id === "string" ? manifest.id : undefined,
     devUrl: process.env.MIRIN_DEV_URL,
     resourcesDir,
     sidecarDir,

package/src/index.ts

@@ -52,6 +52,9 @@ export type {
   ReleaseConfig,
   DmgConfig,
   NsisConfig,
+  InnoConfig,
+  LinuxConfig,
+  LinuxPackageFormat,
   SidecarSpec,
   SidecarEntitlement,
 } from "./config.ts";

package/src/native.ts

@@ -24,7 +24,7 @@ const symbols = {
   mirin_window_control: { args: [FFIType.u32, FFIType.ptr], returns: FFIType.void },
   mirin_window_set_material: { args: [FFIType.u32, FFIType.ptr], returns: FFIType.void },
   mirin_window_set_position: { args: [FFIType.u32, FFIType.f64, FFIType.f64], returns: FFIType.void },
-  mirin_window_maybe_start_drag: { args: [FFIType.u32, FFIType.i32, FFIType.i32, FFIType.i32], returns: FFIType.void },
+  mirin_window_maybe_start_drag: { args: [FFIType.u32, FFIType.i32, FFIType.i32, FFIType.i32, FFIType.i32], returns: FFIType.void },
   mirin_app_quit: { args: [], returns: FFIType.void },
   mirin_app_set_dock_visible: { args: [FFIType.i32], returns: FFIType.void },
   mirin_set_app_menu: { args: [FFIType.ptr], returns: FFIType.void },
@@ -114,8 +114,8 @@ export class Core {
     this.#lib.symbols.mirin_window_set_position(id, x, y);
   }
 
-  windowMaybeStartDrag(id: number, x: number, y: number, detail: number): void {
-    this.#lib.symbols.mirin_window_maybe_start_drag(id, x, y, detail);
+  windowMaybeStartDrag(id: number, x: number, y: number, detail: number, ht: number): void {
+    this.#lib.symbols.mirin_window_maybe_start_drag(id, x, y, detail, ht);
   }
 
   quit(): void {

package/src/rpc-server.ts

@@ -29,6 +29,8 @@ interface ControlFrame {
   verb?: string;
   /** Click count for pointer actions (2 = double-click → maximize). */
   detail?: number;
+  /** Win32 resize hit-test code when the mousedown is on a window edge/corner. */
+  ht?: number;
 }
 
 type IncomingFrame = RequestFrame | ControlFrame;

package/src/runtime.ts

@@ -18,6 +18,10 @@ export interface Runtime {
   core: Core;
   rpc: RpcServer;
   manifestWindows: ManifestWindowConfig[];
+  /** App bundle id (mirin.config `id`); undefined when detached. */
+  id?: string;
+  /** True under `mirin dev`; false in a packaged build. */
+  isDev: boolean;
   devUrl?: string;
   /** Contents/Resources of the running .app (for the updater). Absent in dev. */
   resourcesDir?: string;
@@ -87,6 +91,7 @@ export function boot(): void {
   const data = (workerData ?? {}) as {
     corePath?: string;
     manifest?: { windows?: Record<string, WindowConfig> };
+    id?: string;
     devUrl?: string;
     resourcesDir?: string;
     sidecarDir?: string;
@@ -107,7 +112,7 @@ export function boot(): void {
   rpc.setControlHandler((frame, webview) => {
     switch (frame.action) {
       case "window.maybeStartDrag":
-        core.windowMaybeStartDrag(webview, frame.x ?? 0, frame.y ?? 0, frame.detail ?? 1);
+        core.windowMaybeStartDrag(webview, frame.x ?? 0, frame.y ?? 0, frame.detail ?? 1, frame.ht ?? 0);
         break;
       case "window.control":
         if (frame.verb) core.windowControl(webview, frame.verb);
@@ -126,6 +131,8 @@ export function boot(): void {
     core,
     rpc,
     manifestWindows,
+    id: data.id,
+    isDev: !!data.devUrl,
     devUrl: data.devUrl,
     resourcesDir: data.resourcesDir,
     corePath,

package/src/updater.ts

@@ -13,9 +13,17 @@
  * packaged app with `release` set; in `mirin dev` the updater is idle.
  */
 
-import { homedir } from "node:os";
+import { homedir, tmpdir } from "node:os";
 import { join } from "node:path";
-import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync } from "node:fs";
+import {
+  existsSync,
+  mkdirSync,
+  readFileSync,
+  readdirSync,
+  renameSync,
+  rmSync,
+  writeFileSync,
+} from "node:fs";
 import { $ } from "bun";
 import { runtime } from "./runtime.ts";
 import { loadCodec } from "./codec.ts";
@@ -213,20 +221,59 @@ export class Updater {
       // to exit (the exe/bundle is locked while running), swaps the folder, relaunches.
       if (IS_WINDOWS) {
         const runningApp = join(this.#resourcesDir()!, "..");
-        const exe = join(runningApp, `${this.#version()!.name}.exe`);
+        const name = this.#version()!.name;
+        const exe = join(runningApp, `${name}.exe`);
+        const script = join(tmpdir(), `mirin-apply-${name}.ps1`);
+        const applyVbs = join(tmpdir(), `mirin-apply-${name}.vbs`);
+        const launchVbs = join(tmpdir(), `mirin-launch-${name}.vbs`);
         const ps = [
           `$ErrorActionPreference='SilentlyContinue'`,
+          // Never let the app dir be this process's cwd (Windows can't delete a cwd).
+          `Set-Location $env:TEMP`,
+          // Wait for the host to exit (it locks the exe), then a beat for CEF's
+          // helper subprocesses to release their file locks (libcef.dll etc.).
           `while (Get-Process -Id ${process.pid} -ErrorAction SilentlyContinue) { Start-Sleep -Milliseconds 200 }`,
-          `Start-Sleep -Milliseconds 400`,
-          `Remove-Item -Recurse -Force ${psq(runningApp)}`,
+          `Start-Sleep -Milliseconds 700`,
+          // Replace the app folder, retrying ~10s while any lingering lock clears.
+          `for ($i=0; $i -lt 50; $i++) { Remove-Item -Recurse -Force ${psq(runningApp)}; if (-not (Test-Path ${psq(runningApp)})) { break }; Start-Sleep -Milliseconds 200 }`,
           `Move-Item -Force ${psq(this.#staged)} ${psq(runningApp)}`,
-          `Start-Process ${psq(exe)}`,
-        ].join("; ");
-        Bun.spawn(["powershell", "-NoProfile", "-NonInteractive", "-Command", ps], {
+          `Start-Process -FilePath ${psq(exe)} -WorkingDirectory ${psq(runningApp)}`,
+          // self-clean the temp launch scripts (this .ps1 + the two .vbs shims)
+          `Remove-Item -Force ${psq(script)},${psq(applyVbs)},${psq(launchVbs)}`,
+        ].join("\n");
+        writeFileSync(script, ps, "utf8");
+
+        // No terminal window may appear during the update. powershell.exe is a
+        // console-subsystem program: launching it directly (even with
+        // -WindowStyle Hidden) flashes a console, because the OS allocates the
+        // console before powershell can hide it. wscript.exe is a GUI-subsystem
+        // host with no console; its Shell.Run(cmd, 0) starts powershell with
+        // SW_HIDE in the initial STARTUPINFO, so no window is ever shown.
+        writeFileSync(
+          applyVbs,
+          `CreateObject("WScript.Shell").Run "powershell -NoProfile -NonInteractive ` +
+            `-ExecutionPolicy Bypass -WindowStyle Hidden -File ""${script}""", 0, False\n`,
+          "utf8",
+        );
+
+        // The swap MUST outlive this process. A Bun.spawn child is in our job
+        // object and is killed when we quit — even with unref/detached (verified).
+        // WMI's Win32_Process.Create has the WMI service spawn it, outside our job,
+        // so it survives. Issue that WMI call from a console-less wscript host too,
+        // so the launcher itself never flashes a window. `await` the short launcher
+        // so the swap process exists before core.quit() (no race), then quit.
+        writeFileSync(
+          launchVbs,
+          `GetObject("winmgmts:Win32_Process").Create ` +
+            `"wscript.exe //B //Nologo ""${applyVbs}""", Null, Null, pid\n`,
+          "utf8",
+        );
+        const launcher = Bun.spawn(["wscript.exe", "//B", "//Nologo", launchVbs], {
           stdin: "ignore",
           stdout: "ignore",
           stderr: "ignore",
-        }).unref();
+        });
+        await launcher.exited;
       } else {
         const runningApp = join(this.#resourcesDir()!, "..", "..");
         const script = [