npm - @bobfrankston/msger - Versions diffs - 0.1.410 → 0.1.412 - Mend

@bobfrankston/msger 0.1.410 → 0.1.412

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (7) hide show

package/README.md +10 -2
package/cli.js +3 -1
package/msger-native/bin/msgernative-linux-aarch64 +0 -0
package/msger-native/bin/msgernative.exe +0 -0
package/msger-native/builder/postinstall.js +30 -0
package/package.json +1 -1
package/shower.js +44 -1

package/README.md CHANGED Viewed

@@ -47,9 +47,10 @@ msger -html "<h1>Welcome!</h1><p>This is <strong>HTML</strong></p>"
 # Colored text with inline styles
 msger -html "<span style='color:red;background-color:yellow'>Alert!</span>"
-# Load a URL (web page or local file)
+# Load a URL (web page, local file, or a directory's index.html)
 msger -url "https://example.com"
 msger -url "file:///path/to/page.html"
+msger -url ./site          # serves ./site/index.html and its sibling assets
 # Render a local markdown file — use the mdview wrapper (msger doesn't auto-render .md)
 mdview todo.md
@@ -307,7 +308,7 @@ Options:
   -message, --message <text>      Plain text message
   -title, --title <text>          Window title
   -html, --html <html>            HTML content
-  -url, --url <url>               URL to load (web or file://)
+  -url, --url <url>               URL to load (web, local file, or directory → its index.html)
   -hash, --hash <fragment>        Hash fragment to append to URL (requires -url). Leading # optional.
   -buttons, --buttons <labels>    Button labels (e.g., -buttons Yes No Cancel)
   -ok, --ok                       Add OK button
@@ -359,6 +360,13 @@ Notes:
   - OK button is green by default
   - URLs default to 1024x768 window size
   - Window title automatically updates from loaded page's <title> tag when using -url
+  - Local pages given to -url are served from their own directory over
+    http://msger.localhost/ rather than file:// (file:// pages cannot use the
+    msgapi IPC bridge at all — WebView2 aborts on them)
+  - Right-click → "Copy URL" copies the address of the current page; for local
+    content it copies the file's path on disk
+  - The loaded page's favicon becomes the window + taskbar icon (Windows);
+    pass -icon to keep your own icon instead
   - Windows auto-size to fit content when size not specified
   - Runtime zoom: Ctrl+Wheel, Ctrl+Plus, Ctrl+Minus
 ```

package/cli.js CHANGED Viewed

@@ -20,7 +20,8 @@ Options:
   -title <text>           Set window title
   -html <html>            Display HTML formatted message (inline)
   -htmlfrom <file|url>    Fetch HTML from file/URL and embed in template (has buttons & msger API)
-  -url <url>              Load URL directly in webview (no template, no buttons)
+  -url <url|file|dir>     Load URL directly in webview (no template, no buttons)
+                          A local file or directory works too; a directory loads its index.html
   -hash <fragment>        Hash fragment to append to URL (requires -url). Leading # optional.
   -buttons <label...>     Specify button labels (e.g., -buttons Yes No Cancel)
   -ok                     Add OK button
@@ -72,6 +73,7 @@ Examples:
   msger -url "https://example.com"
   msger -url "https://example.com" -hash section1
   msger -url "https://example.com" -detach
+  msger -url ./site            # local file or directory (directory → site/index.html)
   msger -title "Alert" -message "Operation complete"
   echo -e "\\x1b[31mError:\\x1b[0m Something failed" | msger
   echo '{"message":"Test","buttons":["OK"]}' | msger

package/msger-native/bin/msgernative-linux-aarch64 CHANGED Viewed

Binary file

package/msger-native/bin/msgernative.exe CHANGED Viewed

Binary file

package/msger-native/builder/postinstall.js CHANGED Viewed

@@ -202,6 +202,36 @@ if (!isWindows) {
     }
 }
+// Step 5: Linux — warn now if the WebKitGTK runtime is missing.
+//
+// npm cannot install it for you: it's an OS package, apt needs root, and the
+// package name differs per distro — so all msger can do is check and tell you.
+// Without this the first run dies with a bare loader error ("libwebkit2gtk-4.1
+// .so.0: cannot open shared object file", exit 127) that reads like a broken
+// msger rather than a missing dependency (Bob 2026-07-31, fresh Pi 4 with a
+// Lite image; a Pi with the full desktop already has it via other packages).
+if (!isWindows && process.platform === "linux") {
+    const soNames = ["libwebkit2gtk-4.1.so.0", "libjavascriptcoregtk-4.1.so.0"];
+    const libDirs = [
+        "/usr/lib", "/usr/local/lib", "/lib",
+        `/usr/lib/${process.arch === "arm64" ? "aarch64" : "x86_64"}-linux-gnu`,
+    ];
+    const found = soNames.every(so =>
+        libDirs.some(dir => { try { return fs.existsSync(path.join(dir, so)); } catch { return false; } })
+    );
+    if (!found) {
+        console.log("");
+        console.log("  msger: WARNING — the WebKitGTK runtime was not found.");
+        console.log("         msger renders with the system webview and cannot");
+        console.log("         start without it. Install it with:");
+        console.log("");
+        console.log("           sudo apt install libwebkit2gtk-4.1-0");
+        console.log("");
+        console.log("         (runtime only; -dev is needed just to build msger)");
+        console.log("");
+    }
+}
 // Friendly message about the EPERM warnings npm itself emits during a
 // subsequent global upgrade. They come from npm trying to delete its own
 // staging directory while the previously-running msgernative.exe inside

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@bobfrankston/msger",
-  "version": "0.1.410",
+  "version": "0.1.412",
   "description": "Fast, lightweight, cross-platform message box - Rust-powered alternative to msgview",
   "type": "module",
   "main": "./index.js",

package/shower.js CHANGED Viewed

@@ -72,6 +72,42 @@ export function setAppName(name) { _appName = name; }
  *  provision so Rust's window icon search picks it up. Per-call `icon` in
  *  `MessageBoxOptions` still takes precedence. */
 export function setAppIcon(iconPath) { _appIcon = iconPath; }
+/** The Linux/Pi binary dynamically links WebKitGTK, which a Lite or trimmed
+ *  Raspberry Pi OS image doesn't ship — the loader then fails with a bare
+ *  "libwebkit2gtk-4.1.so.0: cannot open shared object file" and exit 127, which
+ *  reads like a broken msger rather than a missing dependency (Bob 2026-07-31,
+ *  fresh pi4d). Turn it into the apt line that fixes it. */
+function missingWebkitHint(stderr) {
+    if (!/libwebkit2gtk|libjavascriptcoregtk/.test(stderr))
+        return '';
+    return '\n\nmsger needs the WebKitGTK runtime, which this system does not have.\n' +
+        '  sudo apt install libwebkit2gtk-4.1-0\n' +
+        '(runtime only — the -dev package is needed just for building msger.)';
+}
+/** Raspberry Pi: WebKitGTK's DMABUF rendering path is broken on the vc4/v3d
+ *  driver — the page comes up as interlaced shredded scanlines instead of
+ *  content (verified on a Pi 5 / Debian 13 / WebKitGTK 2.50.6 Wayland session,
+ *  2026-07-31). This is what "msger doesn't display properly on the Pi" was;
+ *  setting WEBKIT_DISABLE_DMABUF_RENDERER=1 renders correctly. Scoped to the
+ *  Pi because the DMABUF path is the faster one everywhere it works, and never
+ *  applied when the caller has already set the variable (either way) so an
+ *  explicit choice always wins. The Rust binary does the same for callers that
+ *  bypass this launcher. */
+function isRaspberryPi() {
+    if (platform() !== 'linux')
+        return false;
+    try {
+        return fs.readFileSync('/proc/device-tree/model', 'latin1').includes('Raspberry Pi');
+    }
+    catch {
+        return false;
+    }
+}
+function applyPiWebkitWorkaround(env) {
+    if (env.WEBKIT_DISABLE_DMABUF_RENDERER === undefined && isRaspberryPi()) {
+        env.WEBKIT_DISABLE_DMABUF_RENDERER = '1';
+    }
+}
 function getUserBinDirFor(appName) {
     const isWindows = platform() === 'win32';
     if (isWindows) {
@@ -393,6 +429,7 @@ function createMessageBoxHandle(options) {
     if ('NODE_OPTIONS' in childEnv) {
         delete childEnv.NODE_OPTIONS;
     }
+    applyPiWebkitWorkaround(childEnv);
     // Spawn before constructing the Promise so `child` is guaranteed defined
     // by the time we hand it to MessageBoxHandle.
     const child = spawn(binaryPath, [], {
@@ -429,7 +466,7 @@ function createMessageBoxHandle(options) {
                 return;
             }
             if (code !== 0) {
-                reject(new Error(`msger exited with code ${code}: ${stderr}`));
+                reject(new Error(`msger exited with code ${code}: ${stderr}${missingWebkitHint(stderr)}`));
                 return;
             }
             try {
@@ -691,6 +728,7 @@ export function showService(options) {
     const childEnv = { ...process.env };
     if ("NODE_OPTIONS" in childEnv)
         delete childEnv.NODE_OPTIONS;
+    applyPiWebkitWorkaround(childEnv);
     const child = spawn(binaryPath, [], {
         stdio: ["pipe", "pipe", "pipe"],
         env: childEnv,
@@ -698,6 +736,11 @@ export function showService(options) {
     child.stderr?.on("data", (data) => {
         // Forward Rust stderr to parent stderr (debug messages)
         process.stderr.write(data);
+        // Service mode never inspects the exit code, so surface the
+        // missing-WebKitGTK case as it happens or it stays a bare loader error.
+        const hint = missingWebkitHint(data.toString());
+        if (hint)
+            process.stderr.write(hint + '\n');
     });
     child.stdin?.on("error", () => { });
     // Send options as first line of stdin (Rust reads one line for options, then keeps reading)