@bobfrankston/msger 0.1.414 → 0.1.415

package/README.md

@@ -327,7 +327,7 @@ Options:
   -debug, --debug                 Return debug info (HTML, size, autoSize) in result
   -render, --render [file]        Render the page to a bitmap instead of displaying it.
                                   With <file>, writes the image (.png/.jpg/.bmp by extension);
-                                  without, returns it base64 in result.render. [Windows only]
+                                  without, returns it base64 in result.render. [Windows, Linux/Pi]
   -noshow, --noshow               Don't display the window. With -save, exits after saving.
                                   Otherwise the WebView still loads + runs scripts so a page
                                   can post a result via window.ipc.postMessage; only the

package/cli.js

@@ -52,7 +52,7 @@ Options:
                           appears on screen. With <file>, writes the image there (format
                           from extension: .png/.jpg/.bmp) and the JSON result carries
                           {render:{path,width,height,format}}. Without <file>, the image
-                          is returned base64 in {render:{data,...}}. [Windows only]
+                          is returned base64 in {render:{data,...}}. [Windows, Linux/Pi]
   -noshow                 Don't display the window. With -save, also exits after saving.
                           Otherwise the WebView still loads and runs scripts (so a page can
                           query the DOM/CSS and post a result via window.ipc.postMessage)

package/msger-native/builder/postinstall.js

@@ -229,19 +229,51 @@ if (!isWindows && process.platform === "linux") {
         libDirs.some(dir => { try { return fs.existsSync(path.join(dir, so)); } catch { return false; } })
     );
 
-    if (!haveWebkit()) {
+    // Emoji font: NOT needed for msger to start, but without one every emoji in
+    // a hosted page draws as a tofu box — Linux browsers get emoji from system
+    // fonts and nothing bundles them (Bob 2026-08-01: the wallclock app's 📋 and
+    // 🧃 were empty boxes on a Pi with zero emoji fonts). Treated as a
+    // recommended dependency: installed alongside, never fatal.
+    // Keep in sync with hasEmojiFont() in shower.ts.
+    const haveEmojiFont = () => {
+        // fontconfig is authoritative when present. Probe U+1F4CB CLIPBOARD, not
+        // the obvious U+1F600 GRINNING FACE: DejaVu (on every Debian box) covers
+        // 1F600 without being an emoji font, so that probe says "present" on a
+        // machine that draws every real emoji as tofu. 1F4CB is in every emoji
+        // font (Unicode 6.0) and in none of the generic text fonts.
+        try {
+            const fc = spawnSync("fc-list", [":charset=1f4cb", "family"], { encoding: "utf8" });
+            if (fc.status === 0) return fc.stdout.trim().length > 0;
+        } catch { /* no fontconfig — fall through to a filename scan */ }
+        const fontDirs = [
+            "/usr/share/fonts/truetype/noto", "/usr/share/fonts/truetype",
+            "/usr/share/fonts/opentype", "/usr/share/fonts",
+            path.join(process.env.HOME || "/root", ".local/share/fonts"),
+        ];
+        return fontDirs.some(dir => {
+            try { return fs.readdirSync(dir).some(f => /emoji/i.test(f)); } catch { return false; }
+        });
+    };
+
+    const wanted = [];
+    if (!haveWebkit()) wanted.push({ pkg: "libwebkit2gtk-4.1-0", what: "WebKitGTK runtime", required: true });
+    if (!haveEmojiFont()) wanted.push({ pkg: "fonts-noto-color-emoji", what: "emoji font", required: false });
+
+    if (wanted.length) {
         const isRoot = typeof process.getuid === "function" && process.getuid() === 0;
         const hasAptGet = fs.existsSync("/usr/bin/apt-get");
         // `sudo -n true` succeeds only when sudo needs no password.
         const sudoNoPassword = !isRoot && hasAptGet &&
             spawnSync("sudo", ["-n", "true"], { stdio: "ignore" }).status === 0;
         const canInstall = hasAptGet && (isRoot || sudoNoPassword) && process.env.MSGER_SKIP_DEPS !== "1";
+        const names = wanted.map(w => w.pkg);
+        const missingRequired = wanted.some(w => w.required);
 
         if (canInstall) {
             const prefix = isRoot ? [] : ["sudo", "-n"];
-            const args = [...prefix, "apt-get", "install", "-y", "libwebkit2gtk-4.1-0"];
+            const args = [...prefix, "apt-get", "install", "-y", ...names];
             console.log("");
-            console.log("  msger: WebKitGTK runtime missing — installing it now:");
+            console.log(`  msger: missing ${wanted.map(w => w.what).join(" + ")} — installing now:`);
             console.log(`         ${args.join(" ")}`);
             const run = (a) => spawnSync(a[0], a.slice(1), {
                 stdio: "inherit",
@@ -256,27 +288,30 @@ if (!isWindows && process.platform === "linux") {
                 res = run(args);
             }
             if (res.status === 0 && haveWebkit()) {
-                console.log("  msger: WebKitGTK installed — msger is ready to run.");
+                console.log("  msger: dependencies installed — msger is ready to run.");
                 console.log("");
             } else {
                 console.log("");
-                console.log("  msger: WARNING — automatic install of WebKitGTK failed.");
-                console.log("         Run this by hand, then msger will work:");
+                console.log("  msger: WARNING — automatic dependency install failed.");
+                console.log("         Run this by hand:");
                 console.log("");
-                console.log("           sudo apt install libwebkit2gtk-4.1-0");
+                console.log(`           sudo apt install ${names.join(" ")}`);
                 console.log("");
             }
         } else {
             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(`  msger: ${missingRequired ? "WARNING — " : "note: "}missing ${wanted.map(w => w.what).join(" + ")}.`);
+            if (missingRequired) {
+                console.log("         msger renders with the system webview and cannot");
+                console.log("         start without it.");
+            } else {
+                console.log("         msger runs, but emoji in hosted pages will show");
+                console.log("         as empty boxes until a font provides them.");
+            }
             console.log("");
-            console.log("           sudo apt install libwebkit2gtk-4.1-0");
+            console.log(`           sudo apt install ${names.join(" ")}`);
             console.log("         or:  msger --install-deps");
             console.log("");
-            console.log("         (runtime only; -dev is needed just to build msger)");
-            console.log("");
         }
     }
 }

package/package.json

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

package/shower.d.ts

@@ -95,10 +95,24 @@ export declare function setAppName(name: string): void;
  *  provision so Rust's window icon search picks it up. Per-call `icon` in
  *  `MessageBoxOptions` still takes precedence. */
 export declare function setAppIcon(iconPath: string): void;
-/** The right package for this distro. Only the runtime library — building
- *  msger additionally needs the -dev package, which is not msger's business to
- *  install on a machine that only runs it. */
-export declare function webkitInstallCommand(): string;
+/** The right packages for this distro. Only runtime pieces — building msger
+ *  additionally needs the -dev package, which is not msger's business to
+ *  install on a machine that only runs it.
+ *
+ *  Two dependencies, different weight:
+ *   - WebKitGTK is *required*: msger renders with the system webview and its
+ *     binary won't even load without it.
+ *   - An emoji font is *recommended*: msger runs fine, but every emoji in a
+ *     hosted page draws as a tofu box, since Linux browsers take emoji from
+ *     system fonts and nothing bundles them. */
+export declare function webkitInstallCommand(missing?: {
+    webkit: boolean;
+    emoji: boolean;
+}): string;
+/** Does any installed font provide emoji? fontconfig is authoritative when it
+ *  is present; otherwise fall back to looking for a font file with "emoji" in
+ *  the name. Keep in sync with the copy in msger-native/builder/postinstall.js. */
+export declare function hasEmojiFont(): boolean;
 /** `msger --install-deps` — install the WebKitGTK runtime msger links against.
  *
  *  Deliberately NOT done from postinstall: an npm script that shells out to

package/shower.js

@@ -86,20 +86,70 @@ function missingWebkitHint(stderr) {
         '  msger --install-deps\n' +
         '(runtime only — the -dev package is needed just for building msger.)';
 }
-/** The right package for this distro. Only the runtime library — building
- *  msger additionally needs the -dev package, which is not msger's business to
- *  install on a machine that only runs it. */
-export function webkitInstallCommand() {
+/** The right packages for this distro. Only runtime pieces — building msger
+ *  additionally needs the -dev package, which is not msger's business to
+ *  install on a machine that only runs it.
+ *
+ *  Two dependencies, different weight:
+ *   - WebKitGTK is *required*: msger renders with the system webview and its
+ *     binary won't even load without it.
+ *   - An emoji font is *recommended*: msger runs fine, but every emoji in a
+ *     hosted page draws as a tofu box, since Linux browsers take emoji from
+ *     system fonts and nothing bundles them. */
+export function webkitInstallCommand(missing) {
+    const need = missing ?? { webkit: !hasWebkitRuntime(), emoji: !hasEmojiFont() };
     const has = (cmd) => fs.existsSync(`/usr/bin/${cmd}`) || fs.existsSync(`/bin/${cmd}`);
+    const pick = (mgr) => {
+        const names = {
+            apt: { webkit: 'libwebkit2gtk-4.1-0', emoji: 'fonts-noto-color-emoji' },
+            dnf: { webkit: 'webkit2gtk4.1', emoji: 'google-noto-emoji-color-fonts' },
+            pacman: { webkit: 'webkit2gtk-4.1', emoji: 'noto-fonts-emoji' },
+            zypper: { webkit: 'libwebkit2gtk-4_1-0', emoji: 'noto-coloremoji-fonts' },
+        };
+        const verb = { apt: 'apt install', dnf: 'dnf install', pacman: 'pacman -S', zypper: 'zypper install' }[mgr];
+        const pkgs = [need.webkit && names[mgr].webkit, need.emoji && names[mgr].emoji].filter(Boolean);
+        return `sudo ${verb} ${pkgs.join(' ')}`;
+    };
     if (has('apt'))
-        return 'sudo apt install libwebkit2gtk-4.1-0';
+        return pick('apt');
     if (has('dnf'))
-        return 'sudo dnf install webkit2gtk4.1';
+        return pick('dnf');
     if (has('pacman'))
-        return 'sudo pacman -S webkit2gtk-4.1';
+        return pick('pacman');
     if (has('zypper'))
-        return 'sudo zypper install libwebkit2gtk-4_1-0';
-    return 'install the WebKitGTK 4.1 runtime for your distribution';
+        return pick('zypper');
+    return 'install the WebKitGTK 4.1 runtime (and an emoji font) for your distribution';
+}
+/** Does any installed font provide emoji? fontconfig is authoritative when it
+ *  is present; otherwise fall back to looking for a font file with "emoji" in
+ *  the name. Keep in sync with the copy in msger-native/builder/postinstall.js. */
+export function hasEmojiFont() {
+    if (platform() !== 'linux')
+        return true;
+    try {
+        // U+1F4CB CLIPBOARD, not the obvious U+1F600 GRINNING FACE: DejaVu (on
+        // every Debian box) covers 1F600 without being an emoji font at all, so
+        // probing it reports "present" on a machine that draws every real emoji
+        // as tofu. 1F4CB is old enough (Unicode 6.0) that every emoji font has
+        // it and absent from the generic text fonts — a clean discriminator.
+        const fc = spawnSync('fc-list', [':charset=1f4cb', 'family'], { encoding: 'utf8' });
+        if (fc.status === 0)
+            return (fc.stdout ?? '').trim().length > 0;
+    }
+    catch { /* no fontconfig — fall through */ }
+    const fontDirs = [
+        '/usr/share/fonts/truetype/noto', '/usr/share/fonts/truetype',
+        '/usr/share/fonts/opentype', '/usr/share/fonts',
+        path.join(process.env.HOME || '/root', '.local/share/fonts'),
+    ];
+    return fontDirs.some(dir => {
+        try {
+            return fs.readdirSync(dir).some(f => /emoji/i.test(f));
+        }
+        catch {
+            return false;
+        }
+    });
 }
 /** `msger --install-deps` — install the WebKitGTK runtime msger links against.
  *
@@ -115,11 +165,14 @@ export function installLinuxDeps() {
         console.error('--install-deps is for Linux; nothing to install on ' + platform());
         return 1;
     }
-    if (hasWebkitRuntime()) {
-        console.log('WebKitGTK runtime is already present — nothing to do.');
+    const missing = { webkit: !hasWebkitRuntime(), emoji: !hasEmojiFont() };
+    if (!missing.webkit && !missing.emoji) {
+        console.log('WebKitGTK runtime and an emoji font are both present — nothing to do.');
         return 0;
     }
-    const command = webkitInstallCommand();
+    console.log(`Missing: ${[missing.webkit && 'WebKitGTK runtime', missing.emoji && 'emoji font']
+        .filter(Boolean).join(', ')}`);
+    const command = webkitInstallCommand(missing);
     if (!command.startsWith('sudo ')) {
         console.error(`msger could not identify this distribution's package manager.\nPlease ${command}.`);
         return 1;
@@ -134,11 +187,16 @@ export function installLinuxDeps() {
     }
     if (res.status !== 0)
         return res.status ?? 1;
-    if (!hasWebkitRuntime()) {
+    if (missing.webkit && !hasWebkitRuntime()) {
         console.error('Install reported success but the WebKitGTK runtime is still not visible.');
         return 1;
     }
-    console.log('WebKitGTK runtime installed — msger is ready to run.');
+    // The emoji font is best-effort: say so if it didn't take, but don't fail —
+    // msger runs fine without it, pages just lose their emoji.
+    if (missing.emoji && !hasEmojiFont()) {
+        console.warn('Note: an emoji font still is not visible; emoji in pages may show as boxes.');
+    }
+    console.log('Dependencies installed — msger is ready to run.');
     return 0;
 }
 /** Is the WebKitGTK runtime msger links against present? Mirrors the check in