termcast 1.3.16 → 1.3.19

package/src/cli.tsx

@@ -138,9 +138,10 @@ cli
         .on('add', rebuild)
         .on('unlink', rebuild)
         .on('error', (error) => logger.error('Watcher error:', error))
-    } catch (e) {
+    } catch (e: any) {
+      console.error('Failed to start dev mode:', e?.message || e)
       logger.error(e)
-      logger.log(`failed to start dev`, e)
+      process.exit(1)
     }
   })
 
@@ -364,6 +365,93 @@ cli
     }
   })
 
+cli
+  .command('download <extensionName>', 'Download extension from Raycast extensions repo')
+  .option('-o, --output <path>', 'Output directory', { default: '.' })
+  .action(async (extensionName: string, options: { output: string }) => {
+    try {
+      const destPath = path.resolve(options.output)
+      const extensionDir = path.join(destPath, extensionName)
+
+      console.log(`Downloading extension '${extensionName}' from raycast/extensions...`)
+
+      if (fs.existsSync(extensionDir)) {
+        console.log(`Removing existing directory: ${extensionDir}`)
+        fs.rmSync(extensionDir, { recursive: true, force: true })
+      }
+
+      fs.mkdirSync(destPath, { recursive: true })
+
+      const repoUrl = 'https://github.com/raycast/extensions.git'
+      const cloneCmd = `git clone -n --depth=1 --filter=tree:0 "${repoUrl}" "${extensionName}"`
+      console.log(`Running: ${cloneCmd}`)
+      try {
+        execSync(cloneCmd, {
+          cwd: destPath,
+          stdio: 'inherit',
+        })
+      } catch (error) {
+        console.error(`Failed to clone repository`)
+        process.exit(1)
+      }
+
+      const sparseCmd = `git sparse-checkout set --no-cone "extensions/${extensionName}"`
+      console.log(`Running: ${sparseCmd}`)
+      try {
+        execSync(sparseCmd, {
+          cwd: extensionDir,
+          stdio: 'inherit',
+        })
+      } catch (error) {
+        console.error(`Failed to set sparse-checkout`)
+        process.exit(1)
+      }
+
+      const checkoutCmd = 'git checkout'
+      console.log(`Running: ${checkoutCmd}`)
+      try {
+        execSync(checkoutCmd, {
+          cwd: extensionDir,
+          stdio: 'inherit',
+        })
+      } catch (error) {
+        console.error(`Failed to checkout files`)
+        process.exit(1)
+      }
+
+      const extensionPath = path.join(extensionDir, 'extensions', extensionName)
+
+      if (!fs.existsSync(extensionPath)) {
+        console.error(`Extension '${extensionName}' not found in raycast/extensions repo`)
+        fs.rmSync(extensionDir, { recursive: true, force: true })
+        process.exit(1)
+      }
+
+      const filesToMove = fs.readdirSync(extensionPath)
+      for (const file of filesToMove) {
+        const src = path.join(extensionPath, file)
+        const dest = path.join(extensionDir, file)
+        fs.renameSync(src, dest)
+      }
+
+      fs.rmSync(path.join(extensionDir, 'extensions'), { recursive: true, force: true })
+      fs.rmSync(path.join(extensionDir, '.git'), { recursive: true, force: true })
+
+      console.log(`\nInstalling dependencies...`)
+      execSync('npm install', {
+        cwd: extensionDir,
+        stdio: 'inherit',
+      })
+
+      console.log(`\n✅ Extension downloaded successfully!`)
+      console.log(`📁 Path: ${extensionDir}`)
+      process.exit(0)
+    } catch (error) {
+      console.error('Error downloading extension:', error)
+      process.exit(1)
+    }
+  })
+
 cli.command('', 'List and run installed extensions').action(async () => {
   await runHomeCommand()
 })

package/src/components/actions.tsx

@@ -20,6 +20,11 @@ import { useDialog } from 'termcast/src/internal/dialog'
 import { Dropdown } from 'termcast/src/components/dropdown'
 import { useIsInFocus } from 'termcast/src/internal/focus-context'
 import { CommonProps } from 'termcast/src/utils'
+import type {
+  KeyboardShortcut,
+  KeyboardKeyEquivalent,
+  KeyboardKeyModifier,
+} from 'termcast/src/keyboard'
 import { showToast, Toast } from 'termcast/src/apis/toast'
 import { createDescendants } from 'termcast/src/descendants'
 import { useFormSubmit } from 'termcast/src/components/form/index'
@@ -35,8 +40,8 @@ export interface ActionProps extends CommonProps {
   icon?: string | null
   style?: ActionStyle
   shortcut?: {
-    modifiers?: string[]
-    key: string
+    modifiers?: KeyboardKeyModifier[]
+    key: KeyboardKeyEquivalent
   } | null
   onAction?: () => void
   autoFocus?: boolean
@@ -148,7 +153,7 @@ interface PickDateProps extends Omit<ActionProps, 'onAction'> {
 // Create descendants for Actions - minimal fields needed
 interface ActionDescendant {
   title: string
-  shortcut?: { modifiers?: string[]; key: string } | null
+  shortcut?: { modifiers?: KeyboardKeyModifier[]; key: KeyboardKeyEquivalent } | null
   execute: () => void
 }
 
@@ -586,14 +591,14 @@ interface ActionPanelSubmenuProps extends ActionPanelSectionProps {
   title: string
   icon?: string | null
   shortcut?: {
-    modifiers?: string[]
-    key: string
+    modifiers?: KeyboardKeyModifier[]
+    key: KeyboardKeyEquivalent
   } | null
 }
 
 // Helper function to format shortcuts for display
 function formatShortcut(
-  shortcut?: { modifiers?: string[]; key: string } | null,
+  shortcut?: { modifiers?: KeyboardKeyModifier[]; key: KeyboardKeyEquivalent } | null,
 ): string {
   if (!shortcut) return ''
 

package/src/components/list.tsx

@@ -767,6 +767,19 @@ export const List: ListType = (props) => {
     }
   }, [selectedItemId])
 
+  // Call onSelectionChange when selection changes
+  useEffect(() => {
+    if (!onSelectionChange) return
+
+    const items = Object.values(descendantsContext.map.current)
+      .filter((item) => item.index !== -1)
+      .sort((a, b) => a.index - b.index)
+
+    const currentItem = items.find((item) => item.index === selectedIndex)
+    const selectedId = currentItem?.props?.id ?? null
+    onSelectionChange(selectedId)
+  }, [selectedIndex])
+
   const scrollToItem = (item: { props?: ListItemDescendant }) => {
     const scrollBox = scrollBoxRef.current
     const elementRef = item.props?.elementRef

package/src/examples/list-with-toast.tsx

@@ -0,0 +1,35 @@
+import { renderWithProviders, List, showToast, Toast } from 'termcast'
+
+const items = [
+  { id: '1', title: 'First Item' },
+  { id: '2', title: 'Second Item' },
+  { id: '3', title: 'Third Item' },
+  { id: '4', title: 'Fourth Item' },
+  { id: '5', title: 'Fifth Item' },
+]
+
+function ListWithToast() {
+  const handleSelectionChange = async (id: string | null) => {
+    if (id) {
+      const item = items.find((i) => i.id === id)
+      await showToast({
+        style: Toast.Style.Success,
+        title: 'Selected',
+        message: item?.title,
+      })
+    }
+  }
+
+  return (
+    <List
+      navigationTitle='List With Toast'
+      onSelectionChange={handleSelectionChange}
+    >
+      {items.map((item) => (
+        <List.Item key={item.id} id={item.id} title={item.title} />
+      ))}
+    </List>
+  )
+}
+
+await renderWithProviders(<ListWithToast />)

package/src/examples/list-with-toast.vitest.tsx

@@ -0,0 +1,134 @@
+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/list-with-toast.tsx'],
+    cols: 70,
+    rows: 20,
+  })
+})
+
+afterEach(() => {
+  session?.close()
+})
+
+test('list navigation works while toast is shown', async () => {
+  await session.text({
+    waitFor: (text) => {
+      return /First Item/i.test(text)
+    },
+  })
+
+  const initialSnapshot = await session.text()
+  expect(initialSnapshot).toMatchInlineSnapshot(`
+    "
+
+
+     List With Toast ────────────────────────────────────────────────
+
+     Search...
+
+    ›First Item
+     Second Item
+     Third Item
+     Fourth Item
+     Fifth Item
+
+
+
+
+
+
+     ↵ select  ↑↓ naviga┌─────────────────────────┐
+                        │ ✓ Selected - First Item │
+                        └─────────────────────────┘"
+  `)
+
+  await session.press('down')
+  await new Promise((r) => setTimeout(r, 200))
+
+  const afterFirstDown = await session.text()
+  expect(afterFirstDown).toMatchInlineSnapshot(`
+    "
+
+
+     List With Toast ────────────────────────────────────────────────
+
+     Search...
+
+     First Item
+    ›Second Item
+     Third Item
+     Fourth Item
+     Fifth Item
+
+
+
+
+
+
+     ↵ select  ↑↓ navig┌──────────────────────────┐
+                       │ ✓ Selected - Second Item │
+                       └──────────────────────────┘"
+  `)
+
+  await session.press('down')
+  await new Promise((r) => setTimeout(r, 200))
+
+  const afterSecondDown = await session.text()
+  expect(afterSecondDown).toMatchInlineSnapshot(`
+    "
+
+
+     List With Toast ────────────────────────────────────────────────
+
+     Search...
+
+     First Item
+     Second Item
+    ›Third Item
+     Fourth Item
+     Fifth Item
+
+
+
+
+
+
+     ↵ select  ↑↓ naviga┌─────────────────────────┐
+                        │ ✓ Selected - Third Item │
+                        └─────────────────────────┘"
+  `)
+
+  await session.press('up')
+  await new Promise((r) => setTimeout(r, 200))
+
+  const afterUp = await session.text()
+  expect(afterUp).toMatchInlineSnapshot(`
+    "
+
+
+     List With Toast ────────────────────────────────────────────────
+
+     Search...
+
+     First Item
+    ›Second Item
+     Third Item
+     Fourth Item
+     Fifth Item
+
+
+
+
+
+
+     ↵ select  ↑↓ navig┌──────────────────────────┐
+                       │ ✓ Selected - Second Item │
+                       └──────────────────────────┘"
+  `)
+}, 10000)

package/src/extensions/dev.tsx

@@ -68,7 +68,7 @@ function ExtensionCommandsList({
       searchBarPlaceholder='Search commands...'
     >
       <List.Section title='Commands'>
-        {commands.map((command) => (
+        {commands.filter((cmd) => cmd.mode !== 'menu-bar').map((command) => (
           <List.Item
             key={command.name}
             id={command.name}

package/src/index.tsx

@@ -133,7 +133,9 @@ export { Color } from 'termcast/src/colors'
 // Navigation
 export {
   useNavigation,
+  NavigationProvider,
   NavigationContainer,
+  popToRoot,
 } from 'termcast/src/internal/navigation'
 
 // Hooks
@@ -185,6 +187,7 @@ export {
   environment,
   getSelectedFinderItems,
   getSelectedText,
+  launchCommand,
 } from 'termcast/src/apis/environment'
 export type { Environment, LaunchProps } from 'termcast/src/apis/environment'
 
@@ -223,5 +226,14 @@ export { closeMainWindow, PopToRootType } from 'termcast/src/apis/window'
 // HUD
 export { showHUD } from 'termcast/src/apis/hud'
 
+// Keyboard
+export { Keyboard } from 'termcast/src/keyboard'
+export type {
+  KeyboardKeyEquivalent,
+  KeyboardKeyModifier,
+  KeyboardShortcut,
+  KeyboardCrossPlatformShortcut,
+} from 'termcast/src/keyboard'
+
 // Compile support
 export { startCompiledExtension } from 'termcast/src/extensions/dev'

package/src/internal/dialog.tsx

@@ -170,7 +170,9 @@ export function DialogProvider(props: DialogProviderProps): any {
           })}
         </box>
       )}
-      <ToastOverlay />
+      <InFocus inFocus={false}>
+        <ToastOverlay />
+      </InFocus>
     </>
   )
 }

package/src/internal/navigation.tsx

@@ -17,6 +17,7 @@ import { logger } from '../logger'
 interface Navigation {
   push: (element: ReactNode, onPop?: () => void) => void
   pop: () => void
+  popToRoot: () => void
 }
 
 interface NavigationContextType {
@@ -80,12 +81,29 @@ export function NavigationProvider(props: NavigationProviderProps): any {
     })
   }, [])
 
+  const popToRoot = useCallback(() => {
+    const currentStack = useStore.getState().navigationStack
+    if (currentStack.length <= 1) return
+
+    const poppedItems = currentStack.slice(1)
+    for (const item of poppedItems.reverse()) {
+      if (item?.onPop) {
+        item.onPop()
+      }
+    }
+
+    startNavigationTransition(() => {
+      useStore.setState({ navigationStack: [currentStack[0]] })
+    })
+  }, [])
+
   const navigation = React.useMemo(
     () => ({
       push,
       pop,
+      popToRoot,
     }),
-    [push, pop],
+    [push, pop, popToRoot],
   )
 
   const value = React.useMemo(
@@ -138,6 +156,20 @@ export function useNavigationPending(): boolean {
   return context?.isPending || false
 }
 
+export async function popToRoot(): Promise<void> {
+  const currentStack = useStore.getState().navigationStack
+  if (currentStack.length <= 1) return
+
+  const poppedItems = currentStack.slice(1)
+  for (const item of poppedItems.reverse()) {
+    if (item?.onPop) {
+      item.onPop()
+    }
+  }
+
+  useStore.setState({ navigationStack: [currentStack[0]] })
+}
+
 interface NavigationContainerProps extends CommonProps {
   children: ReactNode
 }

package/src/keyboard.tsx

@@ -0,0 +1,118 @@
+export type KeyEquivalent =
+  | 'a'
+  | 'b'
+  | 'c'
+  | 'd'
+  | 'e'
+  | 'f'
+  | 'g'
+  | 'h'
+  | 'i'
+  | 'j'
+  | 'k'
+  | 'l'
+  | 'm'
+  | 'n'
+  | 'o'
+  | 'p'
+  | 'q'
+  | 'r'
+  | 's'
+  | 't'
+  | 'u'
+  | 'v'
+  | 'w'
+  | 'x'
+  | 'y'
+  | 'z'
+  | '0'
+  | '1'
+  | '2'
+  | '3'
+  | '4'
+  | '5'
+  | '6'
+  | '7'
+  | '8'
+  | '9'
+  | '.'
+  | ','
+  | ';'
+  | '='
+  | '+'
+  | '-'
+  | '['
+  | ']'
+  | '{'
+  | '}'
+  | '«'
+  | '»'
+  | '('
+  | ')'
+  | '/'
+  | '\\'
+  | "'"
+  | '`'
+  | '§'
+  | '^'
+  | '@'
+  | '$'
+  | 'return'
+  | 'delete'
+  | 'deleteForward'
+  | 'tab'
+  | 'arrowUp'
+  | 'arrowDown'
+  | 'arrowLeft'
+  | 'arrowRight'
+  | 'pageUp'
+  | 'pageDown'
+  | 'home'
+  | 'end'
+  | 'space'
+  | 'escape'
+  | 'enter'
+  | 'backspace'
+
+export type KeyModifier = 'cmd' | 'ctrl' | 'opt' | 'shift' | 'alt' | 'windows'
+
+export interface Shortcut {
+  key: KeyEquivalent
+  modifiers: KeyModifier[]
+}
+
+export interface CrossPlatformShortcut {
+  macOS: Shortcut
+  Windows: Shortcut
+}
+
+const CommonShortcuts = {
+  Copy: { modifiers: ['cmd', 'shift'], key: 'c' } as Shortcut,
+  CopyDeeplink: { modifiers: ['cmd', 'shift'], key: 'c' } as Shortcut,
+  CopyName: { modifiers: ['cmd', 'shift'], key: '.' } as Shortcut,
+  CopyPath: { modifiers: ['cmd', 'shift'], key: ',' } as Shortcut,
+  Save: { modifiers: ['cmd'], key: 's' } as Shortcut,
+  Duplicate: { modifiers: ['cmd'], key: 'd' } as Shortcut,
+  Edit: { modifiers: ['cmd'], key: 'e' } as Shortcut,
+  MoveDown: { modifiers: ['cmd', 'shift'], key: 'arrowDown' } as Shortcut,
+  MoveUp: { modifiers: ['cmd', 'shift'], key: 'arrowUp' } as Shortcut,
+  New: { modifiers: ['cmd'], key: 'n' } as Shortcut,
+  Open: { modifiers: ['cmd'], key: 'o' } as Shortcut,
+  OpenWith: { modifiers: ['cmd', 'shift'], key: 'o' } as Shortcut,
+  Pin: { modifiers: ['cmd', 'shift'], key: 'p' } as Shortcut,
+  Refresh: { modifiers: ['cmd'], key: 'r' } as Shortcut,
+  Remove: { modifiers: ['ctrl'], key: 'x' } as Shortcut,
+  RemoveAll: { modifiers: ['ctrl', 'shift'], key: 'x' } as Shortcut,
+  ToggleQuickLook: { modifiers: ['cmd'], key: 'y' } as Shortcut,
+} as const
+
+export const Keyboard = {
+  Shortcut: {
+    Common: CommonShortcuts,
+  },
+} as const
+
+export type { KeyEquivalent as KeyboardKeyEquivalent }
+export type { KeyModifier as KeyboardKeyModifier }
+export type { Shortcut as KeyboardShortcut }
+export type { CrossPlatformShortcut as KeyboardCrossPlatformShortcut }

package/src/release.tsx

@@ -66,6 +66,11 @@ export async function releaseExtension({
     if (error.message?.includes('already exists')) {
       throw error
     }
+    const stderr = error.stderr?.toString() || ''
+    const isNotFound = stderr.includes('release not found') || stderr.includes('Not Found')
+    if (!isNotFound) {
+      throw new Error(`Failed to check release status: ${stderr || error.message}`)
+    }
   }
 
   // Install dependencies for all platforms

package/src/utils/run-command.tsx

@@ -122,6 +122,16 @@ export async function runCommand(options: RunCommandOptions): Promise<void> {
     launchContext: undefined,
   }
 
+  // Menu bar commands are not supported in termcast
+  if (command.mode === 'menu-bar') {
+    await showToast({
+      style: Toast.Style.Failure,
+      title: 'Unsupported command type',
+      message: 'Menu bar commands are not supported',
+    })
+    return
+  }
+
   // Handle no-view commands (they export an async function, not a component)
   if (command.mode === 'no-view') {
     if (typeof CommandComponent === 'function') {