@bobfrankston/msger 0.1.425 → 0.1.426

package/cli.js

@@ -46,8 +46,10 @@ Options:
   -size <width,height>    Set window size (e.g., -size 800,600)
   -zoom <percent>         Set zoom level as percentage (e.g., -zoom 150 for 150%)
   -pos <x,y>              Set window position (e.g., -pos 100,200)
-  -screen <number>        Screen index for multi-monitor. Offsets -pos into that screen,
-                          and picks which screen -fullscreen covers. Indices follow the
+  -screen <number>        Screen index for multi-monitor. On its own it centers the
+                          window on that screen; with -pos it offsets the coordinates
+                          into it; and it picks which screen -fullscreen covers.
+                          Indices follow the
                           physical layout (bottom row first, then left to right), NOT the
                           OS display numbering — index 0 is whichever monitor sorts first,
                           which is often NOT the primary. Run -list to see the mapping.
@@ -64,7 +66,14 @@ Options:
                           -fullscreen -screen <n> to cover one display, e.g.
                             msger -overlay -fullscreen -screen 1 -timeout 3 "2"
                           With -url/-raw the page must set its own transparent background.
-  -no-escape-closes       Prevent Escape key from closing window (still exits fullscreen)
+  -escape <mode>          What the Escape key does:
+                            exit   = dismiss the window
+                            noexit = Escape only goes to the page
+                            auto   = (default) decide from the window kind —
+                                     a dialog is dismissed, a -url window is not
+                          In a -url window Escape belongs to the page (closing its
+                          own menu/autocomplete), so msger no longer quits on it.
+  -no-escape-closes       Same as -escape noexit (still exits fullscreen)
   -reset                  Clear localStorage on startup (useful for resetting web content state)
   -ontop                  Keep window always on top of other windows
   -load <file>            Load options from JSON file (supports comments)
@@ -116,7 +125,10 @@ Examples:
 Notes:
   - If no options are provided, all non-option arguments are concatenated as the message
   - Message text supports ANSI color codes (automatically converted to HTML)
-  - Press ESC to dismiss the dialog (returns button: "dismissed")
+  - Press ESC to dismiss a dialog (returns dismissed: true). ESC does NOT close a
+    -url window by default — use -escape exit if you want it to
+  - Every result carries exitReason (escape / closeRequested / timeout / page /
+    render) so you can tell why a window went away; set MSGER_DIAG=1 to also log it
   - Press Enter to click the last (default) button
   - Default button is OK if no buttons specified
   - Much faster than Electron-based msgview (~50-200ms vs ~2-3s startup)

package/package.json

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

package/shower.d.ts

@@ -43,7 +43,8 @@ export interface MessageBoxOptions {
     timeout?: number; /** Auto-close the message box after specified seconds */
     detach?: boolean; /** Launch the message box detached from parent process */
     fullscreen?: boolean; /** Start window in fullscreen mode (F11 to toggle, Escape to exit) */
-    escapeCloses?: boolean; /** Allow Escape key to close window (default: true). Always exits fullscreen first. */
+    escapeCloses?: boolean; /** Legacy boolean form of `escape`: true = Escape dismisses the window, false = it never does. Leave it UNDEFINED to get `escape: 'auto'`. Always exits fullscreen first either way. */
+    escape?: 'exit' | 'noexit' | 'auto'; /** What the Escape key does. 'exit' = dismiss the window; 'noexit' = Escape only goes to the page; 'auto' (default) = decide from the window kind — a dialog (message/html/prompt) is dismissed, a `url` window is NOT, because there Esc belongs to the page (closing its menu, autocomplete, lightbox) and a host that quits on it looks like msger "exiting spontaneously". Service mode never exits on Escape. Overrides `escapeCloses` when both are given. */
     reset?: boolean; /** Clear localStorage on startup (default: false) */
     icon?: string; /** Path to window icon. Decoded for the runtime title-bar / taskbar icon. PNG decodes most reliably; the `image` crate's ICO+PNG path is fragile. */
     relaunchIcon?: string; /** Optional path forwarded to `PKEY_AppUserModel_RelaunchIconResource` so pinned taskbar shortcuts get the app's own icon. Must be a `.ico`. Path is consumed verbatim (no decode). */
@@ -89,6 +90,7 @@ export interface MessageBoxResult {
     };
     render?: RenderResult; /** Captured screenshot (render mode) */
     renderError?: string; /** Why render mode produced no image — the result promise rejects with this */
+    exitReason?: string; /** WHY the window went away: 'escape', 'closeRequested', 'timeout', 'render', or 'page' (the page posted a result — button click, msgapi.close(), form submit). Answers "it exited spontaneously" without guessing; MSGER_DIAG=1 logs the same line to msger-diag.log. */
 }
 /** Set the app name used for the per-user bin dir AND the per-app exe filename.
  *  Call before showService/showMessageBox — e.g. `setAppName("mailx")` makes