@bobfrankston/msgapidefs 0.1.2 → 0.1.4

package/.claude/settings.local.json

@@ -1,7 +1,11 @@
 {
   "permissions": {
     "allow": [
-      "Bash(tsc:*)"
+      "Bash(tsc:*)",
+      "Bash(npm init:*)",
+      "Bash(npm install:*)",
+      "Bash(node cli.js:*)",
+      "Bash(node --version:*)"
     ],
     "deny": [],
     "ask": []

package/README.md

@@ -10,47 +10,28 @@ npm install @bobfrankston/msgapidefs
 
 ## Usage
 
-### TypeScript
-
 ```typescript
-import type { MsgAPI } from '@bobfrankston/msgapidefs';
-import { isMsgAPI, getMsgAPI } from '@bobfrankston/msgapidefs';
-
-// Option 1: Type the global window.msgapi
-declare global {
-    interface Window {
-        msgapi?: MsgAPI;
-    }
-}
-
-// Check if running in msgview/msger
-if (isMsgAPI()) {
-    window.msgapi!.setTitle('My Application');
-    window.msgapi!.saveData('lastOpened', new Date().toISOString());
-}
-
-// Option 2: Use getMsgAPI() for cross-platform compatibility
-const msgapi = getMsgAPI();
-msgapi.saveData('userPrefs', { theme: 'dark' });  // Works in both msgview/msger and browser!
-msgapi.setTitle('My App');  // Only works in msgview/msger, no-op in browser
-```
-
-### JavaScript
+// Import to register global window.msgapi type
+import '../node_modules/@bobfrankston/msgapidefs/msgapidefs.js';
+// Note: '../node_modules/@bobfrankston/msgapidefs/index.js' may also work via package.json exports
 
-```javascript
-import { isMsgAPI, getMsgAPI } from '@bobfrankston/msgapidefs';
+// Or import types explicitly
+import type { MsgAPI, MsgResult } from '../node_modules/@bobfrankston/msgapidefs/msgapidefs.js';
 
-const msgapi = getMsgAPI();
+// msgapi provides APIs not available in browsers/webviews
+if (window.msgapi) {
+    // Window control beyond browser capabilities
+    window.msgapi.setFullscreen(true);
+    window.msgapi.setAlwaysOnTop(true);
 
-// Data persistence (works in both msgview/msger and browser)
-msgapi.saveData('userSettings', { fontSize: 14, theme: 'dark' });
-const settings = msgapi.loadData('userSettings', { fontSize: 12 });
-
-// Window control (msgview/msger only, gracefully degrades in browser)
-if (isMsgAPI()) {
-    msgapi.toggleFullscreen();
-    msgapi.setAlwaysOnTop(true);
+    // File system access (requires allowFs flag)
+    const file = await window.msgapi.fs?.selectFile();
 }
+
+// For standard browser APIs, use native methods:
+document.title = 'My App';  // Instead of msgapi.setTitle()
+localStorage.setItem('key', 'value');  // Instead of msgapi.saveData()
+window.close();  // Instead of msgapi.close() if not passing result
 ```
 
 ## API Reference
@@ -64,17 +45,9 @@ if (isMsgAPI()) {
 - `setSize(width, height)` - Set window size
 - `setPosition(x, y)` - Set window position
 - `setAlwaysOnTop(enabled: boolean)` - Keep window on top
-- `setTitle(title: string)` - Set window title
-- `close(result?)` - Close window with optional result
-
-### Data Persistence
-
-- `saveData(key, value)` - Save data to localStorage
-- `loadData(key, defaultValue?)` - Load data from localStorage
-- `removeData(key)` - Remove data
-- `clearData()` - Clear all msgapi data
+- `close(result?)` - Close window and return result to parent process
 
-### File System (Coming Soon)
+### File System
 
 - `fs.selectFile(options?)` - Open file picker
 - `fs.selectFiles(options?)` - Open multi-file picker
@@ -112,15 +85,6 @@ The samples demonstrate:
 - Session management
 - And more!
 
-## Browser Compatibility
-
-The `getMsgAPI()` function returns a browser-compatible implementation:
-
-- **Data persistence**: Uses localStorage in both msgview/msger and browser
-- **Window control**: No-op in browser (except `setTitle` updates document.title)
-- **File system**: Not available in browser (`fs` is undefined)
-
-This allows you to write code once that works in both environments!
 
 ## Related Packages
 

package/msgapidefs.d.ts

@@ -4,20 +4,7 @@
  * This module provides type-safe access to msgapi's window control,
  * data persistence, and file system features (used by msgview and msger).
  *
- * Usage:
- * ```typescript
- * // Import to register global window.msgapi type (browser direct import)
- * import '../node_modules/@bobfrankston/msgapidefs/msgapidefs.js';
- * // Note: '../node_modules/@bobfrankston/msgapidefs/index.js' may also work via package.json exports
- *
- * // Or import types explicitly
- * import type { MsgAPI, MsgResult } from '../node_modules/@bobfrankston/msgapidefs/msgapidefs.js';
- *
- * // window.msgapi is now typed automatically
- * if (window.msgapi) {
- *     window.msgapi.setTitle('My App');
- * }
- * ```
+ * See README.md for complete usage documentation and examples.
  */
 /**
  * Result object returned when the window closes
@@ -133,14 +120,7 @@ export interface MsgAPI {
      */
     setAlwaysOnTop(enabled: boolean): void;
     /**
-     * Set window title
-     * @param title - New window title
-     * @example
-     * msgapi.setTitle("My Application");
-     */
-    setTitle(title: string): void;
-    /**
-     * Close the window
+     * Close the window and return result to parent process
      * @param result - Optional result to return to parent process
      * @example
      * // Close with default dismissed result
@@ -150,48 +130,6 @@ export interface MsgAPI {
      * msgapi.close({button: 'OK', value: 'user data'});
      */
     close(result?: Partial<MsgResult>): void;
-    /**
-     * Send result and close window (legacy compatibility)
-     * @param result - Result to return to parent process
-     * @example
-     * msgapi.sendResult({button: 'Submit', value: 'form data'});
-     */
-    sendResult(result: Partial<MsgResult>): void;
-    /**
-     * Save data to persistent storage
-     * Data is stored with 'msgapi_' prefix in localStorage
-     * @param key - Storage key
-     * @param value - Value to store (will be JSON.stringify'd)
-     * @returns true on success, false on failure
-     * @example
-     * msgapi.saveData('userPrefs', {theme: 'dark', fontSize: 14});
-     */
-    saveData(key: string, value: any): boolean;
-    /**
-     * Load data from persistent storage
-     * @param key - Storage key
-     * @param defaultValue - Default value if key not found
-     * @returns Stored value or defaultValue
-     * @example
-     * const prefs = msgapi.loadData('userPrefs', {theme: 'light'});
-     */
-    loadData<T = any>(key: string, defaultValue?: T): T;
-    /**
-     * Remove data from persistent storage
-     * @param key - Storage key to remove
-     * @returns true on success, false on failure
-     * @example
-     * msgapi.removeData('tempData');
-     */
-    removeData(key: string): boolean;
-    /**
-     * Clear all msgapi data from persistent storage
-     * Only removes items with 'msgapi_' prefix
-     * @returns true on success, false on failure
-     * @example
-     * msgapi.clearData();
-     */
-    clearData(): boolean;
     /**
      * File system operations namespace
      */

package/msgapidefs.js

@@ -4,19 +4,6 @@
  * This module provides type-safe access to msgapi's window control,
  * data persistence, and file system features (used by msgview and msger).
  *
- * Usage:
- * ```typescript
- * // Import to register global window.msgapi type (browser direct import)
- * import '../node_modules/@bobfrankston/msgapidefs/msgapidefs.js';
- * // Note: '../node_modules/@bobfrankston/msgapidefs/index.js' may also work via package.json exports
- *
- * // Or import types explicitly
- * import type { MsgAPI, MsgResult } from '../node_modules/@bobfrankston/msgapidefs/msgapidefs.js';
- *
- * // window.msgapi is now typed automatically
- * if (window.msgapi) {
- *     window.msgapi.setTitle('My App');
- * }
- * ```
+ * See README.md for complete usage documentation and examples.
  */
 export {};

package/msgapidefs.ts

@@ -4,20 +4,7 @@
  * This module provides type-safe access to msgapi's window control,
  * data persistence, and file system features (used by msgview and msger).
  *
- * Usage:
- * ```typescript
- * // Import to register global window.msgapi type (browser direct import)
- * import '../node_modules/@bobfrankston/msgapidefs/msgapidefs.js';
- * // Note: '../node_modules/@bobfrankston/msgapidefs/index.js' may also work via package.json exports
- *
- * // Or import types explicitly
- * import type { MsgAPI, MsgResult } from '../node_modules/@bobfrankston/msgapidefs/msgapidefs.js';
- *
- * // window.msgapi is now typed automatically
- * if (window.msgapi) {
- *     window.msgapi.setTitle('My App');
- * }
- * ```
+ * See README.md for complete usage documentation and examples.
  */
 
 /**
@@ -146,15 +133,7 @@ export interface MsgAPI {
     setAlwaysOnTop(enabled: boolean): void;
 
     /**
-     * Set window title
-     * @param title - New window title
-     * @example
-     * msgapi.setTitle("My Application");
-     */
-    setTitle(title: string): void;
-
-    /**
-     * Close the window
+     * Close the window and return result to parent process
      * @param result - Optional result to return to parent process
      * @example
      * // Close with default dismissed result
@@ -165,59 +144,8 @@ export interface MsgAPI {
      */
     close(result?: Partial<MsgResult>): void;
 
-    /**
-     * Send result and close window (legacy compatibility)
-     * @param result - Result to return to parent process
-     * @example
-     * msgapi.sendResult({button: 'Submit', value: 'form data'});
-     */
-    sendResult(result: Partial<MsgResult>): void;
-
-    // ========================================
-    // Data Persistence (localStorage wrapper)
-    // ========================================
-
-    /**
-     * Save data to persistent storage
-     * Data is stored with 'msgapi_' prefix in localStorage
-     * @param key - Storage key
-     * @param value - Value to store (will be JSON.stringify'd)
-     * @returns true on success, false on failure
-     * @example
-     * msgapi.saveData('userPrefs', {theme: 'dark', fontSize: 14});
-     */
-    saveData(key: string, value: any): boolean;
-
-    /**
-     * Load data from persistent storage
-     * @param key - Storage key
-     * @param defaultValue - Default value if key not found
-     * @returns Stored value or defaultValue
-     * @example
-     * const prefs = msgapi.loadData('userPrefs', {theme: 'light'});
-     */
-    loadData<T = any>(key: string, defaultValue?: T): T;
-
-    /**
-     * Remove data from persistent storage
-     * @param key - Storage key to remove
-     * @returns true on success, false on failure
-     * @example
-     * msgapi.removeData('tempData');
-     */
-    removeData(key: string): boolean;
-
-    /**
-     * Clear all msgapi data from persistent storage
-     * Only removes items with 'msgapi_' prefix
-     * @returns true on success, false on failure
-     * @example
-     * msgapi.clearData();
-     */
-    clearData(): boolean;
-
     // ========================================
-    // File System Access (to be implemented)
+    // File System Access
     // ========================================
 
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bobfrankston/msgapidefs",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "TypeScript definitions for msgapi JavaScript API (msgview/msger)",
   "type": "module",
   "main": "./msgapidefs.js",

package/samples.html

@@ -1,4 +1,3 @@
-<!DOCTYPE html>
 <html>
 <head>
     <meta charset="UTF-8">
@@ -72,6 +71,27 @@
             border-radius: 3px;
             font-family: 'Courier New', monospace;
         }
+        button.danger {
+            background: #dc3545;
+        }
+        button.danger:hover {
+            background: #c82333;
+        }
+        .small-text {
+            font-size: 12px;
+            color: #666;
+            margin-top: 10px;
+        }
+        .medium-text {
+            margin-top: 10px;
+            font-size: 13px;
+        }
+        h3.spaced {
+            margin-top: 20px;
+        }
+        ul.feature-list {
+            font-size: 13px;
+        }
     </style>
 </head>
 <body>
@@ -118,11 +138,11 @@
     <div class="section">
         <h2>Window Controls (⚠️ Currently Broken)</h2>
         <p>These buttons demonstrate the broken IPC window controls. They will log errors but not crash.</p>
-        <button onclick="tryOK()" style="background: #dc3545;">Try OK (Logs Error)</button>
-        <button onclick="tryCancel()" style="background: #dc3545;" class="secondary">Try Cancel (Logs Error)</button>
-        <button onclick="tryClose()" style="background: #dc3545;" class="secondary">Try Close (Logs Error)</button>
+        <button onclick="tryOK()" class="danger">Try OK (Logs Error)</button>
+        <button onclick="tryCancel()" class="danger secondary">Try Cancel (Logs Error)</button>
+        <button onclick="tryClose()" class="danger secondary">Try Close (Logs Error)</button>
         <div id="outputControls" class="output">Click any button to see why window controls don't work</div>
-        <p style="font-size: 12px; color: #666; margin-top: 10px;">
+        <p class="small-text">
             <strong>Why broken:</strong> wry 0.47.2 has a bug where window.ipc.postMessage() crashes with "InvalidUri" error.<br>
             <strong>Workarounds:</strong> Use CLI flags (-size, -title), F11 for fullscreen, X button to close, or Alt+F4.
         </p>
@@ -145,18 +165,18 @@
         <h2>Storage Location & PWA Support</h2>
         <p><strong>localStorage is saved to:</strong></p>
         <code>%LOCALAPPDATA%\Microsoft\Edge\User Data\WebView2\Default\Local Storage\leveldb\</code>
-        <p style="margin-top: 10px; font-size: 13px;">
+        <p class="medium-text">
             Data persists across sessions and survives app restarts.
             Each URL origin has its own storage partition.
         </p>
         <button onclick="showStorageInfo()">Show Storage Info</button>
         <div id="output5" class="output">Click to see current storage info</div>
 
-        <h3 style="margin-top: 20px;">PWA Support ✅</h3>
-        <p style="font-size: 13px;">
+        <h3 class="spaced">PWA Support ✅</h3>
+        <p class="medium-text">
             msger supports Progressive Web Apps loaded via <code>-url</code>:
         </p>
-        <ul style="font-size: 13px;">
+        <ul class="feature-list">
             <li>✅ <strong>Service Workers</strong> - Background sync, offline support</li>
             <li>✅ <strong>IndexedDB</strong> - Large data storage (GBs)</li>
             <li>✅ <strong>Cache API</strong> - Offline assets</li>
@@ -165,7 +185,7 @@
             <li>❌ <strong>Push Notifications</strong> - Platform dependent</li>
             <li>❌ <strong>"Install" UI</strong> - Already native window</li>
         </ul>
-        <p style="font-size: 12px; color: #666;">
+        <p class="small-text">
             Example: <code>node cli.js -url https://your-pwa.app -detach</code>
         </p>
     </div>