@bobfrankston/msger 0.1.434 → 0.1.436

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.
package/README.md CHANGED
@@ -132,7 +132,7 @@ Notes:
132
132
 
133
133
  ### Render mode (`-render`) — capture the page to an image
134
134
 
135
- `-render` turns msger into a headless page→bitmap renderer: no window ever appears; the page loads, settles, gets screenshotted, and msger exits. Windows (WebView2) only for now.
135
+ `-render` turns msger into a headless page→bitmap renderer: no window ever appears; the page loads, settles, gets screenshotted, and msger exits. Windows (WebView2, CDP `Page.captureScreenshot`) and Linux/Pi (WebKitGTK snapshot). Not supported on Mac.
136
136
 
137
137
  ```bash
138
138
  # Write a PNG of a web page (format follows the extension: .png/.jpg/.bmp)
@@ -163,6 +163,11 @@ Notes:
163
163
  - `renderFormat` (`png`/`jpeg`/`bmp`) can be set explicitly in the API; the CLI derives it from the file extension.
164
164
  - A failed capture rejects the promise (CLI: error on stderr, nonzero exit).
165
165
  - msgview supports the same `-render` option via Electron's `capturePage()` on all its platforms.
166
+ - `-render` captures the **viewport** (the window's size). To capture the whole document, including what is scrolled out of view, use **Ctrl+Shift+S** / right-click "Save page image" in a visible window (see Keyboard shortcuts). That path only writes a file to your Pictures folder; nothing comes back to the caller.
167
+ - There is **no API to capture a live window on demand** (from page JS via `msgapi`, or from the parent process) and get the image back as a buffer. Render mode is one-shot: capture, then exit.
168
+ - Only the page is captured, never the desktop or other windows.
169
+
170
+ (Section updated 2026-11-05 by Claude Code, Opus 5.5: added Linux/Pi, Mac, viewport vs. full page, and the missing live-capture API.)
166
171
 
167
172
  ## JSON Configuration Files
168
173
 
Binary file
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@bobfrankston/msger",
3
- "version": "0.1.434",
3
+ "version": "0.1.436",
4
4
  "description": "Fast, lightweight, cross-platform message box - Rust-powered alternative to msgview",
5
5
  "type": "module",
6
6
  "main": "./index.js",
package/shower.d.ts CHANGED
@@ -60,7 +60,7 @@ export interface MessageBoxOptions {
60
60
  service?: boolean; /** Service mode: bidirectional IPC with parent. Stdin/stdout stay open. */
61
61
  contentDir?: string; /** Base directory for custom protocol file serving (avoids file:// URLs) */
62
62
  hidden?: boolean; /** Create the window invisible. The WebView still renders so JS / CSS / layout queries (e.g. `getComputedStyle`, `contrast-color()`) resolve; the window just isn't mapped on screen. Set by the CLI's `-noshow` flag. */
63
- render?: boolean | string; /** Render to a bitmap instead of displaying. The window stays hidden; after the page loads (plus renderDelay) a screenshot is captured and msger exits. A string is a file path to write — format from extension (.png/.jpg/.jpeg/.bmp), result.render = {format,width,height,path}. `true` returns the image in result.render = {format,width,height,data(base64)}. Windows (WebView2) only for now. */
63
+ render?: boolean | string; /** Render to a bitmap instead of displaying. The window stays hidden; after the page loads (plus renderDelay) a screenshot is captured and msger exits. A string is a file path to write — format from extension (.png/.jpg/.jpeg/.bmp), result.render = {format,width,height,path}. `true` returns the image in result.render = {format,width,height,data(base64)}. Captures the viewport. Windows (WebView2) and Linux/Pi (WebKitGTK); not Mac. (Doc corrected 2026-11-05, Claude Code: was "Windows only".) */
64
64
  renderDelay?: number; /** Render mode: settle delay in ms between the page's load event and the capture (fonts/images/async paint). Default 100. */
65
65
  renderFormat?: string; /** Render mode image format: png (default), jpeg, or bmp. Derived from the file extension when `render` is a path; settable directly when `render: true`. */
66
66
  profile?: string; /** Named WebView2 profile: user-data dir becomes `%LOCALAPPDATA%\<appName>\webview2-<profile>` so this window gets its OWN browser-process cluster. Windows sharing one user-data dir share one browser process — a crash there blacks out ALL of them. Pass a name (e.g. "popout") for secondary windows so they can't take the main window down. */