termweb 0.8.10 → 0.9.0

package/README.md

@@ -8,7 +8,8 @@ Web browser in your terminal using Kitty graphics protocol.
 
 ## Demo: CLI - browsing the web in terminal
 
-https://github.com/user-attachments/assets/f2782ae1-831e-4153-8c54-60dfd5942ab8
+https://github.com/user-attachments/assets/4019aaa6-754a-4793-9ce7-08da66f20790
+
 
 ## Demo: SDK: building apps with termweb as render engine
 
@@ -97,27 +98,68 @@ termweb.open('https://vscode.dev', {
 if (termweb.isAvailable()) {
   termweb.open('https://example.com');
 }
+
+// Load a Chrome extension
+termweb.open('https://example.com', {
+  extensionPath: '/path/to/unpacked/extension',
+});
 ```
 
+### Chrome Extensions
+
+You can inject unpacked Chrome extensions to extend browser capabilities:
+
+```javascript
+// Ad blocker extension
+termweb.open('https://example.com', {
+  extensionPath: '/path/to/ublock-origin',
+});
+
+// Custom content scripts
+termweb.open('https://myapp.com', {
+  extensionPath: './extensions/custom-injector',
+});
+```
+
+Extensions can provide:
+- **Content Scripts** - Inject custom JS/CSS into pages
+- **Ad Blocking** - Block ads and trackers
+- **Authentication** - Auto-fill credentials or handle OAuth
+- **Page Manipulation** - Modify DOM, intercept requests
+- **Custom APIs** - Expose additional functionality to pages
+
+> **Note:** termweb creates a temporary Chrome profile in `/tmp/termweb-profile-*` that is cleaned up on each launch. Extensions are loaded fresh each session via the `--load-extension` flag, so extension state (settings, data) does not persist between sessions.
+
 ## Controls
 
 ### Keyboard
 
-> **Note:** On macOS use `Cmd`, on Linux use `Ctrl`
+> **Note:** All shortcuts use `Ctrl` on both macOS and Linux
 
 | Key | Action |
 |-----|--------|
-| `Cmd/Ctrl+Q` | Quit |
-| `Cmd/Ctrl+L` | Focus address bar |
-| `Cmd/Ctrl+R` | Reload page |
-| `Cmd/Ctrl+[` | Go back |
-| `Cmd/Ctrl+]` | Go forward |
-| `Cmd/Ctrl+.` | Stop loading |
-| `Cmd/Ctrl+T` | Show tab picker |
-| `Cmd/Ctrl+C` | Copy selection |
-| `Cmd/Ctrl+X` | Cut selection |
-| `Cmd/Ctrl+V` | Paste |
-| `Cmd/Ctrl+A` | Select all |
+| `Ctrl+Q` | Quit |
+| `Ctrl+L` | Focus address bar |
+| `Ctrl+R` | Reload page |
+| `Ctrl+[` | Go back |
+| `Ctrl+]` | Go forward |
+| `Ctrl+.` | Stop loading |
+| `Ctrl+T` | Show tab picker |
+| `Ctrl+C` | Copy selection |
+| `Ctrl+X` | Cut selection |
+| `Ctrl+V` | Paste |
+| `Ctrl+A` | Select all |
+| `Ctrl+H` | Hint mode (Vimium-style click navigation) |
+| `Ctrl+J` | Scroll down |
+| `Ctrl+K` | Scroll up |
+
+### Hint Mode (Vimium-style)
+
+Press `Ctrl+H` to enter hint mode. Yellow labels appear on all clickable elements (links, buttons, inputs). Type the label letters to click that element. Press `Escape` to cancel.
+
+- Labels are sequential: a-z, then aa-zz, then aaa-zzz
+- Type partial labels to filter visible hints
+- After 300ms pause with an exact match, auto-clicks
 
 ### Mouse
 - **Click** - Interact with page elements (links, buttons, inputs)
@@ -129,6 +171,37 @@ if (termweb.isAvailable()) {
 - Click the tab button in toolbar (shows tab count)
 - Native OS dialog appears to select tabs (AppleScript on macOS, zenity on Linux)
 
+## Terminal Apps
+
+Pre-built terminal applications powered by termweb:
+
+### @termweb/code
+
+Full-featured code editor with syntax highlighting for 20+ languages.
+
+```bash
+npx @termweb/code ./src/index.js
+npx @termweb/code ~/projects/app/main.py
+```
+
+### @termweb/markdown
+
+Markdown editor with live preview pane.
+
+```bash
+npx @termweb/markdown ./README.md
+npx @termweb/markdown ~/docs/notes.md
+```
+
+### @termweb/json
+
+JSON editor with validation, formatting, and key sorting.
+
+```bash
+npx @termweb/json ./package.json
+npx @termweb/json ~/config/settings.json
+```
+
 ## Documentation
 
 - [Installation Guide](INSTALLATION.md) - Setup instructions and dependencies

package/lib/index.js

@@ -40,15 +40,26 @@ for (const modulePath of searchPaths) {
  * @param {string} url - URL to open
  * @param {Object} [options] - Options
  * @param {boolean} [options.toolbar=true] - Show navigation toolbar
+ * @param {boolean} [options.hotkeys=true] - Enable keyboard shortcuts (Ctrl+L, Ctrl+R, etc.)
+ * @param {boolean} [options.hints=true] - Enable Ctrl+H hint mode (Vimium-style navigation)
  * @param {boolean} [options.mobile=false] - Use mobile viewport
  * @param {number} [options.scale=1.0] - Page zoom scale
  * @param {boolean} [options.noProfile=false] - Start with fresh profile
+ * @returns {Promise<void>}
  */
 function open(url, options = {}) {
   if (!native) {
-    throw new Error('Native module not found. Build with: zig build');
+    return Promise.reject(new Error('Native module not found. Build with: zig build'));
   }
-  return native.open(url, options);
+  // Wrap synchronous blocking call in a Promise
+  return new Promise((resolve, reject) => {
+    try {
+      native.open(url, options);
+      resolve();
+    } catch (err) {
+      reject(err);
+    }
+  });
 }
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "termweb",
-  "version": "0.8.10",
+  "version": "0.9.0",
   "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": "teamch",
+  "author": "teamchong",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -45,4 +45,4 @@
     "arm64"
   ],
   "dependencies": {}
-}
+}