termcast 1.3.54 → 1.4.0

package/src/examples/simple-navigation.vitest.tsx

@@ -46,7 +46,7 @@ test('navigation between main and detail views', async () => {
 
 
 
-       ↵ open details   ↑↓ navigate   ^k actions
+       ↵ open details   ↑↓ navigate   ^k actions   :vim
 
 
 
@@ -80,7 +80,7 @@ test('navigation between main and detail views', async () => {
 
 
 
-       ↵ open details   ↑↓ navigate   ^k actions
+       ↵ open details   ↑↓ navigate   ^k actions   :vim
 
 
 
@@ -118,7 +118,7 @@ test('navigation between main and detail views', async () => {
 
 
 
-       ↵ go back   ↑↓ navigate   ^k actions
+       ↵ go back   ↑↓ navigate   ^k actions   :vim
 
 
 
@@ -160,7 +160,7 @@ test('navigation between main and detail views', async () => {
 
 
 
-       ↵ open details   ↑↓ navigate   ^k actions
+       ↵ open details   ↑↓ navigate   ^k actions   :vim
 
 
 
@@ -194,7 +194,7 @@ test('navigation between main and detail views', async () => {
 
 
 
-       ↵ open details   ↑↓ navigate   ^k actions
+       ↵ open details   ↑↓ navigate   ^k actions   :vim
 
 
 
@@ -227,7 +227,7 @@ test('navigation between main and detail views', async () => {
 
 
 
-       ↵ go back   ↑↓ navigate   ^k actions
+       ↵ go back   ↑↓ navigate   ^k actions   :vim
 
 
 
@@ -266,7 +266,7 @@ test('navigation between main and detail views', async () => {
 
 
 
-       ↵ open details   ↑↓ navigate   ^k actions
+       ↵ open details   ↑↓ navigate   ^k actions   :vim
 
 
 
@@ -306,12 +306,12 @@ test('navigation with actions panel', async () => {
       │                                                                │
       │   Settings                                                     │
       │   Change Theme...                                              │
+      │   Enable Vim Mode                                              │
       │   Toggle Console Logs                                          │
       │                                                                │
       │                                                                │
       │                                                                │
       │                                                                │
-      │                                                                │
       │   ↵ select   ↑↓ navigate                                       │
       │                                                                │
       ╰────────────────────────────────────────────────────────────────╯
@@ -339,12 +339,12 @@ test('navigation with actions panel', async () => {
       │                                                                │
       │   Settings                                                     │
       │   Change Theme...                                              │
+      │   Enable Vim Mode                                              │
       │   Toggle Console Logs                                          │
       │                                                                │
       │                                                                │
       │                                                                │
       │                                                                │
-      │                                                                │
       │   ↵ select   ↑↓ navigate                                       │
       │                                                                │
       ╰────────────────────────────────────────────────────────────────╯
@@ -419,7 +419,7 @@ test('navigation with actions panel', async () => {
 
 
 
-       ↵ go back   ↑↓ navigate   ^k actions
+       ↵ go back   ↑↓ navigate   ^k actions   :vim
 
 
 
@@ -450,12 +450,12 @@ test('navigation with actions panel', async () => {
       │                                                                │
       │   Settings                                                     │
       │   Change Theme...                                              │
+      │   Enable Vim Mode                                              │
       │   Toggle Console Logs                                          │
       │                                                                │
       │                                                                │
       │                                                                │
       │                                                                │
-      │                                                                │
       │   ↵ select   ↑↓ navigate                                       │
       │                                                                │
       ╰────────────────────────────────────────────────────────────────╯
@@ -489,7 +489,7 @@ test('navigation with actions panel', async () => {
 
 
 
-       ↵ open details   ↑↓ navigate   ^k actions
+       ↵ open details   ↑↓ navigate   ^k actions   :vim
 
 
 
@@ -535,7 +535,7 @@ test('search functionality in main and detail views', async () => {
 
 
 
-       ↵ open details   ↑↓ navigate   ^k actions
+       ↵ open details   ↑↓ navigate   ^k actions   :vim
 
 
 
@@ -573,7 +573,7 @@ test('search functionality in main and detail views', async () => {
 
 
 
-       ↵ open details   ↑↓ navigate   ^k actions
+       ↵ open details   ↑↓ navigate   ^k actions   :vim
 
 
 
@@ -613,7 +613,7 @@ test('search functionality in main and detail views', async () => {
 
 
 
-       ↵ go back   ↑↓ navigate   ^k actions
+       ↵ go back   ↑↓ navigate   ^k actions   :vim
 
 
 
@@ -650,7 +650,7 @@ test('search functionality in main and detail views', async () => {
 
 
 
-       ↵ go back   ↑↓ navigate   ^k actions
+       ↵ go back   ↑↓ navigate   ^k actions   :vim
 
 
 
@@ -687,7 +687,7 @@ test('search functionality in main and detail views', async () => {
 
 
 
-       ↵ open details   ↑↓ navigate   ^k actions
+       ↵ open details   ↑↓ navigate   ^k actions   :vim
 
 
 

package/src/examples/simple-progress-bar.vitest.tsx

@@ -43,7 +43,7 @@ test('progress bars render in detail metadata and update on selection', async ()
                                             │ ▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁ 7% used
                                             │ Resets Feb 27, 1pm (Asia/Bangkok)
                                             │
-       ↑↓ navigate   ^k actions             │
+       ↑↓ navigate   ^k actions   :vim      │
 
 
 

package/src/examples/store.vitest.tsx

@@ -58,7 +58,7 @@ test('Store extension - searching for spiceblow shows Database', async () => {
 
 
 
-       ↵ view details   ↑↓ navigate   ^k actions          powered by termcast.app
+       ↵ view details   ↑↓ navigate   ^k actions   :vim   powered by termcast.app
 
 
 

package/src/examples/swift-extension.vitest.tsx

@@ -102,7 +102,7 @@ test.skipIf(isLinux)('swift extension dev mode shows command list', async () =>
 
 
 
-       ↵ run command   ↑↓ navigate   ^k actions
+       ↵ run command   ↑↓ navigate   ^k actions   :vim
 
 
 
@@ -153,7 +153,7 @@ test.skipIf(isLinux)('swift extension runs Swift List command and shows items',
 
 
 
-       ↑↓ navigate   ^k actions
+       ↑↓ navigate   ^k actions   :vim
 
 
 

package/src/examples/table-edge-cases.vitest.tsx

@@ -35,8 +35,10 @@ test('inline formatting table renders all rows', async () => {
 
       Table Edge Cases
 
+
       Inline Formatting
 
+
       Feature  Syntax           Result
       Bold     text             bold text
       Italic   text             italic text
@@ -46,6 +48,7 @@ test('inline formatting table renders all rows', async () => {
 
       Single Column
 
+
       Name
       Alice
       Bob
@@ -53,11 +56,13 @@ test('inline formatting table renders all rows', async () => {
 
       Single Row
 
+
       A  B  C  D  E
       1  2  3  4  5
 
       Empty Cells
 
+
       Key   Value      Notes
       host  localhost
             8080       default port
@@ -65,12 +70,14 @@ test('inline formatting table renders all rows', async () => {
 
       Wide Table
 
+
       ID  Name           Email              Role      Department   Location
       1   Alice Johnson  alice@example.com  Engineer  Engineering  SF
       2   Bob Smith      bob@example.com    Designer  Design       NYC
 
       Two Columns
 
+
       Key      Value
       version  2.1.0
       license  MIT
@@ -78,6 +85,7 @@ test('inline formatting table renders all rows', async () => {
 
       Numeric Data
 
+
       Metric   Q1    Q2    Q3    Q4
       Revenue  100   150   200   250
       Users    1000  1500  2000  3000
@@ -86,16 +94,8 @@ test('inline formatting table renders all rows', async () => {
       Done.
 
 
-      esc go back   ^k actions                             powered by termcast.app
-
-
-
-
-
-
-
-
 
+      esc go back   ^k actions                             powered by termcast.app
 
 
 
@@ -219,8 +219,10 @@ test('all tables render without crash - full page snapshot', async () => {
 
       Table Edge Cases
 
+
       Inline Formatting
 
+
       Feature  Syntax           Result
       Bold     text             bold text
       Italic   text             italic text
@@ -230,6 +232,7 @@ test('all tables render without crash - full page snapshot', async () => {
 
       Single Column
 
+
       Name
       Alice
       Bob
@@ -237,11 +240,13 @@ test('all tables render without crash - full page snapshot', async () => {
 
       Single Row
 
+
       A  B  C  D  E
       1  2  3  4  5
 
       Empty Cells
 
+
       Key   Value      Notes
       host  localhost
             8080       default port
@@ -249,12 +254,14 @@ test('all tables render without crash - full page snapshot', async () => {
 
       Wide Table
 
+
       ID  Name           Email              Role      Department   Location
       1   Alice Johnson  alice@example.com  Engineer  Engineering  SF
       2   Bob Smith      bob@example.com    Designer  Design       NYC
 
       Two Columns
 
+
       Key      Value
       version  2.1.0
       license  MIT
@@ -262,6 +269,7 @@ test('all tables render without crash - full page snapshot', async () => {
 
       Numeric Data
 
+
       Metric   Q1    Q2    Q3    Q4
       Revenue  100   150   200   250
       Users    1000  1500  2000  3000
@@ -270,16 +278,8 @@ test('all tables render without crash - full page snapshot', async () => {
       Done.
 
 
-      esc go back   ^k actions                             powered by termcast.app
-
-
-
-
-
-
-
-
 
+      esc go back   ^k actions                             powered by termcast.app
 
 
 

package/src/examples/toast-action.vitest.tsx

@@ -124,7 +124,7 @@ test('pressing escape hides the toast', async () => {
 
 
 
-       ↵ show toast   ↑↓ navigate   ^k actions
+       ↵ show toast   ↑↓ navigate   ^k actions   :vim
 
 
 
@@ -238,7 +238,7 @@ test('form toast: pressing enter triggers primary action (navigation)', async ()
 
 
 
-       ↑↓ navigate   ^k actions
+       ↑↓ navigate   ^k actions   :vim
 
 
 

package/src/extensions/dev.tsx

@@ -15,6 +15,7 @@ import { TermcastProvider } from 'termcast/src/internal/providers'
 import { showToast, Toast } from 'termcast/src/apis/toast'
 import { Icon } from 'termcast'
 import { useTheme, initializeTheme } from 'termcast/src/theme'
+import { initializeVimMode } from 'termcast/src/vim-mode'
 import { logger } from '../logger'
 import { getCommandsWithFiles, CommandWithFile, RaycastPackageJson } from '../package-json'
 import { buildExtensionCommands } from '../build'
@@ -226,8 +227,9 @@ export async function startDevMode({
     devRebuildCount: 1,
   })
 
-  // Load theme after state reset — extensionPath is now set so it reads from the correct DB
+  // Load theme and vim mode after state reset — extensionPath is now set so it reads from the correct DB
   initializeTheme()
+  initializeVimMode()
 
   function App(): any {
     const devElement = useStore((state) => state.devElement)
@@ -299,8 +301,9 @@ export async function startCompiledExtension({
     devRebuildCount: 1,
   })
 
-  // Load theme after state reset — extensionPath is now set so it reads from the correct DB
+  // Load theme and vim mode after state reset — extensionPath is now set so it reads from the correct DB
   initializeTheme()
+  initializeVimMode()
 
   function App(): any {
     const devElement = useStore((state) => state.devElement)

package/src/extensions/dev.vitest.tsx

@@ -65,7 +65,7 @@ test('dev command shows extension commands list', async () => {
        Show State Shows the current application state in view
 
 
-       ↵ run command   ↑↓ navigate   ^k actions
+       ↵ run command   ↑↓ navigate   ^k actions   :vim
     "
   `)
 }, 30000)
@@ -101,7 +101,7 @@ test('selecting command with arguments shows arguments form', async () => {
 
 
 
-       ↵ run command   ↑↓ navigate   ^k actions
+       ↵ run command   ↑↓ navigate   ^k actions   :vim
     "
   `)
 
@@ -217,7 +217,7 @@ test('can fill arguments and run command', async () => {
 
 
 
-       ↵ copy value   ↑↓ navigate   ^k actions
+       ↵ copy value   ↑↓ navigate   ^k actions   :vim
     "
   `)
 }, 30000)

package/src/globals.ts

@@ -2,8 +2,9 @@
 // Set up global references for external packages
 //
 import { logger } from './logger'
+import { setEnv } from '#platform/runtime'
 
-process.env.TERMCAST = 'true'
+setEnv('TERMCAST', 'true')
 
 import * as opentuiCore from '@opentui/core'
 import * as opentuiReact from '@opentui/react'

package/src/internal/error-handler.tsx

@@ -1,5 +1,6 @@
 import { showFailureToast } from 'termcast/src/apis/toast'
 import { logger } from 'termcast/src/logger'
+import { setupErrorHandlers } from '#platform/runtime'
 
 let initialized = false
 
@@ -7,26 +8,23 @@ export function initializeErrorHandlers(): void {
   if (initialized) return
   initialized = true
 
-  process.on('unhandledRejection', (reason) => {
-    const err = reason instanceof Error ? reason : new Error(String(reason))
-    logger.error('Unhandled rejection:', err)
-    showFailureToast(err, {
-      title: 'Unhandled Promise Rejection',
-    }).catch((toastErr) => {
-      logger.error('Failed to show toast for unhandled rejection:', toastErr)
-    })
-  })
-
-  process.on('uncaughtException', (err) => {
-    logger.error('Uncaught exception:', err)
-    showFailureToast(err, {
-      title: 'Uncaught Exception',
-    }).catch((toastErr) => {
-      logger.error('Failed to show toast for uncaught exception:', toastErr)
-    })
-  })
-
-  process.on('uncaughtExceptionMonitor', (err, origin) => {
-    logger.error(`Uncaught exception from ${origin}:`, err)
+  setupErrorHandlers((err, type) => {
+    if (type === 'unhandledRejection') {
+      logger.error('Unhandled rejection:', err)
+      showFailureToast(err, {
+        title: 'Unhandled Promise Rejection',
+      }).catch((toastErr) => {
+        logger.error('Failed to show toast for unhandled rejection:', toastErr)
+      })
+    } else if (type === 'uncaughtException') {
+      logger.error('Uncaught exception:', err)
+      showFailureToast(err, {
+        title: 'Uncaught Exception',
+      }).catch((toastErr) => {
+        logger.error('Failed to show toast for uncaught exception:', toastErr)
+      })
+    } else {
+      logger.error(`Uncaught exception from ${type}:`, err)
+    }
   })
 }

package/src/internal/providers.tsx

@@ -15,6 +15,7 @@ import { useTheme } from 'termcast/src/theme'
 import { useStore } from 'termcast/src/state'
 import { useKeyboard, useRenderer } from '@opentui/react'
 import { initializeErrorHandlers } from 'termcast/src/internal/error-handler'
+import { stdoutWrite } from '#platform/runtime'
 
 import { InFocus } from './focus-context'
 import { Clipboard } from '../apis/clipboard'
@@ -150,6 +151,44 @@ export function TermcastProvider(props: ProvidersProps): any {
   const theme = useTheme()
   const renderer = useRenderer()
 
+  // TODO: Remove this when opentui adds { name: "backspace", super: true, action: "delete-to-line-start" }
+  // to defaultTextareaKeybindings in packages/core/src/renderables/Textarea.ts
+  // Translate Cmd+Backspace (kitty CSI \x1b[127;9u) to Ctrl+U (\x15) so opentui's
+  // textarea keybinding for delete-to-line-start handles it. opentui doesn't have a
+  // super+backspace binding, so we remap at the input level before key dispatch.
+  React.useLayoutEffect(() => {
+    if (!renderer) return
+    const handler = (sequence: string) => {
+      if (sequence === '\x1b[127;9u') {
+        renderer.stdin.emit('data', '\x15')
+        return true
+      }
+      return false
+    }
+    renderer.prependInputHandler(handler)
+    return () => {
+      renderer.removeInputHandler(handler)
+    }
+  }, [renderer])
+
+  // Sync terminal background with the active termcast theme via OSC 11 (standard escape
+  // sequence to set terminal background color). This works on WezTerm, iTerm2, kitty, etc.
+  // WezTerm's set_config_overrides for colors has a bug (#5451) where it only hot-reloads
+  // non-focused windows, so we use OSC 11 instead which updates immediately.
+  // Uses renderer's realStdoutWrite to bypass opentui's stdout interception.
+  React.useLayoutEffect(() => {
+    if (!renderer) return
+    // OSC 11 ; color ST — sets terminal default background color
+    const sequence = `\x1b]11;${theme.background}\x07`
+    const realWrite = (renderer as any).realStdoutWrite as typeof process.stdout.write | undefined
+    if (realWrite) {
+      // realStdoutWrite needs process.stdout as `this` context
+      realWrite.call(process.stdout, sequence)
+    } else {
+      stdoutWrite(sequence)
+    }
+  }, [renderer, theme.background])
+
   useKeyboard((key) => {
     if (!renderer) return
     if (key.ctrl && key.name === 'd') {

package/src/logger.tsx

@@ -1,14 +1,19 @@
-import * as fs from 'fs'
-import * as path from 'path'
-import util from 'node:util'
+import {
+  joinPath,
+  cwd,
+  unlinkIfExists,
+  appendToFile,
+  inspectValue,
+  getEnv,
+  exit,
+  setupErrorHandlers,
+} from '#platform/runtime'
 import { useEffect } from 'react'
 
-const LOG_FILE = path.join(process.cwd(), 'app.log')
+const LOG_FILE = joinPath(cwd(), 'app.log')
 
 // Delete log file on process start
-if (fs.existsSync(LOG_FILE)) {
-  fs.unlinkSync(LOG_FILE)
-}
+unlinkIfExists(LOG_FILE)
 
 function serialize(msg: any): string {
   if (msg instanceof Error) {
@@ -17,7 +22,7 @@ function serialize(msg: any): string {
   if (typeof msg === 'string') {
     return msg
   }
-  return util.inspect(msg, { depth: 3 })
+  return inspectValue(msg, 3)
 }
 
 export const logger = {
@@ -25,21 +30,21 @@ export const logger = {
     const timestamp = new Date().toISOString()
     const formattedMessages = messages.map(serialize).join(' ')
     const logEntry = `[${timestamp}] ${formattedMessages}\n`
-    fs.appendFileSync(LOG_FILE, logEntry)
+    appendToFile(LOG_FILE, logEntry)
     console.log(...messages)
   },
   error: (...messages: any[]) => {
     const timestamp = new Date().toISOString()
     const formattedMessages = messages.map(serialize).join(' ')
     const logEntry = `[${timestamp}] ERROR: ${formattedMessages}\n`
-    fs.appendFileSync(LOG_FILE, logEntry)
+    appendToFile(LOG_FILE, logEntry)
     console.error(...messages)
   },
   warn: (...messages: any[]) => {
     const timestamp = new Date().toISOString()
     const formattedMessages = messages.map(serialize).join(' ')
     const logEntry = `[${timestamp}] WARN: ${formattedMessages}\n`
-    fs.appendFileSync(LOG_FILE, logEntry)
+    appendToFile(LOG_FILE, logEntry)
     console.warn(...messages)
   },
   trace: (...messages: any[]) => {
@@ -54,41 +59,33 @@ export const logger = {
     }
     const formattedMessages = messages.map(serialize).join(' ')
     const logEntry = `[${timestamp}] TRACE: ${formattedMessages}\n${stack}\n`
-    fs.appendFileSync(LOG_FILE, logEntry)
+    appendToFile(LOG_FILE, logEntry)
     console.trace(...messages)
   },
 }
 
 // Catch unhandled errors and exceptions
-process.on('uncaughtException', (error: Error) => {
-  if (error instanceof Error) {
-    logger.error('Uncaught Exception:', error.message, error.stack)
-  } else {
-    logger.error('Uncaught Exception:', serialize(error))
-  }
-  // In app mode, don't exit on uncaught exceptions — the error boundary
-  // will catch React errors, and crashing the whole app is worse than
-  // a broken screen the user can recover from.
-  if (process.env.TERMCAST_APP_MODE !== '1') {
-    process.exit(1)
-  }
-})
-
-process.on('unhandledRejection', async (reason: any, promise: Promise<any>) => {
-  if (reason instanceof Error) {
-    logger.error(
-      'Unhandled Rejection at:',
-      promise,
-      'reason:',
-      reason.message,
-      reason.stack,
-    )
+setupErrorHandlers((error, type) => {
+  if (type === 'uncaughtException') {
+    if (error instanceof Error) {
+      logger.error('Uncaught Exception:', error.message, error.stack)
+    } else {
+      logger.error('Uncaught Exception:', serialize(error))
+    }
+    // In app mode, don't exit on uncaught exceptions — the error boundary
+    // will catch React errors, and crashing the whole app is worse than
+    // a broken screen the user can recover from.
+    if (getEnv('TERMCAST_APP_MODE') !== '1') {
+      exit(1)
+    }
+  } else if (type === 'unhandledRejection') {
+    if (error instanceof Error) {
+      logger.error('Unhandled Rejection:', error.message, error.stack)
+    } else {
+      logger.error('Unhandled Rejection:', serialize(error))
+    }
   } else {
-    logger.error(
-      'Unhandled Rejection at:',
-      promise,
-      'reason:',
-      serialize(reason),
-    )
+    // uncaughtExceptionMonitor
+    logger.error(`Uncaught exception from ${type}:`, error)
   }
 })