termcast 1.3.21 → 1.3.25

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

@@ -0,0 +1,370 @@
+import { test, expect, afterEach, beforeEach } from 'vitest'
+import { launchTerminal, Session } from 'tuistory/src'
+
+let session: Session
+
+beforeEach(async () => {
+  session = await launchTerminal({
+    command: 'bun',
+    args: ['src/examples/toast-variations.tsx'],
+    cols: 80,
+    rows: 30,
+  })
+})
+
+afterEach(() => {
+  session?.close()
+})
+
+test('toast variations display correctly', async () => {
+  // Simple Success
+  const simpleSuccess = await session.text({
+    waitFor: (text) => text.includes('Simple Success') && text.includes('Success'),
+  })
+  expect(simpleSuccess).toMatchInlineSnapshot(`
+    "
+
+
+     Toast Variations ─────────────────────────────────────────────────────────
+
+     Search...
+
+    ›Simple Success
+     Simple Failure
+     With Short Message
+     With Long Message
+     With Super Long Message
+     With Primary Action
+     With Both Actions
+     Long Title with Actions
+     Animated Loading
+     Error with Retry
+
+
+
+
+
+
+
+
+
+    ┌──────────────────────────────────────────────────────────────────────────┐
+    │ ✓ Success                                                                │
+    └──────────────────────────────────────────────────────────────────────────┘"
+  `)
+
+  // Simple Failure
+  await session.press('down')
+  const simpleFailure = await session.text()
+  expect(simpleFailure).toMatchInlineSnapshot(`
+    "
+
+
+     Toast Variations ─────────────────────────────────────────────────────────
+
+     Search...
+
+     Simple Success
+    ›Simple Failure
+     With Short Message
+     With Long Message
+     With Super Long Message
+     With Primary Action
+     With Both Actions
+     Long Title with Actions
+     Animated Loading
+     Error with Retry
+
+
+
+
+
+
+
+
+
+    ┌──────────────────────────────────────────────────────────────────────────┐
+    │ ✗ Error                                                                  │
+    └──────────────────────────────────────────────────────────────────────────┘"
+  `)
+
+  // With Short Message
+  await session.press('down')
+  const shortMessage = await session.text()
+  expect(shortMessage).toMatchInlineSnapshot(`
+    "
+
+
+     Toast Variations ─────────────────────────────────────────────────────────
+
+     Search...
+
+     Simple Success
+     Simple Failure
+    ›With Short Message
+     With Long Message
+     With Super Long Message
+     With Primary Action
+     With Both Actions
+     Long Title with Actions
+     Animated Loading
+     Error with Retry
+
+
+
+
+
+
+
+
+    ┌──────────────────────────────────────────────────────────────────────────┐
+    │ ✓ Copied                                                                 │
+    │   Text copied to clipboard                                               │
+    └──────────────────────────────────────────────────────────────────────────┘"
+  `)
+
+  // With Long Message
+  await session.press('down')
+  const longMessage = await session.text()
+  expect(longMessage).toMatchInlineSnapshot(`
+    "
+
+
+     Toast Variations ─────────────────────────────────────────────────────────
+
+     Search...
+
+     Simple Success
+     Simple Failure
+     With Short Message
+    ›With Long Message
+     With Super Long Message
+     With Primary Action
+     With Both Actions
+     Long Title with Actions
+     Animated Loading
+     Error with Retry
+
+
+
+
+
+
+    ┌──────────────────────────────────────────────────────────────────────────┐
+    │ ✗ Error                                                                  │
+    │   This is a very long error message that should wrap to multiple lines   │
+    │   when displayed in the toast component. It contains detailed            │
+    │   information about what went wrong during the operation.                │
+    └──────────────────────────────────────────────────────────────────────────┘"
+  `)
+
+  // With Super Long Message
+  await session.press('down')
+  const superLongMessage = await session.text()
+  expect(superLongMessage).toMatchInlineSnapshot(`
+    "
+
+
+     Toast Variations ─────────────────────────────────────────────────────────
+
+     Search...
+
+     Simple Success
+     Simple Failure
+     With Short Message
+     With Long Message
+    ›With Super Long Message
+     With Primary Action
+     With Both Actions
+     Long Title with Actions
+     Animated Loading
+     Error with Retry
+
+
+
+    ┌──────────────────────────────────────────────────────────────────────────┐
+    │ ✗ Warning                                                                │
+    │   Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do        │
+    │   eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim    │
+    │   ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut     │
+    │   aliquip ex ea commodo consequat. Duis aute irure dolor in              │
+    │   reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla    │
+    │   pariatur.                                                              │
+    └──────────────────────────────────────────────────────────────────────────┘"
+  `)
+
+  // With Primary Action
+  await session.press('down')
+  const primaryAction = await session.text()
+  expect(primaryAction).toMatchInlineSnapshot(`
+    "
+
+
+     Toast Variations ─────────────────────────────────────────────────────────
+
+     Search...
+
+     Simple Success
+     Simple Failure
+     With Short Message
+     With Long Message
+     With Super Long Message
+    ›With Primary Action
+     With Both Actions
+     Long Title with Actions
+     Animated Loading
+     Error with Retry
+
+
+
+
+
+
+
+
+    ┌──────────────────────────────────────────────────────────────────────────┐
+    │ ✓ File Deleted [Undo ↵]                                                  │
+    │   document.pdf was moved to trash                                        │
+    └──────────────────────────────────────────────────────────────────────────┘"
+  `)
+
+  // With Both Actions
+  await session.press('down')
+  const bothActions = await session.text()
+  expect(bothActions).toMatchInlineSnapshot(`
+    "
+
+
+     Toast Variations ─────────────────────────────────────────────────────────
+
+     Search...
+
+     Simple Success
+     Simple Failure
+     With Short Message
+     With Long Message
+     With Super Long Message
+     With Primary Action
+    ›With Both Actions
+     Long Title with Actions
+     Animated Loading
+     Error with Retry
+
+
+
+
+
+
+
+
+    ┌──────────────────────────────────────────────────────────────────────────┐
+    │ ✓ Update Available [Install ↵] [Later ⇥]                                 │
+    │   Version 2.0 is ready to install                                        │
+    └──────────────────────────────────────────────────────────────────────────┘"
+  `)
+
+  // Long Title with Actions
+  await session.press('down')
+  const longTitleActions = await session.text()
+  expect(longTitleActions).toMatchInlineSnapshot(`
+    "
+
+
+     Toast Variations ─────────────────────────────────────────────────────────
+
+     Search...
+
+     Simple Success
+     Simple Failure
+     With Short Message
+     With Long Message
+     With Super Long Message
+     With Primary Action
+     With Both Actions
+    ›Long Title with Actions
+     Animated Loading
+     Error with Retry
+
+
+
+
+
+
+
+
+    ┌──────────────────────────────────────────────────────────────────────────┐
+    │ ✓ Operation Completed Successfully [View Results ↵] [Dismiss ⇥]          │
+    │   All files have been processed                                          │
+    └──────────────────────────────────────────────────────────────────────────┘"
+  `)
+
+  // Animated Loading
+  await session.press('down')
+  const animatedLoading = await session.text()
+  expect(animatedLoading).toMatchInlineSnapshot(`
+    "
+
+
+     Toast Variations ─────────────────────────────────────────────────────────
+
+     Search...
+
+     Simple Success
+     Simple Failure
+     With Short Message
+     With Long Message
+     With Super Long Message
+     With Primary Action
+     With Both Actions
+     Long Title with Actions
+    ›Animated Loading
+     Error with Retry
+
+
+
+
+
+
+
+
+    ┌──────────────────────────────────────────────────────────────────────────┐
+    │ ⣽ Processing                                                             │
+    │   Please wait while we process your request...                           │
+    └──────────────────────────────────────────────────────────────────────────┘"
+  `)
+
+  // Error with Retry
+  await session.press('down')
+  const errorRetry = await session.text()
+  expect(errorRetry).toMatchInlineSnapshot(`
+    "
+
+
+     Toast Variations ─────────────────────────────────────────────────────────
+
+     Search...
+
+     Simple Success
+     Simple Failure
+     With Short Message
+     With Long Message
+     With Super Long Message
+     With Primary Action
+     With Both Actions
+     Long Title with Actions
+     Animated Loading
+    ›Error with Retry
+
+
+
+
+
+
+
+    ┌──────────────────────────────────────────────────────────────────────────┐
+    │ ✗ Connection Failed [Retry ↵]                                            │
+    │   Unable to connect to the server. Please check your internet            │
+    │   connection and try again.                                              │
+    └──────────────────────────────────────────────────────────────────────────┘"
+  `)
+}, 30000)

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({