@bobfrankston/msgapidefs 0.1.1 → 0.1.3

package/.claude/settings.local.json

@@ -0,0 +1,9 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(tsc:*)"
+    ],
+    "deny": [],
+    "ask": []
+  }
+}

package/.gitattributes

@@ -0,0 +1,17 @@
+# Force LF line endings for all text files
+* text=auto eol=lf
+
+# Explicit text files
+*.ts text eol=lf
+*.js text eol=lf
+*.json text eol=lf
+*.md text eol=lf
+*.html text eol=lf
+*.css text eol=lf
+*.sh text eol=lf
+
+# Binary files
+*.png binary
+*.jpg binary
+*.ico binary
+*.pdf binary

package/.vscode/settings.json

@@ -0,0 +1,22 @@
+{
+    "workbench.colorCustomizations": {
+        "activityBar.activeBackground": "#c3b9ff",
+        "activityBar.background": "#c3b9ff",
+        "activityBar.foreground": "#15202b",
+        "activityBar.inactiveForeground": "#15202b99",
+        "activityBarBadge.background": "#ff2400",
+        "activityBarBadge.foreground": "#e7e7e7",
+        "commandCenter.border": "#15202b99",
+        "sash.hoverBorder": "#c3b9ff",
+        "statusBar.background": "#9786ff",
+        "statusBar.foreground": "#15202b",
+        "statusBarItem.hoverBackground": "#6b53ff",
+        "statusBarItem.remoteBackground": "#9786ff",
+        "statusBarItem.remoteForeground": "#15202b",
+        "titleBar.activeBackground": "#9786ff",
+        "titleBar.activeForeground": "#15202b",
+        "titleBar.inactiveBackground": "#9786ff99",
+        "titleBar.inactiveForeground": "#15202b99"
+    },
+    "peacock.color": "#9786ff"
+}

package/.vscode/tasks.json

@@ -0,0 +1,20 @@
+{
+    "version": "2.0.0",
+    "tasks": [
+        {
+            "label": "tsc: watch",
+            "type": "shell",
+            "command": "tsc",
+            "args": ["--watch"],
+            "runOptions": {
+                "runOn": "folderOpen"
+            },
+            "problemMatcher": "$tsc-watch",
+            "isBackground": true,
+            "group": {
+                "kind": "build",
+                "isDefault": true
+            }
+        }
+    ]
+}

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,21 +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 type { MsgAPI } from '@bobfrankston/msgapidefs';
- *
- * declare global {
- *     interface Window {
- *         msgapi?: MsgAPI;
- *     }
- * }
- *
- * // Check if running in msgview/msger
- * if (window.msgapi) {
- *     window.msgapi.setTitle('My App');
- * }
- * ```
+ * See README.md for complete usage documentation and examples.
  */
 /**
  * Result object returned when the window closes
@@ -134,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
@@ -151,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
      */
@@ -287,25 +224,6 @@ export interface MsgAPI {
         delete(path: string): Promise<void>;
     };
 }
-/**
- * Helper to check if code is running in msgview/msger
- * @returns true if running in msgapi environment
- * @example
- * if (isMsgAPI()) {
- *     msgapi.setTitle('Running in msgview/msger!');
- * } else {
- *     console.log('Running in browser');
- * }
- */
-export declare function isMsgAPI(): boolean;
-/**
- * Get msgapi API with fallback for browser compatibility
- * @returns msgapi API if available, or stub implementation for browser
- * @example
- * const api = getMsgAPI();
- * api.saveData('key', 'value'); // Works in both msgview/msger and browser
- */
-export declare function getMsgAPI(): MsgAPI;
 /**
  * Declare global window.msgapi
  */
@@ -314,8 +232,3 @@ declare global {
         msgapi?: MsgAPI;
     }
 }
-declare const _default: {
-    isMsgAPI: typeof isMsgAPI;
-    getMsgAPI: typeof getMsgAPI;
-};
-export default _default;

package/msgapidefs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"msgapidefs.d.ts","sourceRoot":"","sources":["msgapidefs.ts"],"names":[],"mappings":"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"}

package/msgapidefs.js

@@ -4,106 +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 type { MsgAPI } from '@bobfrankston/msgapidefs';
- *
- * declare global {
- *     interface Window {
- *         msgapi?: MsgAPI;
- *     }
- * }
- *
- * // Check if running in msgview/msger
- * if (window.msgapi) {
- *     window.msgapi.setTitle('My App');
- * }
- * ```
- */
-/**
- * Helper to check if code is running in msgview/msger
- * @returns true if running in msgapi environment
- * @example
- * if (isMsgAPI()) {
- *     msgapi.setTitle('Running in msgview/msger!');
- * } else {
- *     console.log('Running in browser');
- * }
- */
-export function isMsgAPI() {
-    return typeof window !== 'undefined' && typeof window.msgapi !== 'undefined';
-}
-/**
- * Get msgapi API with fallback for browser compatibility
- * @returns msgapi API if available, or stub implementation for browser
- * @example
- * const api = getMsgAPI();
- * api.saveData('key', 'value'); // Works in both msgview/msger and browser
+ * See README.md for complete usage documentation and examples.
  */
-export function getMsgAPI() {
-    if (isMsgAPI()) {
-        return window.msgapi;
-    }
-    // Return browser-compatible stub
-    return {
-        // Window control - no-op in browser
-        toggleFullscreen: () => { },
-        setFullscreen: () => { },
-        minimize: () => { },
-        maximize: () => { },
-        setSize: () => { },
-        setPosition: () => { },
-        setAlwaysOnTop: () => { },
-        setTitle: (title) => { document.title = title; },
-        close: () => { window.close(); },
-        sendResult: () => { window.close(); },
-        // Data persistence - use localStorage in browser
-        saveData: (key, value) => {
-            try {
-                localStorage.setItem('msgapi_' + key, JSON.stringify(value));
-                return true;
-            }
-            catch {
-                return false;
-            }
-        },
-        loadData: (key, defaultValue) => {
-            try {
-                const item = localStorage.getItem('msgapi_' + key);
-                return item ? JSON.parse(item) : defaultValue;
-            }
-            catch {
-                return defaultValue;
-            }
-        },
-        removeData: (key) => {
-            try {
-                localStorage.removeItem('msgapi_' + key);
-                return true;
-            }
-            catch {
-                return false;
-            }
-        },
-        clearData: () => {
-            try {
-                const keys = Object.keys(localStorage);
-                for (const key of keys) {
-                    if (key.startsWith('msgapi_')) {
-                        localStorage.removeItem(key);
-                    }
-                }
-                return true;
-            }
-            catch {
-                return false;
-            }
-        },
-        // File system - not available in browser
-        fs: undefined
-    };
-}
-export default {
-    isMsgAPI,
-    getMsgAPI
-};
+export {};

package/msgapidefs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"msgapidefs.js","sourceRoot":"","sources":["msgapidefs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAqTH;;;;;;;;;GASG;AACH,MAAM,UAAU,QAAQ;IACpB,OAAO,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,WAAW,CAAC;AACjF,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,SAAS;IACrB,IAAI,QAAQ,EAAE,EAAE,CAAC;QACb,OAAO,MAAM,CAAC,MAAO,CAAC;IAC1B,CAAC;IAED,iCAAiC;IACjC,OAAO;QACH,oCAAoC;QACpC,gBAAgB,EAAE,GAAG,EAAE,GAAE,CAAC;QAC1B,aAAa,EAAE,GAAG,EAAE,GAAE,CAAC;QACvB,QAAQ,EAAE,GAAG,EAAE,GAAE,CAAC;QAClB,QAAQ,EAAE,GAAG,EAAE,GAAE,CAAC;QAClB,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC;QACjB,WAAW,EAAE,GAAG,EAAE,GAAE,CAAC;QACrB,cAAc,EAAE,GAAG,EAAE,GAAE,CAAC;QACxB,QAAQ,EAAE,CAAC,KAAa,EAAE,EAAE,GAAG,QAAQ,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC;QACxD,KAAK,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAChC,UAAU,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAErC,iDAAiD;QACjD,QAAQ,EAAE,CAAC,GAAW,EAAE,KAAU,EAAW,EAAE;YAC3C,IAAI,CAAC;gBACD,YAAY,CAAC,OAAO,CAAC,SAAS,GAAG,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;gBAC7D,OAAO,IAAI,CAAC;YAChB,CAAC;YAAC,MAAM,CAAC;gBACL,OAAO,KAAK,CAAC;YACjB,CAAC;QACL,CAAC;QACD,QAAQ,EAAE,CAAU,GAAW,EAAE,YAAgB,EAAK,EAAE;YACpD,IAAI,CAAC;gBACD,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC;gBACnD,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAE,YAAkB,CAAC;YACzD,CAAC;YAAC,MAAM,CAAC;gBACL,OAAO,YAAiB,CAAC;YAC7B,CAAC;QACL,CAAC;QACD,UAAU,EAAE,CAAC,GAAW,EAAW,EAAE;YACjC,IAAI,CAAC;gBACD,YAAY,CAAC,UAAU,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC;gBACzC,OAAO,IAAI,CAAC;YAChB,CAAC;YAAC,MAAM,CAAC;gBACL,OAAO,KAAK,CAAC;YACjB,CAAC;QACL,CAAC;QACD,SAAS,EAAE,GAAY,EAAE;YACrB,IAAI,CAAC;gBACD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;gBACvC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;oBACrB,IAAI,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;wBAC5B,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;oBACjC,CAAC;gBACL,CAAC;gBACD,OAAO,IAAI,CAAC;YAChB,CAAC;YAAC,MAAM,CAAC;gBACL,OAAO,KAAK,CAAC;YACjB,CAAC;QACL,CAAC;QAED,yCAAyC;QACzC,EAAE,EAAE,SAAS;KAChB,CAAC;AACN,CAAC;AAWD,eAAe;IACX,QAAQ;IACR,SAAS;CACZ,CAAC"}

package/msgapidefs.ts

@@ -4,21 +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 type { MsgAPI } from '@bobfrankston/msgapidefs';
- *
- * declare global {
- *     interface Window {
- *         msgapi?: MsgAPI;
- *     }
- * }
- *
- * // Check if running in msgview/msger
- * if (window.msgapi) {
- *     window.msgapi.setTitle('My App');
- * }
- * ```
+ * See README.md for complete usage documentation and examples.
  */
 
 /**
@@ -147,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
@@ -166,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
     // ========================================
 
     /**
@@ -328,90 +255,6 @@ export interface MsgAPI {
     };
 }
 
-/**
- * Helper to check if code is running in msgview/msger
- * @returns true if running in msgapi environment
- * @example
- * if (isMsgAPI()) {
- *     msgapi.setTitle('Running in msgview/msger!');
- * } else {
- *     console.log('Running in browser');
- * }
- */
-export function isMsgAPI(): boolean {
-    return typeof window !== 'undefined' && typeof window.msgapi !== 'undefined';
-}
-
-/**
- * Get msgapi API with fallback for browser compatibility
- * @returns msgapi API if available, or stub implementation for browser
- * @example
- * const api = getMsgAPI();
- * api.saveData('key', 'value'); // Works in both msgview/msger and browser
- */
-export function getMsgAPI(): MsgAPI {
-    if (isMsgAPI()) {
-        return window.msgapi!;
-    }
-
-    // Return browser-compatible stub
-    return {
-        // Window control - no-op in browser
-        toggleFullscreen: () => {},
-        setFullscreen: () => {},
-        minimize: () => {},
-        maximize: () => {},
-        setSize: () => {},
-        setPosition: () => {},
-        setAlwaysOnTop: () => {},
-        setTitle: (title: string) => { document.title = title; },
-        close: () => { window.close(); },
-        sendResult: () => { window.close(); },
-
-        // Data persistence - use localStorage in browser
-        saveData: (key: string, value: any): boolean => {
-            try {
-                localStorage.setItem('msgapi_' + key, JSON.stringify(value));
-                return true;
-            } catch {
-                return false;
-            }
-        },
-        loadData: <T = any>(key: string, defaultValue?: T): T => {
-            try {
-                const item = localStorage.getItem('msgapi_' + key);
-                return item ? JSON.parse(item) : (defaultValue as T);
-            } catch {
-                return defaultValue as T;
-            }
-        },
-        removeData: (key: string): boolean => {
-            try {
-                localStorage.removeItem('msgapi_' + key);
-                return true;
-            } catch {
-                return false;
-            }
-        },
-        clearData: (): boolean => {
-            try {
-                const keys = Object.keys(localStorage);
-                for (const key of keys) {
-                    if (key.startsWith('msgapi_')) {
-                        localStorage.removeItem(key);
-                    }
-                }
-                return true;
-            } catch {
-                return false;
-            }
-        },
-
-        // File system - not available in browser
-        fs: undefined
-    };
-}
-
 /**
  * Declare global window.msgapi
  */
@@ -420,8 +263,3 @@ declare global {
         msgapi?: MsgAPI;
     }
 }
-
-export default {
-    isMsgAPI,
-    getMsgAPI
-};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bobfrankston/msgapidefs",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "TypeScript definitions for msgapi JavaScript API (msgview/msger)",
   "type": "module",
   "main": "./msgapidefs.js",
@@ -11,13 +11,6 @@
       "types": "./msgapidefs.d.ts"
     }
   },
-  "files": [
-    "msgapidefs.js",
-    "msgapidefs.d.ts",
-    "msgapidefs.ts",
-    "README.md",
-    "samples.html"
-  ],
   "keywords": [
     "msgapi",
     "msgview",

package/tsconfig.json

@@ -0,0 +1,18 @@
+{
+    "compilerOptions": {
+        "target": "ES2020",
+        "module": "ES2020",
+        "lib": ["ES2020", "DOM"],
+        "declaration": true,
+        "outDir": ".",
+        "rootDir": ".",
+        "strict": true,
+        "esModuleInterop": true,
+        "skipLibCheck": true,
+        "forceConsistentCasingInFileNames": true,
+        "moduleResolution": "node",
+        "newLine": "lf"
+    },
+    "include": ["msgapidefs.ts"],
+    "exclude": ["node_modules"]
+}