@bobfrankston/msger 0.1.55 → 0.1.56

package/README.md

@@ -50,20 +50,39 @@ if (result.value) {
 
 ```bash
 # Simple message
-msger -t "Hello" -m "Hello, World!"
+msger -message "Hello, World!"
+msger Hello World  # shorthand - words become message
 
 # With HTML content
-msger -t "Welcome" -html "<h1>Welcome!</h1><p>This is <strong>HTML</strong></p>"
+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)
 msger -url "https://example.com"
 msger -url "file:///path/to/page.html"
 
-# With custom size
-msger -t "Big Window" -m "Hello" -w 800 -h 600
+# With input field and placeholder
+msger -message "Enter your name:" -input "Your name here" -default "John"
+
+# Custom buttons
+msger -message "Save changes?" -buttons Yes No Cancel
+
+# With custom size and position
+msger -message "Hello" -size 800,600 -pos 100,100
+
+# Always on top with zoom
+msger -message "Important!" -ontop -zoom 150
+
+# Detached URL browser (stays open after script exits)
+msger -url "https://example.com" -detach
+
+# Multi-monitor (Windows only - show on second screen)
+msger -message "Second screen" -pos 0,100 -screen 1
 
-# With timeout (auto-close after 5 seconds)
-msger -t "Notification" -m "This will close in 5 seconds" -timeout 5
+# Auto-close timeout
+msger -message "Closing in 5 seconds..." -timeout 5
 
 # See all options
 msger --help
@@ -84,20 +103,23 @@ interface MessageBoxOptions {
     html?: string;            // HTML content to display
     url?: string;             // URL to load (web URL or file:// path)
     size?: {                  // Window size in pixels
-        width: number;        // Window width (default: 600)
-        height: number;       // Window height (default: 400)
+        width: number;        // Window width (default: 600, or 1024 for URLs)
+        height: number;       // Window height (default: 400, or 768 for URLs)
+    };
+    pos?: {                   // Window position
+        x: number;            // X coordinate in pixels
+        y: number;            // Y coordinate in pixels
+        screen?: number;      // [Windows only] Screen index (0=primary, 1=second, etc.)
     };
     buttons?: string[];       // Button labels (default: ["OK"])
     defaultValue?: string;    // Default input value
+    inputPlaceholder?: string; // Placeholder text (gray hint) for input field
     allowInput?: boolean;     // Show input field (default: false)
+    autoSize?: boolean;       // Auto-resize window to fit content (default: true when no size specified)
+    alwaysOnTop?: boolean;    // Keep window on top of other windows (default: false)
+    zoomPercent?: number;     // Initial zoom level (100=100%, 150=150%, 50=50%)
     timeout?: number;         // Auto-close after N seconds
     detach?: boolean;         // Launch detached from parent process
-    
-    // Not yet implemented:
-    // fullPage?: boolean;    // Display HTML as complete page without wrapping
-    // pos?: { x: number; y: number; screen?: number };  // Window position
-    // zoomPercent?: number;  // Initial zoom level (100=100%, 150=150%)
-    // devTools?: boolean;    // Open DevTools for debugging
 }
 ```
 
@@ -137,6 +159,7 @@ const result = await showMessageBox({
     title: 'Enter Name',
     message: 'Please enter your name:',
     allowInput: true,
+    inputPlaceholder: 'Your name here',
     defaultValue: 'John Doe',
     buttons: ['Cancel', 'OK']
 });
@@ -201,6 +224,79 @@ if (result.timeout) {
 }
 ```
 
+### HTML Forms
+
+```typescript
+const result = await showMessageBox({
+    title: 'User Registration',
+    html: `
+        <form>
+            <label>Name: <input name="name" required /></label><br>
+            <label>Email: <input name="email" type="email" required /></label><br>
+            <label>Age: <input name="age" type="number" /></label>
+        </form>
+    `,
+    buttons: ['Cancel', 'Submit']
+});
+
+if (result.button === 'Submit' && result.form) {
+    console.log('Name:', result.form.name);
+    console.log('Email:', result.form.email);
+    console.log('Age:', result.form.age);
+}
+```
+
+### Window Positioning
+
+```typescript
+// Position at specific coordinates
+await showMessageBox({
+    message: 'Positioned window',
+    pos: { x: 100, y: 100 }
+});
+
+// Position on second monitor (Windows only)
+await showMessageBox({
+    message: 'On second screen',
+    pos: { x: 0, y: 100, screen: 1 }
+});
+```
+
+### Always On Top & Zoom
+
+```typescript
+// Keep window on top with 150% zoom
+await showMessageBox({
+    title: 'Important Alert',
+    message: 'This window stays on top!',
+    alwaysOnTop: true,
+    zoomPercent: 150
+});
+```
+
+### Auto-Sizing Window
+
+```typescript
+// Window automatically sizes to fit content
+await showMessageBox({
+    message: 'Short message',
+    autoSize: true  // default when size not specified
+});
+```
+
+### Detached URL Browser
+
+```typescript
+// Launch URL window that stays open after script exits
+await showMessageBox({
+    url: 'https://example.com',
+    size: { width: 1200, height: 800 },
+    detach: true,
+    alwaysOnTop: true
+});
+// Script continues/exits immediately, window stays open
+```
+
 ## Architecture
 
 ```
@@ -276,18 +372,24 @@ All binaries are bundled with the npm package, and the correct one is selected a
 ## Features
 
 - ✅ Cross-platform native webview (Windows, Linux x64, Linux ARM64)
-- ✅ Full HTML/CSS support
+- ✅ Full HTML/CSS support with inline styles
 - ✅ Load external URLs or local files
-- ✅ Customizable buttons
-- ✅ Input field support
+- ✅ Customizable buttons (OK button is green by default)
+- ✅ Input field support with placeholder text
+- ✅ HTML forms with automatic data collection
 - ✅ Auto-close with timeout
+- ✅ Window positioning (x, y coordinates)
+- ✅ Multi-monitor support (Windows only - screen index)
+- ✅ Always on top mode
+- ✅ Zoom control (initial percent + runtime Ctrl+Wheel/+/-)
+- ✅ Auto-sizing windows (fit content when size not specified)
 - ✅ Keyboard shortcuts (Enter, Escape)
 - ✅ Window close detection
+- ✅ Detached process mode (independent window)
 - ✅ TypeScript type definitions
-- ✅ Small binary size (~1-2MB per platform)
+- ✅ Small binary size (~2-5MB per platform)
 - ✅ Fast startup (~50-200ms)
-- ✅ Detached process mode
-- ⏳ Coming soon: Window positioning, zoom control, DevTools
+- ✅ Low memory usage (~20-50MB)
 
 ## Performance Comparison
 
@@ -303,21 +405,48 @@ All binaries are bundled with the npm package, and the correct one is selected a
 ## CLI Options
 
 ```
-Usage: msger [options]
+Usage: msger [options] [message words...]
 
 Options:
-  -t, --title <title>          Window title
-  -m, --message <message>      Plain text message
-  -html, --html <html>         HTML content
-  -url, --url <url>            URL to load (web or file://)
-  -w, --width <width>          Window width in pixels (default: 600)
-  -h, --height <height>        Window height in pixels (default: 400)
-  -b, --buttons <buttons>      Comma-separated button labels (default: "OK")
-  -i, --allowInput             Enable input field
-  -d, --defaultValue <value>   Default input value
-  -timeout, --timeout <sec>    Auto-close after N seconds
-  --help                       Show help
-  --version                    Show version
+  -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://)
+  -buttons, --buttons <labels>    Button labels (e.g., -buttons Yes No Cancel)
+  -ok, --ok                       Add OK button
+  -cancel, --cancel               Add Cancel button
+  -input, --input [placeholder]   Include input field with optional placeholder text
+  -default, --default <text>      Default value for input field
+  -size, --size <width,height>    Window size (e.g., -size 800,600)
+  -pos, --pos <x,y>               Window position (e.g., -pos 100,200)
+  -screen, --screen <number>      [Windows only] Screen index (0=primary, 1=second, etc.)
+  -zoom, --zoom <percent>         Zoom level as percentage (e.g., -zoom 150 for 150%)
+  -timeout, --timeout <seconds>   Auto-close after specified seconds
+  -ontop, --ontop                 Keep window always on top
+  -detach, --detach               Launch window independently (parent returns immediately)
+  -v, -version, --version         Show version number
+  -help, -?, --help               Show help message
+
+Examples:
+  msger Hello World
+  msger -message "Save changes?" -buttons Yes No Cancel
+  msger -message "Enter your name:" -input "Your name" -default "John Doe"
+  msger -html "<h1>Title</h1><p>Formatted <b>content</b></p>"
+  msger -html "<span style='color:red;background-color:yellow'>Colored text</span>"
+  msger -url "https://example.com"
+  msger -url "https://example.com" -detach
+  msger -title "Alert" -message "Operation complete"
+  msger -message "Positioned" -pos 100,100 -screen 1
+  msger -message "Large text" -zoom 150 -ontop
+
+Notes:
+  - If no options provided, all non-option arguments are concatenated as message
+  - Press ESC to dismiss (returns button: "dismissed")
+  - Press Enter to click last (default) button
+  - OK button is green by default
+  - URLs default to 1024x768 window size
+  - Windows auto-size to fit content when size not specified
+  - Runtime zoom: Ctrl+Wheel, Ctrl+Plus, Ctrl+Minus
 ```
 
 ## License

package/package.json

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