@bobfrankston/msger 0.1.119 → 0.1.122

package/CHANGELOG.md

@@ -0,0 +1,25 @@
+# Changelog
+
+## [0.1.121] - 2025-11-16
+
+### Added
+- **Programmatic Close API**: New `showMessageBoxEx()` returns handle with `.close()` method
+- **Close by PID**: New `closeMessageBox(pid)` standalone function
+- **MessageBoxHandle class**: Track dialog lifecycle with `.pid`, `.result`, `.close()`, `.closed`
+- Test suite for close API in `tests/` directory
+- Complete API documentation in CLOSE-API.md
+
+### Changed
+- Refactored shower.ts with handle-based architecture
+- Updated README.md with programmatic close examples
+- Enhanced MessageBoxResult to include `closed` flag for programmatic closure
+
+### Fixed
+- Handle null exit codes when process killed programmatically
+- Active dialog registry with auto-cleanup on close
+
+## [0.1.120] - 2025-11-16
+
+### Added
+- Initial release tracking
+

package/CLOSE-API.md

@@ -0,0 +1,91 @@
+# Programmatic Close API
+
+msger now supports programmatically closing dialogs from the parent process.
+
+## API Options
+
+### 1. Handle-Based API (Recommended)
+
+```javascript
+import { showMessageBoxEx } from '@bobfrankston/msger';
+
+const handle = showMessageBoxEx({
+    message: 'Please wait...',
+    buttons: ['Cancel']
+});
+
+console.log('Dialog PID:', handle.pid);
+
+// Close later
+setTimeout(() => {
+    handle.close();
+}, 5000);
+
+// Wait for result
+const result = await handle.result;
+console.log('Result:', result); // {button: 'closed', closed: true}
+```
+
+### 2. Standalone Function
+
+```javascript
+import { showMessageBoxEx, closeMessageBox } from '@bobfrankston/msger';
+
+const handle = showMessageBoxEx({
+    message: 'Processing...'
+});
+
+const pid = handle.pid;
+
+// Close by PID from anywhere
+closeMessageBox(pid);
+```
+
+### 3. Legacy Promise API (Backward Compatible)
+
+```javascript
+import { showMessageBox } from '@bobfrankston/msger';
+
+// Still works - returns promise directly
+const result = await showMessageBox({
+    message: 'Hello'
+});
+```
+
+## Return Values
+
+When closed programmatically:
+```json
+{
+  "button": "closed",
+  "closed": true
+}
+```
+
+When user clicks button:
+```json
+{
+  "button": "OK"
+}
+```
+
+When user presses Escape:
+```json
+{
+  "button": "dismissed",
+  "dismissed": true
+}
+```
+
+## Use Cases
+
+- Progress dialogs that auto-close when task completes
+- Timeout-based notifications
+- Multi-dialog management
+- Detached dialogs (launched then closed remotely)
+
+## Compatibility
+
+- Windows: ✅ Tested
+- Linux: ✅ Should work (process.kill)
+- macOS: ✅ Should work (process.kill)

package/IMPLEMENTATION-SUMMARY.md

@@ -0,0 +1,155 @@
+# Programmatic Close API - Implementation Summary
+
+## Overview
+Successfully implemented programmatic dialog closing capability for msger v0.1.121.
+
+## Implementation Details
+
+### Core Changes (shower.ts)
+
+**1. MessageBoxHandle Class**
+- Properties: `result` (Promise), `pid` (number), `child` (ChildProcess), `_closed` (boolean)
+- Methods: `close()` - kills child process, `closed` getter - returns state
+- Handles automatic cleanup and state tracking
+
+**2. Active Dialog Registry**
+- Map-based tracking of all active dialogs by PID
+- Automatic registration on create
+- Automatic cleanup on dialog close (via promise.finally)
+- Enables standalone close function
+
+**3. API Functions**
+- `showMessageBoxEx(options)` - Returns MessageBoxHandle (new, recommended)
+- `closeMessageBox(pid)` - Standalone close by PID (new)
+- `showMessageBox(options)` - Returns Promise (legacy, still works)
+
+**4. Exit Code Handling**
+- `code === null` → `{button: 'closed', closed: true}` (programmatic close)
+- `code === 0` → normal user response with button/value
+- `code !== 0` → error/rejection
+
+### Architecture
+
+```
+User Code
+    ↓
+showMessageBoxEx(options)
+    ↓
+createMessageBoxHandle() → spawns child process
+    ↓
+Returns MessageBoxHandle {
+    pid: 12345,
+    result: Promise<result>,
+    close(): kills process,
+    closed: boolean
+}
+    ↓
+activeDialogs.set(pid, handle)
+    ↓
+[Later] handle.close() or closeMessageBox(pid)
+    ↓
+child.kill() → exit code null → resolve({button:'closed',closed:true})
+```
+
+### Testing
+
+**Test 1: Handle API** (tests/test-handle-api.mjs)
+- Creates dialog with handle
+- Calls `handle.close()` after 2 seconds
+- Verifies: PID reported, close returns true, result is correct
+- Result: ✅ PASSED (PID 56432)
+
+**Test 2: PID Close** (tests/test-close-by-pid.mjs)
+- Creates dialog with handle
+- Calls `closeMessageBox(pid)` after 2 seconds
+- Verifies: PID reported, close returns true, result is correct
+- Result: ✅ PASSED (PID 136232)
+
+### Documentation
+
+**CLOSE-API.md**
+- Complete API reference
+- Usage examples for both APIs
+- Return value documentation
+- Use case examples
+
+**README.md**
+- New "Programmatic Close API" section
+- Handle-based example
+- Standalone function example
+- Updated MessageBoxResult interface docs
+
+**CHANGELOG.md**
+- Version 0.1.121 entry
+- 5 new features documented
+- 3 changes documented
+- 2 fixes documented
+
+**RELEASE-NOTES.md**
+- User-facing release announcement
+- Quick start examples
+- Use cases
+- Platform support
+
+### Files Modified
+
+**Core Implementation:**
+- shower.ts (241 lines modified)
+- shower.d.ts (auto-generated)
+- shower.js (compiled)
+
+**Configuration:**
+- package.json (version: 0.1.120 → 0.1.121)
+
+**Tests:**
+- tests/test-handle-api.mjs (new)
+- tests/test-close-by-pid.mjs (new)
+
+**Documentation:**
+- CLOSE-API.md (new)
+- RELEASE-NOTES.md (new)
+- CHANGELOG.md (updated)
+- README.md (updated)
+- IMPLEMENTATION-SUMMARY.md (this file)
+
+### Backward Compatibility
+
+✅ **100% Backward Compatible**
+- `showMessageBox()` still works exactly as before
+- Internally delegates to `showMessageBoxEx().result`
+- No breaking changes to existing code
+
+### Build Status
+
+```
+npm run build:ts
+✅ SUCCESS - No errors or warnings
+```
+
+### Platform Support
+
+- ✅ Windows (tested)
+- ✅ Linux x64 (should work - process.kill)
+- ✅ Linux ARM64/Pi (should work - process.kill)
+
+## Ready for Release
+
+All tasks complete:
+- ✅ Implementation
+- ✅ Testing
+- ✅ Documentation
+- ✅ Version bump
+- ✅ Build verification
+- ✅ No temp files
+- ✅ Tests organized
+
+**Next Steps:**
+1. Commit changes
+2. Git tag v0.1.121
+3. npm publish
+4. Test installation
+
+---
+**Date:** 2025-11-16  
+**Version:** 0.1.121  
+**Author:** Claude Code with Bob Frankston

package/PI-RENDERING-NOTES.md

@@ -0,0 +1,184 @@
+# Raspberry Pi Webkit Rendering Issues
+
+## Problem
+- Initial window displays garbled on Raspberry Pi (webkit2gtk)
+- F11 temporarily clears the garbled rendering BUT does not toggle fullscreen
+- F11 just redraws - never actually switches between fullscreen and windowed mode
+- `--fullscreen` flag also shows garbled initially, F11 clears but never exits fullscreen
+
+## Environment
+- **Pi**: Raspberry Pi 4 (pi4c) - Debian-based OS
+- **Display**: Connected via HDMI
+- **Architecture**: ARM64 (aarch64)
+- **Webkit**: webkit2gtk-4.0 or webkit2gtk-4.1
+- **Build**: Cross-compiled via SSH from Windows
+
+## Attempted Fixes (All Failed)
+
+### 1. Hide/Show Window After Webview Creation
+**Approach**: After building webview, hide then show window to force redraw
+**Code**: main.rs lines 590-598, 659-667
+```rust
+#[cfg(target_os = "linux")]
+{
+    window.set_visible(false);
+    std::thread::sleep(std::time::Duration::from_millis(50));
+    window.set_visible(true);
+}
+```
+**Result**: ❌ Still garbled on initial display
+
+### 2. Create Window Invisible Initially (Current)
+**Approach**: Use `with_visible(false)` in WindowBuilder, show after webview ready
+**Code**:
+- main.rs:371-376 - Create window invisible
+- main.rs:590-598, 659-667 - Show after 100ms delay
+```rust
+// In WindowBuilder
+#[cfg(target_os = "linux")]
+{
+    window_builder = window_builder.with_visible(false);
+}
+
+// After webview built
+#[cfg(target_os = "linux")]
+{
+    std::thread::sleep(std::time::Duration::from_millis(100));
+    window.set_visible(true);
+}
+```
+**Result**: ❌ Still garbled (as of version 0.1.118)
+
+### 3. GTK queue_draw() Approach (Failed to Compile)
+**Approach**: Use GTK's native `queue_draw()` method
+**Result**: ❌ Compilation error - `gtk` module not available in scope
+
+## Build Infrastructure Improvements ✅
+
+### SSH/SCP Issues Fixed
+- **Problem**: SSH hostname canonicalization (`pi4c` → `pi4c.aaz.lt`)
+- **Solution**: Using `spawn()` instead of `execSync()` - avoids quoting issues
+- **Files**: build-pi.ts with `ssh()`, `scp()`, `sshCapture()` helper functions
+
+### Build Process
+- **Change Detection**: Compares source file mtimes - only rebuilds if Rust code changed
+- **Spawn-based**: All SSH/SCP commands use spawn (no shell quoting issues)
+- **Graceful Failure**: Build exits gracefully if Pi unavailable
+- **Color Output**: Using `styleText()` from `node:util` instead of ANSI escapes
+
+### Line Endings
+- **Git Config**: `core.autocrlf=false`, `core.eol=lf`
+- **.gitattributes**: Enforces LF for all text files
+
+## Current Build Status
+- **Version**: 0.1.118 (but Cargo.toml still shows 0.1.57 - ignored)
+- **Binary**: `msger-native/bin/msgernative-arm64` (3.45 MB)
+- **Build Time**: ~10 minutes on Pi
+- **Versions Tested**: 0.1.116, 0.1.117, 0.1.118 - all show same garbled behavior
+
+## Technical Details
+
+### Version Management
+- **NPM_VERSION**: Set by build.rs reading package.json at compile time
+- **Single Source**: package.json is authoritative (Cargo.toml version ignored)
+- **Environment Variable**: `NPM_VERSION` passed to Cargo during build
+
+### Webkit Integration
+- **Framework**: wry 0.47.2 (webview wrapper)
+- **Window**: tao 0.30.8 (cross-platform window library)
+- **Linux Backend**: GTK3 + webkit2gtk
+- **Build GTK Method**: `builder.build_gtk(vbox)` on Linux
+
+### F11 Handler
+**Location**: main.rs:774-789
+- Detects current fullscreen state
+- Toggles between windowed and borderless fullscreen
+- **Issue**: On Pi, F11 clears garbled rendering but doesn't actually toggle fullscreen
+
+## Next Steps to Try
+
+### 1. Investigate GTK Initialization
+- May need to call `gtk::init()` explicitly
+- Check if GTK main loop timing is the issue
+- Look into webkit2gtk-specific initialization signals
+
+### 2. WebView Load Events
+- Hook into webkit's `load-changed` signal
+- Show window only after page load completes
+- May need to use webkit2gtk FFI directly
+
+### 3. Different Delay Strategy
+- Try longer delays (200ms, 500ms)
+- Use webkit signals instead of arbitrary sleep
+- Investigate if compositor/X11 needs sync
+
+### 4. Compositor/Display Issues
+- Check if running Wayland vs X11
+- Test with different compositors
+- May be Pi-specific display server issue
+
+### 5. Debugging Info
+- Add webkit debug environment variables
+- Check for GTK warnings/errors on Pi
+- Compare behavior on different Linux systems (not just Pi)
+
+## Files Modified
+
+### Rust Code
+- `msger-native/src/main.rs`:
+  - Lines 371-376: Window created invisible on Linux
+  - Lines 590-598: Show window after webview (HTML mode)
+  - Lines 659-667: Show window after webview (URL mode)
+  - Lines 784-789: F11 fullscreen toggle
+
+### Build Scripts
+- `msger-native/build-pi.ts`:
+  - Lines 12-71: spawn-based ssh/scp helpers
+  - Lines 76-92: DNS debugging and SSH connection test
+  - Lines 169: Source cargo env for Rust detection
+  - Changed from execSync to spawn throughout
+
+### Configuration
+- `.gitattributes`: LF line endings enforced
+- Git config: `autocrlf=false`, `eol=lf`
+
+## Build Commands
+
+### Full Build (All Platforms)
+```bash
+npm run build:native:all
+```
+
+### Pi Only
+```bash
+cd msger-native && node build-pi.ts
+```
+
+### Skip Pi if Not Available
+Builds gracefully skip if Pi unreachable (exit 0)
+
+## SSH Setup
+- **Host**: pi4c (172.20.0.112)
+- **Build Dir**: /tmp/msger-native-build
+- **Cleanup**: Build dir removed after successful build
+- **Keys**: SSH keys working (ignore libcrypto warnings)
+
+## Dependencies on Pi
+All automatically checked (warnings shown if missing):
+- ✅ gcc/build-essential (C compiler)
+- ✅ Rust/Cargo (sourced from ~/.cargo/env)
+- ✅ pkg-config
+- ✅ libglib2.0-dev, libgtk-3-dev, libwebkit2gtk-4.1-dev
+
+## Questions to Investigate
+1. Why does F11 fix rendering but not toggle fullscreen?
+2. Is this a webkit2gtk bug specific to ARM64/Pi?
+3. Does the issue occur on other Linux systems (x64, Wayland, etc.)?
+4. Are there webkit2gtk initialization events we should wait for?
+5. Is the Pi's display driver/compositor causing the issue?
+
+## Session Timeline
+- Started: 2025-11-13 ~22:00 UTC
+- Last build: 2025-11-14 00:26:20 UTC
+- Versions tested: 0.1.116, 0.1.117, 0.1.118
+- Status: **Issue persists - no fix found yet**

package/README.md

@@ -308,6 +308,51 @@ if (result.value) {
 }
 ```
 
+### Programmatic Close API (New!)
+
+Close message boxes programmatically from the parent process:
+
+**Handle-based API (Recommended):**
+```typescript
+import { showMessageBoxEx } from '@bobfrankston/msger';
+
+const handle = showMessageBoxEx({
+    message: 'Processing...',
+    buttons: ['Cancel']
+});
+
+console.log('Dialog PID:', handle.pid);
+
+// Close after 5 seconds
+setTimeout(() => {
+    handle.close();
+}, 5000);
+
+// Wait for result
+const result = await handle.result;
+// Result: {button: 'closed', closed: true} if closed programmatically
+// Result: {button: 'Cancel'} if user clicked Cancel
+```
+
+**Standalone close function:**
+```typescript
+import { showMessageBoxEx, closeMessageBox } from '@bobfrankston/msger';
+
+const handle = showMessageBoxEx({ message: 'Working...' });
+const pid = handle.pid;
+
+// Close by PID from anywhere
+closeMessageBox(pid);
+```
+
+**Use cases:**
+- Progress dialogs that auto-close when task completes
+- Timeout-based notifications
+- Managing multiple dialogs by PID
+- Detached dialogs closed remotely
+
+See [CLOSE-API.md](CLOSE-API.md) for complete documentation.
+
 ## API Functions
 
 ### `showMessageBox(options: MessageBoxOptions): Promise<MessageBoxResult>`
@@ -353,9 +398,9 @@ interface MessageBoxResult {
     button: string;       // Label of clicked button
     value?: string;       // Input value (if allowInput was true)
     form?: object;        // Form data (if form elements present)
-    closed?: boolean;     // True if window was closed
-    dismissed?: boolean;  // True if dismissed with Escape
-    timeout?: boolean;    // True if auto-closed by timeout
+    closed?: boolean;     // True if closed programmatically via handle.close()
+    dismissed?: boolean;  // True if user pressed Escape
+    timeout?: boolean;    // True if closed due to timeout
     debug?: {             // Debug info (if debug option was true)
         html: string;     // Generated HTML content
         width: number;    // Window width

package/RELEASE-NOTES.md

@@ -0,0 +1,42 @@
+# Release Notes - v0.1.121
+
+## Programmatic Dialog Close API 
+
+msger can now close message boxes programmatically from the parent process!
+
+### What's New
+
+**1. Handle-Based API**
+```javascript
+const handle = showMessageBoxEx({ message: 'Processing...' });
+setTimeout(() => handle.close(), 5000);
+await handle.result; // {button: 'closed', closed: true}
+```
+
+**2. Close by PID**
+```javascript
+closeMessageBox(pid);
+```
+
+**3. Backward Compatible**
+- `showMessageBox()` still works as before
+- Returns promise directly
+
+### Use Cases
+- Progress dialogs that auto-close when task completes
+- Timeout-based notifications
+- Multi-dialog management
+- Remote control of detached dialogs
+
+### Files Added
+- `CLOSE-API.md` - Complete API documentation
+- `tests/test-handle-api.mjs` - Handle API tests
+- `tests/test-close-by-pid.mjs` - PID close tests
+
+### API Reference
+See [CLOSE-API.md](CLOSE-API.md) for complete documentation.
+
+---
+**Version:** 0.1.121  
+**Date:** 2025-11-16  
+**Platform Support:** Windows, Linux (x64), Linux (ARM64/Pi)

package/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["cli.ts"],"names":[],"mappings":";AAMA,wBAA8B,IAAI,kBAyHjC"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["cli.ts"],"names":[],"mappings":";AAMA,wBAA8B,IAAI,kBAgIjC"}

package/cli.js

@@ -21,8 +21,6 @@ export default async function main() {
     if (loadFile) {
         try {
             const loadedConfig = loadConfigFile(ensureJsonExt(loadFile));
-            // Merge: CLI args override loaded config
-            // Only override properties that were explicitly set (not undefined/empty)
             finalOptions = { ...loadedConfig };
             if (options.title)
                 finalOptions.title = options.title;
@@ -66,6 +64,9 @@ export default async function main() {
             process.exit(1);
         }
     }
+    if (!finalOptions.buttons || finalOptions.buttons.length === 0) {
+        finalOptions.buttons = ['OK'];
+    }
     // Help always takes precedence and exits
     if (shouldShowHelp) {
         showHelp();
@@ -85,19 +86,25 @@ export default async function main() {
     if (shouldShowVersion) {
         showVersion();
     }
-    // Save config file if specified
     if (saveFile) {
         try {
-            // Save only the explicit CLI arguments, not the merged/derived settings
-            // This preserves defaults as defaults
-            const saveFilePath = ensureJsonExt(saveFile);
-            saveConfigFile(saveFilePath, options);
+            let saveFilePath;
+            if (saveFile === true) {
+                if (!loadFile) {
+                    console.error('Error: -save without filename requires -load to be specified');
+                    process.exit(1);
+                }
+                saveFilePath = ensureJsonExt(loadFile);
+            }
+            else {
+                saveFilePath = ensureJsonExt(saveFile);
+            }
+            const toSave = saveFile === true ? finalOptions : options;
+            saveConfigFile(saveFilePath, toSave);
             console.log(`Configuration saved to: ${saveFilePath}`);
-            // If -noshow flag is set, exit without showing message box
             if (noshow) {
                 process.exit(0);
             }
-            // If save was the only operation (no content to show), exit
             if (!finalOptions.message && !finalOptions.url && !finalOptions.html) {
                 process.exit(0);
             }

package/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtG,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,MAAM,CAAC,OAAO,CAAC,KAAK,UAAU,IAAI;IAC9B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEnC,2BAA2B;IAC3B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpB,QAAQ,EAAE,CAAC;QACX,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IAED,+BAA+B;IAC/B,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,WAAW,EAAE,iBAAiB,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAE7H,0DAA0D;IAC1D,MAAM,aAAa,GAAG,CAAC,QAAgB,EAAU,EAAE;QAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACnC,OAAO,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,OAAO,CAAC;IAC/C,CAAC,CAAC;IAEF,gCAAgC;IAChC,IAAI,YAAY,GAAG,OAAO,CAAC;IAC3B,IAAI,QAAQ,EAAE,CAAC;QACX,IAAI,CAAC;YACD,MAAM,YAAY,GAAG,cAAc,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC;YAC7D,yCAAyC;YACzC,0EAA0E;YAC1E,YAAY,GAAG,EAAE,GAAG,YAAY,EAAE,CAAC;YACnC,IAAI,OAAO,CAAC,KAAK;gBAAE,YAAY,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;YACtD,IAAI,OAAO,CAAC,OAAO;gBAAE,YAAY,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;YAC5D,IAAI,OAAO,CAAC,IAAI;gBAAE,YAAY,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;YACnD,IAAI,OAAO,CAAC,GAAG;gBAAE,YAAY,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;YAChD,IAAI,OAAO,CAAC,IAAI;gBAAE,YAAY,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;YACnD,IAAI,OAAO,CAAC,GAAG;gBAAE,YAAY,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;YAChD,IAAI,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;gBAAE,YAAY,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;YAC1F,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS;gBAAE,YAAY,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;YACnF,IAAI,OAAO,CAAC,YAAY;gBAAE,YAAY,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;YAC3E,IAAI,OAAO,CAAC,gBAAgB;gBAAE,YAAY,CAAC,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;YACvF,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS;gBAAE,YAAY,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;YAC1E,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS;gBAAE,YAAY,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;YACtF,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS;gBAAE,YAAY,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;YACnF,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS;gBAAE,YAAY,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;YACtF,IAAI,OAAO,CAAC,IAAI;gBAAE,YAAY,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;YACnD,IAAI,OAAO,CAAC,GAAG,KAAK,SAAS;gBAAE,YAAY,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;YAC9D,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS;gBAAE,YAAY,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;YACpE,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS;gBAAE,YAAY,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC3E,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YAClB,OAAO,CAAC,KAAK,CAAC,uBAAuB,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;YACtD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;IACL,CAAC;IAED,yCAAyC;IACzC,IAAI,cAAc,EAAE,CAAC;QACjB,QAAQ,EAAE,CAAC;QACX,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IAED,8DAA8D;IAC9D,wFAAwF;IACxF,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CACnC,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC;QACpB,GAAG,KAAK,UAAU;QAClB,GAAG,KAAK,OAAO;QACf,GAAG,KAAK,MAAM,CACjB,CAAC;IAEF,IAAI,iBAAiB,IAAI,CAAC,cAAc,EAAE,CAAC;QACvC,WAAW,EAAE,CAAC;QACd,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IAED,wEAAwE;IACxE,IAAI,iBAAiB,EAAE,CAAC;QACpB,WAAW,EAAE,CAAC;IAClB,CAAC;IAED,gCAAgC;IAChC,IAAI,QAAQ,EAAE,CAAC;QACX,IAAI,CAAC;YACD,wEAAwE;YACxE,sCAAsC;YACtC,MAAM,YAAY,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;YAC7C,cAAc,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YACtC,OAAO,CAAC,GAAG,CAAC,2BAA2B,YAAY,EAAE,CAAC,CAAC;YACvD,2DAA2D;YAC3D,IAAI,MAAM,EAAE,CAAC;gBACT,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACpB,CAAC;YACD,4DAA4D;YAC5D,IAAI,CAAC,YAAY,CAAC,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;gBACnE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACpB,CAAC;QACL,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YAClB,OAAO,CAAC,KAAK,CAAC,sBAAsB,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;YACrD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;IACL,CAAC;IAED,uDAAuD;IACvD,IAAI,CAAC,YAAY,CAAC,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;QACnE,QAAQ,EAAE,CAAC;QACX,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;IAED,IAAI,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,YAAY,CAAC,CAAC;QAElD,wDAAwD;QACxD,IAAI,YAAY,CAAC,MAAM,EAAE,CAAC;YACtB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAE7C,iCAAiC;QACjC,IAAI,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YACpC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;IACL,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QAClB,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QACvC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;AACL,CAAC;AAED,sEAAsE;AAEtE,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IACnB,MAAM,IAAI,EAAE,CAAC;AACjB,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["cli.ts"],"names":[],"mappings":"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"}

package/cli.ts

@@ -27,8 +27,6 @@ export default async function main() {
     if (loadFile) {
         try {
             const loadedConfig = loadConfigFile(ensureJsonExt(loadFile));
-            // Merge: CLI args override loaded config
-            // Only override properties that were explicitly set (not undefined/empty)
             finalOptions = { ...loadedConfig };
             if (options.title) finalOptions.title = options.title;
             if (options.message) finalOptions.message = options.message;
@@ -54,6 +52,10 @@ export default async function main() {
         }
     }
 
+    if (!finalOptions.buttons || finalOptions.buttons.length === 0) {
+        finalOptions.buttons = ['OK'];
+    }
+
     // Help always takes precedence and exits
     if (shouldShowHelp) {
         showHelp();
@@ -79,19 +81,24 @@ export default async function main() {
         showVersion();
     }
 
-    // Save config file if specified
     if (saveFile) {
         try {
-            // Save only the explicit CLI arguments, not the merged/derived settings
-            // This preserves defaults as defaults
-            const saveFilePath = ensureJsonExt(saveFile);
-            saveConfigFile(saveFilePath, options);
+            let saveFilePath: string;
+            if (saveFile === true) {
+                if (!loadFile) {
+                    console.error('Error: -save without filename requires -load to be specified');
+                    process.exit(1);
+                }
+                saveFilePath = ensureJsonExt(loadFile);
+            } else {
+                saveFilePath = ensureJsonExt(saveFile as string);
+            }
+            const toSave = saveFile === true ? finalOptions : options;
+            saveConfigFile(saveFilePath, toSave);
             console.log(`Configuration saved to: ${saveFilePath}`);
-            // If -noshow flag is set, exit without showing message box
             if (noshow) {
                 process.exit(0);
             }
-            // If save was the only operation (no content to show), exit
             if (!finalOptions.message && !finalOptions.url && !finalOptions.html) {
                 process.exit(0);
             }