termweb 0.9.2 → 0.9.6

package/README.md

@@ -8,13 +8,12 @@ Web browser in your terminal using Kitty graphics protocol.
 
 ## Demo: CLI - browsing the web in terminal
 
-https://github.com/user-attachments/assets/4019aaa6-754a-4793-9ce7-08da66f20790
+https://github.com/user-attachments/assets/70b86b29-19b4-458b-8d5d-683f5e139908
 
 
 ## Demo: SDK: building apps with termweb as render engine
 
-https://github.com/user-attachments/assets/806cac11-3348-48b7-95a0-0c98fd61c873
-
+https://github.com/user-attachments/assets/12183bb7-de8b-4e44-b884-216e304ab8ce
 
 ## Features
 
@@ -24,8 +23,7 @@ https://github.com/user-attachments/assets/806cac11-3348-48b7-95a0-0c98fd61c873
 - **Tab Management** - Multiple tabs with native OS dialog picker (Cmd+click or Tab button)
 - **Clipboard Integration** - Ctrl+C/X/V for copy/cut/paste (uses system clipboard)
 - **URL Navigation** - Press Ctrl+L to focus address bar
-- **Mobile Testing** - Use `--mobile` flag for mobile viewport
-- **Zoom Control** - Adjust page scale with `--scale` option
+- **Hint Mode** - Vimium-style keyboard navigation (Ctrl+H)
 
 ## Requirements
 
@@ -67,11 +65,14 @@ zig build
 # Open a URL
 termweb open https://example.com
 
-# Mobile viewport
-termweb open https://example.com --mobile
+# Clone Chrome profile (use existing logins, extensions, settings)
+termweb open https://example.com --profile Default
+
+# App mode (hide navigation bar)
+termweb open https://example.com --no-toolbar
 
-# Custom zoom
-termweb open https://example.com --scale 0.8
+# SSH-optimized (lower frame rate)
+termweb open https://example.com --fps 12
 
 # Show help
 termweb help
@@ -89,9 +90,7 @@ termweb.open('https://example.com');
 
 // With options
 termweb.open('https://vscode.dev', {
-  mobile: false,    // Mobile viewport
   toolbar: false,   // Hide navigation toolbar
-  scale: 0.8,       // Page zoom
 });
 
 // Check availability
@@ -144,6 +143,8 @@ Extensions can provide:
 | `Ctrl+[` | Go back |
 | `Ctrl+]` | Go forward |
 | `Ctrl+.` | Stop loading |
+| `Ctrl+N` | New tab (about:blank) |
+| `Ctrl+W` | Close tab (quit if last tab) |
 | `Ctrl+T` | Show tab picker |
 | `Ctrl+C` | Copy selection |
 | `Ctrl+X` | Cut selection |

package/lib/index.js

@@ -36,7 +36,7 @@ for (const modulePath of searchPaths) {
 }
 
 /**
- * Open a URL in termweb
+ * Open a URL in termweb (blocking)
  * @param {string} url - URL to open
  * @param {Object} [options] - Options
  * @param {boolean} [options.toolbar=true] - Show navigation toolbar
@@ -62,6 +62,135 @@ function open(url, options = {}) {
   });
 }
 
+/**
+ * Open a URL in termweb (non-blocking)
+ * Returns immediately, viewer runs in background
+ * @param {string} url - URL to open
+ * @param {Object} [options] - Same options as open()
+ * @returns {void}
+ */
+function openAsync(url, options = {}) {
+  if (!native) {
+    throw new Error('Native module not found. Build with: zig build');
+  }
+  native.openAsync(url, options);
+}
+
+/**
+ * Evaluate JavaScript in the active viewer
+ * @param {string} script - JavaScript code to execute
+ * @returns {boolean} - true if successful
+ */
+function evalJS(script) {
+  if (!native) {
+    return false;
+  }
+  return native.evalJS(script);
+}
+
+/**
+ * Close the active viewer
+ * @returns {boolean} - true if there was a viewer to close
+ */
+function close() {
+  if (!native) {
+    return false;
+  }
+  return native.close();
+}
+
+/**
+ * Check if a viewer is currently open
+ * @returns {boolean}
+ */
+function isOpen() {
+  if (!native) {
+    return false;
+  }
+  return native.isOpen();
+}
+
+/**
+ * Register a callback to be called when the viewer closes
+ * @param {Function} callback - Function to call on close
+ */
+function onClose(callback) {
+  if (!native) {
+    return;
+  }
+  native.onClose(callback);
+}
+
+/**
+ * Register a callback to receive IPC messages from the browser
+ * Browser sends messages via: console.log('__TERMWEB_IPC__:' + yourMessage)
+ * @param {Function} callback - Function to call with the message string
+ */
+function onMessage(callback) {
+  if (!native) {
+    return;
+  }
+  native.onMessage(callback);
+}
+
+/**
+ * Register a callback to receive key binding events
+ * Called when a key defined in keyBindings option is pressed
+ * @param {Function} callback - Function to call with (key, action)
+ */
+function onKeyBinding(callback) {
+  if (!native) {
+    return;
+  }
+  native.onKeyBinding(callback);
+}
+
+/**
+ * Add a key binding dynamically
+ * @param {string} key - Single letter a-z
+ * @param {string} action - Action string to send when key is pressed
+ * @returns {boolean} - true if successful
+ */
+function addKeyBinding(key, action) {
+  if (!native) {
+    return false;
+  }
+  return native.addKeyBinding(key, action);
+}
+
+/**
+ * Remove a key binding dynamically
+ * @param {string} key - Single letter a-z
+ * @returns {boolean} - true if successful
+ */
+function removeKeyBinding(key) {
+  if (!native) {
+    return false;
+  }
+  return native.removeKeyBinding(key);
+}
+
+/**
+ * Send a message to the page via SDK IPC
+ * Page receives via: window.__termweb.onMessage(callback)
+ * @param {Object|string} message - Message to send (will be JSON serialized)
+ * @returns {boolean} - true if successful
+ */
+function sendToPage(message) {
+  if (!native) {
+    return false;
+  }
+  const json = typeof message === 'string' ? message : JSON.stringify(message);
+  // Escape for JavaScript string literal
+  const escaped = json.replace(/\\/g, '\\\\').replace(/'/g, "\\'").replace(/\n/g, '\\n').replace(/\r/g, '\\r');
+  const script = `(function(){
+    if(window.__termweb && window.__termweb._receive){
+      window.__termweb._receive('${escaped}');
+    }
+  })()`;
+  return native.evalJS(script);
+}
+
 /**
  * Get termweb version
  * @returns {string}
@@ -94,6 +223,16 @@ function isAvailable() {
 
 module.exports = {
   open,
+  openAsync,
+  evalJS,
+  sendToPage,
+  close,
+  isOpen,
+  onClose,
+  onMessage,
+  onKeyBinding,
+  addKeyBinding,
+  removeKeyBinding,
   version,
   isSupported,
   isAvailable,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "termweb",
-  "version": "0.9.2",
+  "version": "0.9.6",
   "description": "Web browser in your terminal using Kitty graphics protocol. SDK for building terminal apps with web technologies.",
   "main": "./lib/index.js",
   "bin": {
@@ -24,7 +24,7 @@
     "cli",
     "web"
   ],
-  "author": "teamchong",
+  "author": "teamch",
   "license": "MIT",
   "repository": {
     "type": "git",