termcast 1.3.21 → 1.3.24

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

@@ -0,0 +1,148 @@
+import { test, expect, beforeEach, afterEach } from 'vitest'
+import { launchTerminal, Session } from 'tuistory/src'
+import { execSync } from 'node:child_process'
+import fs from 'node:fs'
+import path from 'node:path'
+
+const fixtureDir = path.resolve(__dirname, '../../fixtures/swift-extension')
+
+// Find binary - check debug first, then release
+function findSwiftBinary(): string {
+  const debugPath = path.join(fixtureDir, 'swift/.build/debug/SwiftAPI')
+  const releasePath = path.join(fixtureDir, 'swift/.build/release/SwiftAPI')
+  if (fs.existsSync(debugPath)) {
+    return debugPath
+  }
+  if (fs.existsSync(releasePath)) {
+    return releasePath
+  }
+  throw new Error(`Swift binary not found at ${debugPath} or ${releasePath}`)
+}
+
+const swiftBinary = findSwiftBinary()
+
+test('swift binary returns items correctly', () => {
+  const stdout = execSync(`${swiftBinary} getItems`, { encoding: 'utf-8' })
+  expect(JSON.parse(stdout)).toMatchInlineSnapshot(`
+    [
+      {
+        "id": "1",
+        "subtitle": "Generated by Swift",
+        "title": "Swift Item One",
+      },
+      {
+        "id": "2",
+        "subtitle": "From native code",
+        "title": "Swift Item Two",
+      },
+      {
+        "id": "3",
+        "subtitle": "Fast and safe",
+        "title": "Swift Item Three",
+      },
+    ]
+  `)
+})
+
+test('swift binary greet function works', () => {
+  const stdout = execSync(`${swiftBinary} greet '"World"'`, { encoding: 'utf-8' })
+  expect(JSON.parse(stdout)).toMatchInlineSnapshot(`"Hello, World! Greetings from Swift."`)
+})
+
+let session: Session
+
+beforeEach(async () => {
+  session = await launchTerminal({
+    command: 'bun',
+    args: ['src/cli.tsx', 'dev', fixtureDir],
+    cwd: path.resolve(__dirname, '../..'),
+    cols: 70,
+    rows: 25,
+  })
+})
+
+afterEach(() => {
+  session?.close()
+})
+
+test('swift extension dev mode shows command list', async () => {
+  // Wait for command list to appear
+  const commandList = await session.text({
+    waitFor: (text) => /Swift List/i.test(text),
+    timeout: 30000,
+  })
+
+  expect(commandList).toMatchInlineSnapshot(`
+    "
+
+
+     Swift Test Extension ───────────────────────────────────────────
+
+     Search commands...
+
+     Commands
+    ›List Items Displays a simple list with some items         view
+     Swift List Displays a list of items returned by a Swift f view
+
+
+
+
+
+
+
+
+
+
+
+
+
+     ↵ run command  ↑↓ navigate  ^k actions"
+  `)
+}, 60000)
+
+test('swift extension runs Swift List command and shows items', async () => {
+  // Wait for command list to appear
+  await session.text({
+    waitFor: (text) => /Swift List/i.test(text),
+    timeout: 30000,
+  })
+
+  // Navigate down to Swift List (it's the second item)
+  await session.press('down')
+  
+  // Select the Swift List command
+  await session.press('return')
+
+  // Wait for Swift items to load and display
+  const swiftListOutput = await session.text({
+    waitFor: (text) => text.includes('Swift Item One'),
+    timeout: 30000,
+  })
+
+  expect(swiftListOutput).toMatchInlineSnapshot(`
+    "
+
+
+     Swift Items ────────────────────────────────────────────────────
+
+     Search...
+
+     Items from Swift
+    ›Swift Item One Generated by Swift
+     Swift Item Two From native code
+     Swift Item Three Fast and safe
+
+
+
+
+
+
+
+
+
+
+
+
+       ↑↓ navigate  ^k actions"
+  `)
+}, 60000)

package/src/examples/synonyms.vitest.tsx

@@ -0,0 +1,159 @@
+import { test, expect, beforeEach, afterEach, beforeAll } from 'vitest'
+import { launchTerminal, Session } from 'tuistory/src'
+import { execSync } from 'node:child_process'
+import path from 'node:path'
+
+const extensionDir = path.resolve(__dirname, '../../extensions/synonyms')
+
+// Install dependencies before running tests
+beforeAll(() => {
+  execSync('bun install', { cwd: extensionDir, stdio: 'inherit' })
+}, 60000)
+
+let session: Session
+
+beforeEach(async () => {
+  session = await launchTerminal({
+    command: 'bun',
+    args: ['src/cli.tsx', 'dev', extensionDir],
+    cwd: path.resolve(__dirname, '../..'),
+    cols: 80,
+    rows: 30,
+  })
+})
+
+afterEach(() => {
+  session?.close()
+})
+
+test('synonyms extension shows preferences form on first launch', async () => {
+  // Wait for preferences form to appear (extension requires LLM provider setup)
+  await session.text({
+    waitFor: (text) => /LLM Provider/i.test(text),
+    timeout: 30000,
+  })
+  
+  // Wait for auto-focus to settle
+  await session.waitIdle()
+  
+  const preferencesForm = await session.text()
+
+  expect(preferencesForm).toMatchInlineSnapshot(`
+    "
+
+
+    ◇  LLM Provider                                                      ▀
+    │  Select...
+    │
+    │  ○ Raycast AI
+    │  ○ OpenAI
+    │  ○ OpenAI Compatible
+    │  ○ Anthropic
+    │  ○ Fireworks.ai
+    │
+    │  Select the LLM provider you want to use
+    │
+    ◇  OpenAI API Key
+    │
+    │  API Key for OpenAI
+    │
+    ◇  OpenAI Model
+    │  gpt-4.1-mini
+    │
+    │  Model name for OpenAI
+    │
+    ◇  OpenAI Compatible URL
+    │
+    │
+    │  Base URL for OpenAI compatible provider
+
+
+     ctrl ↵ submit   tab navigate   ^k actions"
+  `)
+}, 60000)
+
+test('synonyms extension preferences form can be navigated', async () => {
+  // Wait for preferences form to appear
+  await session.text({
+    waitFor: (text) => /LLM Provider/i.test(text),
+    timeout: 30000,
+  })
+  
+  // Wait for auto-focus to settle
+  await session.waitIdle()
+
+  // Navigate down in the dropdown
+  await session.press('down')
+  await session.press('down')
+
+  const afterNavigate = await session.text()
+  expect(afterNavigate).toMatchInlineSnapshot(`
+    "
+
+
+    ◇  LLM Provider                                                      ▀
+    │  Select...
+    │
+    │  ○ Raycast AI
+    │  ○ OpenAI
+    │  ○ OpenAI Compatible
+    │  ○ Anthropic
+    │  ○ Fireworks.ai
+    │
+    │  Select the LLM provider you want to use
+    │
+    ◇  OpenAI API Key
+    │
+    │  API Key for OpenAI
+    │
+    ◇  OpenAI Model
+    │  gpt-4.1-mini
+    │
+    │  Model name for OpenAI
+    │
+    ◇  OpenAI Compatible URL
+    │
+    │
+    │  Base URL for OpenAI compatible provider
+
+
+     ctrl ↵ submit   tab navigate   ^k actions"
+  `)
+
+  // Press tab to move to next field
+  await session.press('tab')
+
+  const afterTab = await session.text()
+  expect(afterTab).toMatchInlineSnapshot(`
+    "
+
+
+    ◆  LLM Provider                                                      ▀
+    │  Select...
+    │
+    │› ○ Raycast AI
+    │  ○ OpenAI
+    │  ○ OpenAI Compatible
+    │  ○ Anthropic
+    │  ○ Fireworks.ai
+    │
+    │  Select the LLM provider you want to use
+    │
+    ◇  OpenAI API Key
+    │
+    │  API Key for OpenAI
+    │
+    ◇  OpenAI Model
+    │  gpt-4.1-mini
+    │
+    │  Model name for OpenAI
+    │
+    ◇  OpenAI Compatible URL
+    │
+    │
+    │  Base URL for OpenAI compatible provider
+
+
+     ctrl ↵ submit   tab navigate   ^k actions"
+  `)
+}, 60000)

package/src/extensions/dev.tsx

@@ -11,7 +11,12 @@ import { showToast, Toast } from 'termcast/src/apis/toast'
 import { Icon } from 'termcast'
 import { getCommandsWithFiles, CommandWithFile } from '../package-json'
 import { buildExtensionCommands } from '../build'
-import { runCommand, clearCommandArguments } from '../utils/run-command'
+import {
+  runCommand,
+  clearCommandArguments,
+  parseExtensionArgs,
+  handleHelpFlag,
+} from '../utils/run-command'
 
 interface BundledCommand extends CommandWithFile {
   bundledPath: string
@@ -21,15 +26,18 @@ interface BundledCommand extends CommandWithFile {
 function ExtensionCommandsList({
   extensionPath,
   commands,
+  skipArgv,
 }: {
   extensionPath: string
   commands: BundledCommand[]
+  skipArgv?: number
 }): any {
   const { push } = useNavigation()
   const { packageJson } = getCommandsWithFiles({
     packageJsonPath: path.join(extensionPath, 'package.json'),
   })
-  const devRebuildCount = useStore((state) => state.devRebuildCount)
+
+  const visibleCommands = commands.filter((cmd) => cmd.mode !== 'menu-bar')
 
   const handleCommandSelect = async (command: BundledCommand) => {
     clearCommandArguments()
@@ -51,7 +59,6 @@ function ExtensionCommandsList({
         bundledPath: command.bundledPath,
         Component: command.Component,
         push,
-        cacheBustParam: String(devRebuildCount),
       })
     } catch (error: any) {
       await showToast({
@@ -62,13 +69,43 @@ function ExtensionCommandsList({
     }
   }
 
+  // Auto-run command from CLI arg or single command
+  React.useLayoutEffect(() => {
+    // Only parse argv on initial load (when skipArgv is provided), not on rebuilds
+    if (skipArgv != null) {
+      const { commandName } = parseExtensionArgs({ skipArgv })
+
+      if (commandName) {
+        const command = visibleCommands.find((cmd) => cmd.name === commandName)
+        if (command) {
+          handleCommandSelect(command)
+        } else {
+          showToast({
+            style: Toast.Style.Failure,
+            title: 'Command not found',
+            message: `No command named "${commandName}"`,
+          })
+        }
+        return
+      }
+    }
+
+    if (visibleCommands.length === 1) {
+      handleCommandSelect(visibleCommands[0])
+    }
+  }, [])
+
+  if (visibleCommands.length === 1) {
+    return null
+  }
+
   return (
     <List
       navigationTitle={packageJson.title || 'Extension Commands'}
       searchBarPlaceholder='Search commands...'
     >
       <List.Section title='Commands'>
-        {commands.filter((cmd) => cmd.mode !== 'menu-bar').map((command) => (
+        {visibleCommands.map((command) => (
           <List.Item
             key={command.name}
             id={command.name}
@@ -111,7 +148,7 @@ function ExtensionCommandsList({
         ))}
       </List.Section>
 
-      {commands.length === 0 && (
+      {visibleCommands.length === 0 && (
         <List.Section title='No Commands'>
           <List.Item
             title='No commands found'
@@ -125,8 +162,10 @@ function ExtensionCommandsList({
 
 export async function startDevMode({
   extensionPath,
+  skipArgv = 0,
 }: {
   extensionPath: string
+  skipArgv?: number
 }): Promise<void> {
   const resolvedPath = path.resolve(extensionPath)
 
@@ -149,13 +188,24 @@ export async function startDevMode({
     target: 'bun',
   })
 
+  // Handle --help before rendering
+  handleHelpFlag({
+    extensionName: packageJson.title || packageJson.name,
+    commands: commands.map((cmd) => ({
+      name: cmd.name,
+      title: cmd.title,
+      description: cmd.description,
+    })),
+    skipArgv,
+  })
+
   // Reset state and set extension information
   useStore.setState({
     ...useStore.getInitialState(),
     extensionPath: resolvedPath,
     extensionPackageJson: packageJson,
     devElement: (
-      <ExtensionCommandsList extensionPath={resolvedPath} commands={commands} />
+      <ExtensionCommandsList extensionPath={resolvedPath} commands={commands} skipArgv={skipArgv} />
     ),
     devRebuildCount: 1,
   })
@@ -174,6 +224,7 @@ export async function startDevMode({
 export async function startCompiledExtension({
   extensionPath,
   compiledCommands,
+  skipArgv = 0,
 }: {
   extensionPath: string
   compiledCommands: Array<{
@@ -181,6 +232,7 @@ export async function startCompiledExtension({
     bundledPath: string
     Component: (props: any) => any
   }>
+  skipArgv?: number
 }): Promise<void> {
   const packageJsonPath = path.join(extensionPath, 'package.json')
   const { packageJson, commands: commandsMetadata } = getCommandsWithFiles({
@@ -196,13 +248,25 @@ export async function startCompiledExtension({
     }
   })
 
+  // Handle --help before rendering
+  handleHelpFlag({
+    extensionName: packageJson.title || packageJson.name,
+    commands: commands.map((cmd) => ({
+      name: cmd.name,
+      title: cmd.title,
+      description: cmd.description,
+    })),
+    skipArgv,
+  })
+
   useStore.setState({
     ...useStore.getInitialState(),
     extensionPath,
     extensionPackageJson: packageJson,
     devElement: (
-      <ExtensionCommandsList extensionPath={extensionPath} commands={commands} />
+      <ExtensionCommandsList extensionPath={extensionPath} commands={commands} skipArgv={skipArgv} />
     ),
+    devRebuildCount: 1,
   })
 
   function App(): any {
@@ -242,6 +306,9 @@ export async function triggerRebuild({
         />
       ),
       devRebuildCount: state.devRebuildCount + 1,
+      navigationStack: [], // Reset navigation so NavigationProvider re-initializes with new devElement
+      dialogStack: [], // Clear any open dialogs/toasts on rebuild
+      toast: null,
     })
   } catch (error: any) {
     await showToast({

package/src/extensions/dev.vitest.tsx

@@ -38,11 +38,10 @@ test('dev command shows extension commands list', async () => {
     ›List Items Displays a simple list with some ite view  ▀
      Search Items Search and filter through a list o view
      Google Oauth                                    view
-     usePromise Demo Shows how to use the usePromise view
-                                                           ▼
+     usePromise Demo Shows how to use the usePromise view  ▼
 
 
-     ↵ select  ↑↓ navigate  ^k actions"
+     ↵ run command  ↑↓ navigate  ^k actions"
   `)
 }, 30000)
 
@@ -68,15 +67,14 @@ test('selecting command with arguments shows arguments form', async () => {
 
      Search commands...
 
-     Search Items Search and filter through a list o view  ▲
-     Google Oauth                                    view
-     usePromise Demo Shows how to use the usePromise view  ▄
+     usePromise Demo Shows how to use the usePromise view  ▲
      Show State Shows the current application state  view
     ›With Arguments Demonstrates command arguments ( view
+     Quick Action Copies current timestamp to cli no-view  ▄
                                                            ▼
 
 
-     ↵ select  ↑↓ navigate  ^k actions"
+     ↵ run command  ↑↓ navigate  ^k actions"
   `)
 
   // Select the command to show arguments form (enter opens action panel, enter again runs)
@@ -93,19 +91,19 @@ test('selecting command with arguments shows arguments form', async () => {
     "
 
 
-    ▪  With Arguments                                      █
-    │  Enter the arguments to run this command.            ▀
+    ■  With Arguments                                      █
+    │  Enter the arguments to run this command.
+    │
+    ◇  Search query
+    │  Search query
     │
-    ◆  Search query
-    ┃  Search query
-    ┃
     ◇  Secret key
     │  Secret key
     ◇  Category
     │  Category
 
 
-     alt ↵ submit   ↑↓ navigate   ^k actions"
+     ctrl ↵ submit   tab navigate   ^k actions"
   `)
 }, 30000)
 
@@ -137,19 +135,19 @@ test('can fill arguments and run command', async () => {
     "
 
 
-    ▪  With Arguments                                      █
-    │  Enter the arguments to run this command.            ▀
+    ■  With Arguments                                      █
+    │  Enter the arguments to run this command.
+    │
+    ◇  Search query
+    │  Search query
     │
-    ◆  Search query
-    ┃  my search term
-    ┃
     ◇  Secret key
     │  Secret key
     ◇  Category
     │  Category
 
 
-     alt ↵ submit   ↑↓ navigate   ^k actions"
+     ctrl ↵ submit   tab navigate   ^k actions"
   `)
 
   // Submit the form with Alt+Enter (opens action panel), then Enter (selects submit)
@@ -171,15 +169,15 @@ test('can fill arguments and run command', async () => {
      Search...
 
      Received Arguments
-    ›Search Query my search term
-     Secret Key (empty)
-     Category (empty)
+    ›▼ Search Query (empty)
+     ▼ Secret Key (empty)
+     ▼ Category (empty)
 
 
 
-     ↵ sele┌────────────────────────────────────────┐
-           │ ✓ Copied to Clipboard - my search term │
-           └────────────────────────────────────────┘"
+     ↵ copy val┌─────────────────────────────────┐
+               │ ✓ Copied to Clipboard - (empty) │
+               └─────────────────────────────────┘"
   `)
 }, 30000)
 
@@ -208,13 +206,81 @@ test('can run simple view command without arguments', async () => {
      Search...
 
      Items                                                 ▲
-    ›First Item This is the first item                     █
-     Second Item This is the second item
-     Third Item This is the third item
-     Fourth Item This is the fourth item
-                                                           ▼
+    ›▲ First Item This is the first item                   █
+     ▲ Second Item This is the second item
+     ▲ Third Item This is the third item
+     ▲ Fourth Item This is the fourth item                 ▼
 
 
-     ↵ select  ↑↓ navigate  ^k actions"
+     ↵ copy item title  ↑↓ navigate  ^k actions"
   `)
 }, 30000)
+
+test('hot reload updates TUI when source file changes', async () => {
+  const hotReloadFixtureDir = path.resolve(__dirname, '../../fixtures/hot-reload-extension')
+  const sourceFilePath = path.join(hotReloadFixtureDir, 'src/detail-view.tsx')
+  const fs = await import('node:fs')
+
+  // Read original content to restore later
+  const originalContent = fs.readFileSync(sourceFilePath, 'utf-8')
+
+  // Start a new session for this test
+  const hotReloadSession = await launchTerminal({
+    command: 'bun',
+    args: ['src/cli.tsx', 'dev', hotReloadFixtureDir],
+    cols: 60,
+    rows: 16,
+  })
+
+  try {
+    // Wait for the extension to load
+    await hotReloadSession.text({
+      waitFor: (text) => /Hot Reload Test/i.test(text) && /Detail View/i.test(text),
+      timeout: 5000,
+    })
+    await hotReloadSession.waitIdle()
+
+    // Run the Detail View command
+    await hotReloadSession.press('enter')
+    await hotReloadSession.press('enter')
+    await hotReloadSession.waitIdle()
+
+    // Wait for the detail view to show
+    await hotReloadSession.text({
+      waitFor: (text) => /MARKER_VALUE/i.test(text),
+      timeout: 10000,
+    })
+
+    // Generate a random number
+    const randomNumber = Math.floor(Math.random() * 1000000)
+
+    // Update the source file with the random number
+    const newContent = originalContent.replace('MARKER_VALUE', `UPDATED_${randomNumber}`)
+    fs.writeFileSync(sourceFilePath, newContent)
+
+    // Wait for rebuild - navigation resets to commands list
+    await hotReloadSession.text({
+      waitFor: (text) => /Hot Reload Test/i.test(text) && /Detail View/i.test(text),
+      timeout: 5000,
+    })
+    await hotReloadSession.waitIdle()
+
+    // Run the command again to see updated content
+    await hotReloadSession.press('enter')
+    await hotReloadSession.press('enter')
+    await hotReloadSession.waitIdle()
+
+    // Wait for the updated content
+    await hotReloadSession.text({
+      waitFor: (text) => text.includes(`UPDATED_${randomNumber}`),
+      timeout: 10000,
+    })
+
+    const updatedSnapshot = await hotReloadSession.text()
+    expect(updatedSnapshot).toContain(`UPDATED_${randomNumber}`)
+  } finally {
+    // Restore original content
+    fs.writeFileSync(sourceFilePath, originalContent)
+    hotReloadSession?.close()
+  }
+}, 60000)