termcast 1.3.19 → 1.3.24

package/src/utils/run-command.tsx

@@ -1,4 +1,5 @@
 import React from 'react'
+import { cac } from 'cac'
 import { useStore } from 'termcast/src/state'
 import { showToast, Toast } from 'termcast/src/apis/toast'
 import { LocalStorage } from 'termcast/src/apis/localstorage'
@@ -6,6 +7,75 @@ import { CommandArguments } from 'termcast/src/components/command-arguments'
 import { ExtensionPreferences } from 'termcast/src/components/extension-preferences'
 import type { RaycastArgument, RaycastPackageJson } from 'termcast/src/package-json'
 import type { LaunchProps } from 'termcast/src/apis/environment'
+import { logger } from '../logger'
+
+export interface CommandInfo {
+  name: string
+  title: string
+  description?: string
+}
+
+export interface ParsedExtensionArgs {
+  commandName?: string
+  showHelp: boolean
+}
+
+/**
+ * Parse CLI args to extract command name and help flag.
+ * @param skipArgv - Number of subcommand args to skip (e.g. 1 for "dev" in "termcast dev")
+ */
+export function parseExtensionArgs({ skipArgv = 0 }: { skipArgv?: number } = {}): ParsedExtensionArgs {
+  // Build argv for cac: keep first 2 (binary + script), skip subcommand args, keep the rest
+  const argv = [
+    process.argv[0],
+    process.argv[1],
+    ...process.argv.slice(2 + skipArgv),
+  ]
+  const parsed = cac().parse(argv, { run: false })
+  return {
+    commandName: parsed.args[0] as string | undefined,
+    showHelp: Boolean(parsed.options.help || parsed.options.h),
+  }
+}
+
+function printExtensionHelp({
+  extensionName,
+  commands,
+}: {
+  extensionName: string
+  commands: CommandInfo[]
+}): void {
+  console.log(`\n${extensionName}\n`)
+  console.log('Usage: <binary> [command]\n')
+  console.log('Commands:')
+  for (const cmd of commands) {
+    const desc = cmd.description ? `  ${cmd.description}` : ''
+    console.log(`  ${cmd.name.padEnd(20)} ${cmd.title}${desc}`)
+  }
+  console.log('\nOptions:')
+  console.log('  --help, -h          Show this help message')
+  console.log()
+}
+
+/**
+ * Check for --help flag and print help if found. Call before rendering.
+ * Exits process if help is shown.
+ */
+export function handleHelpFlag({
+  extensionName,
+  commands,
+  skipArgv = 0,
+}: {
+  extensionName: string
+  commands: CommandInfo[]
+  skipArgv?: number
+}): void {
+  const { showHelp } = parseExtensionArgs({ skipArgv })
+  if (showHelp) {
+    printExtensionHelp({ extensionName, commands })
+    process.exit(0)
+  }
+}
 
 export interface RunnableCommand {
   name: string
@@ -22,8 +92,6 @@ export interface RunCommandOptions {
   bundledPath?: string
   Component?: (props: LaunchProps) => any
   push: (element: React.ReactNode) => void
-  // For dev mode, adds cache busting query param
-  cacheBustParam?: string
 }
 
 export async function runCommand(options: RunCommandOptions): Promise<void> {
@@ -34,7 +102,6 @@ export async function runCommand(options: RunCommandOptions): Promise<void> {
     bundledPath,
     Component: BuiltInComponent,
     push,
-    cacheBustParam,
   } = options
 
   // Check if command has required preferences that are missing
@@ -92,9 +159,11 @@ export async function runCommand(options: RunCommandOptions): Promise<void> {
   if (BuiltInComponent) {
     CommandComponent = BuiltInComponent
   } else if (bundledPath) {
-    const importPath = cacheBustParam
-      ? `${bundledPath}?rebuild=${cacheBustParam}`
-      : bundledPath
+    const state = useStore.getState()
+    const devRebuildCount = state.devRebuildCount + 1
+    useStore.setState({ devRebuildCount })
+    const importPath = `${bundledPath}?rebuild=${devRebuildCount}`
+    // logger.log(`importing ${importPath}`)
     const module = await import(importPath)
     CommandComponent = module.default