mirinjs 0.1.0-alpha.10 → 0.1.0-alpha.12

package/package.json

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

package/src/config.ts

@@ -90,9 +90,11 @@ export interface MirinConfig {
   /** 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;
   /**
@@ -126,6 +128,15 @@ export interface MirinConfig {
    * 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
@@ -252,6 +263,45 @@ export interface NsisConfig {
  */
 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.
@@ -54,6 +59,13 @@ const coreConfig = JSON.parse(
 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

package/src/index.ts

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