termcast 1.3.33 → 1.3.35

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

@@ -38,9 +38,9 @@ test('grid navigation and display', async () => {
 
        > Search items...
 
-       Fruits                                                          ▲
-      ›🍎 Apple                                                        █
-       🍌 Banana                                                       █
+       Fruits
+      ›🍎 Apple
+       🍌 Banana
        🍒 Cherry
 
        Animals
@@ -51,7 +51,7 @@ test('grid navigation and display', async () => {
        Others
        🏠 House
        🚗 Car
-       🚀 Rocket                                                       ▼
+       🚀 Rocket
 
 
        ↵ show details   ↑↓ navigate   ^k actions
@@ -71,9 +71,9 @@ test('grid navigation and display', async () => {
 
        > Search items...
 
-       Fruits                                                          ▲
-       🍎 Apple                                                        █
-      ›🍌 Banana                                                       █
+       Fruits
+      ›🍎 Apple
+       🍌 Banana
        🍒 Cherry
 
        Animals
@@ -84,7 +84,7 @@ test('grid navigation and display', async () => {
        Others
        🏠 House
        🚗 Car
-       🚀 Rocket                                                       ▼
+       🚀 Rocket
 
 
        ↵ show details   ↑↓ navigate   ^k actions
@@ -105,9 +105,9 @@ test('grid navigation and display', async () => {
 
        > Search items...
 
-       Fruits                                                          ▲
-       🍎 Apple                                                        █
-       🍌 Banana                                                       █
+       Fruits
+       🍎 Apple
+       🍌 Banana
        🍒 Cherry
 
        Animals
@@ -118,7 +118,7 @@ test('grid navigation and display', async () => {
        Others
        🏠 House
        🚗 Car
-       🚀 Rocket                                                       ▼
+       🚀 Rocket
 
 
        ↵ show details   ↑↓ navigate   ^k actions
@@ -134,9 +134,9 @@ test('grid navigation and display', async () => {
     "
 
 
+       Simple Grid Example ────────────────────────────────────────────
 
-
-
+       > Search items...
 
       ╭────────────────────────────────────────────────────────────────╮
       │                                                                │
@@ -171,9 +171,9 @@ test('grid navigation and display', async () => {
 
        > Search items...
 
-       Fruits                                                          ▲
-       🍎 Apple                                                        █
-       🍌 Banana                                                       █
+       Fruits
+       🍎 Apple
+       🍌 Banana
        🍒 Cherry
 
        Animals
@@ -184,7 +184,7 @@ test('grid navigation and display', async () => {
        Others
        🏠 House
        🚗 Car
-       🚀 Rocket                                                       ▼
+       🚀 Rocket
 
 
        ↵ show details   ↑↓ navigate   ^k actions
@@ -294,9 +294,9 @@ test('grid search functionality', async () => {
 
        > Search items...
 
-       Fruits                                                          ▲
-      ›🍎 Apple                                                        █
-       🍌 Banana                                                       █
+       Fruits
+      ›🍎 Apple
+       🍌 Banana
        🍒 Cherry
 
        Animals
@@ -307,7 +307,7 @@ test('grid search functionality', async () => {
        Others
        🏠 House
        🚗 Car
-       🚀 Rocket                                                       ▼
+       🚀 Rocket
 
 
        ↵ show details   ↑↓ navigate   ^k actions
@@ -373,9 +373,9 @@ test('grid item selection and actions', async () => {
 
        > Search items...
 
-       Fruits                                                          ▲
-      ›🍎 Apple                                                        █
-       🍌 Banana                                                       █
+       Fruits
+      ›🍎 Apple
+       🍌 Banana
        🍒 Cherry
 
        Animals
@@ -386,7 +386,7 @@ test('grid item selection and actions', async () => {
        Others
        🏠 House
        🚗 Car
-       🚀 Rocket                                                       ▼
+       🚀 Rocket
 
 
        ↵ show details   ↑↓ navigate   ^k actions
@@ -406,9 +406,9 @@ test('grid item selection and actions', async () => {
 
        > Search items...
 
-       Fruits                                                          ▲
-       🍎 Apple                                                        █
-      ›🍌 Banana                                                       █
+       Fruits
+       🍎 Apple
+      ›🍌 Banana
        🍒 Cherry
 
        Animals
@@ -419,7 +419,7 @@ test('grid item selection and actions', async () => {
        Others
        🏠 House
        🚗 Car
-       🚀 Rocket                                                       ▼
+       🚀 Rocket
 
 
        ↵ show details   ↑↓ navigate   ^k actions
@@ -439,9 +439,9 @@ test('grid item selection and actions', async () => {
 
        > Search items...
 
-       Fruits                                                          ▲
-       🍎 Apple                                                        █
-      ›🍌 Banana                                                       █
+       Fruits
+       🍎 Apple
+      ›🍌 Banana
        🍒 Cherry
 
        Animals
@@ -452,7 +452,7 @@ test('grid item selection and actions', async () => {
        Others
        🏠 House
        🚗 Car
-       🚀 Rocket                                                       ▼
+       🚀 Rocket
 
 
        ↵ show details   ↑↓ navigate   ^k actions
@@ -481,9 +481,9 @@ test('grid mouse interaction', async () => {
 
        > Search items...
 
-       Fruits                                                          ▲
-       🍎 Apple                                                        █
-       🍌 Banana                                                       █
+       Fruits
+       🍎 Apple
+       🍌 Banana
        🍒 Cherry
 
        Animals
@@ -494,7 +494,7 @@ test('grid mouse interaction', async () => {
        Others
        🏠 House
        🚗 Car
-       🚀 Rocket                                                       ▼
+       🚀 Rocket
 
 
        ↵ show details   ↑↓ navigate   ^k actions
@@ -519,9 +519,9 @@ test('grid mouse interaction', async () => {
     "
 
 
+       Simple Grid Example ────────────────────────────────────────────
 
-
-
+       > Search items...
 
       ╭────────────────────────────────────────────────────────────────╮
       │                                                                │
@@ -567,9 +567,9 @@ test('grid mouse interaction', async () => {
 
        > Search items...
 
-       Fruits                                                          ▲
-      ›🍎 Apple                                                        █
-       🍌 Banana                                                       █
+       Fruits
+      ›🍎 Apple
+       🍌 Banana
        🍒 Cherry
 
        Animals
@@ -580,7 +580,7 @@ test('grid mouse interaction', async () => {
        Others
        🏠 House
        🚗 Car
-       🚀 Rocket                                                       ▼
+       🚀 Rocket
 
 
        ↵ show details   ↑↓ navigate   ^k actions

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

@@ -111,7 +111,7 @@ test('navigation between main and detail views', async () => {
        > Detail view - Press ESC to go back
 
        Details
-      ›This is the detail view for Second Item Press Enter to go back
+      ›This is the detail view for Second Item Press Enter to go back o
 
 
 
@@ -153,8 +153,8 @@ test('navigation between main and detail views', async () => {
        > Main view
 
        Items
-      ›First Item Navigate to first detail
-       Second Item Navigate to second detail
+       First Item Navigate to first detail
+      ›Second Item Navigate to second detail
        Third Item Navigate to third detail
 
 
@@ -187,9 +187,9 @@ test('navigation between main and detail views', async () => {
        > Main view
 
        Items
-       First Item Navigate to first detail
+      ›First Item Navigate to first detail
        Second Item Navigate to second detail
-      ›Third Item Navigate to third detail
+       Third Item Navigate to third detail
 
 
 
@@ -215,12 +215,12 @@ test('navigation between main and detail views', async () => {
     "
 
 
-       Detail: Third Item ─────────────────────────────────────────────
+       Detail: First Item ─────────────────────────────────────────────
 
        > Detail view - Press ESC to go back
 
        Details
-      ›This is the detail view for Third Item Press Enter to go back o
+      ›This is the detail view for First Item Press Enter to go back or
 
 
 
@@ -412,7 +412,7 @@ test('navigation with actions panel', async () => {
        > Detail view - Press ESC to go back
 
        Details
-      ›This is the detail view for Second Item Press Enter to go back
+      ›This is the detail view for Second Item Press Enter to go back o
 
 
 
@@ -482,8 +482,8 @@ test('navigation with actions panel', async () => {
        > Main view
 
        Items
-      ›First Item Navigate to first detail
-       Second Item Navigate to second detail
+       First Item Navigate to first detail
+      ›Second Item Navigate to second detail
        Third Item Navigate to third detail
 
 
@@ -606,7 +606,7 @@ test('search functionality in main and detail views', async () => {
        > Detail view - Press ESC to go back
 
        Details
-      ›This is the detail view for First Item Press Enter to go back o
+      ›This is the detail view for First Item Press Enter to go back or
 
 
 
@@ -644,7 +644,7 @@ test('search functionality in main and detail views', async () => {
 
 
 
-                               No items found
+                                No items found
 
 
 
@@ -700,3 +700,34 @@ test('search functionality in main and detail views', async () => {
     "
   `)
 }, 10000)
+
+test('keeps selected item after opening detail and pressing esc', async () => {
+  await session.text({
+    waitFor: (text) => {
+      return /Navigation Example/i.test(text) && /First Item/i.test(text)
+    },
+  })
+
+  await session.press('down')
+  const selectedSecondSnapshot = await session.text()
+  expect(selectedSecondSnapshot).toContain('›Second Item')
+
+  await session.press('enter')
+  await session.text({
+    waitFor: (text) => {
+      return /Detail: Second Item/i.test(text)
+    },
+    timeout: 3000,
+  })
+
+  await session.press('esc')
+  const backSnapshot = await session.text({
+    waitFor: (text) => {
+      return /Navigation Example/i.test(text)
+    },
+    timeout: 3000,
+  })
+
+  expect(backSnapshot).toContain('›Second Item')
+  expect(backSnapshot).not.toContain('›First Item')
+}, 10000)

package/src/examples/store.vitest.tsx

@@ -50,7 +50,7 @@ test('Store extension - searching for spiceblow shows Database', async () => {
 
        > spiceblow
 
-      ›Spiceblow - Sql Database Management Search, update, insert and delete row
+      ›Spiceblow - Sql Database Management Search, update, insert and delete rows
 
 
 

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

@@ -89,13 +89,14 @@ test.skipIf(isLinux)('swift extension dev mode shows command list', async () =>
        > 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
+      ›List Items Displays a simple list with some items           view
+       Swift List Displays a list of items returned by a Swift fun view
 
 
 
 
 
+       ↵ run command   ↑↓ navigate   ^k actions
 
 
 
@@ -104,7 +105,6 @@ test.skipIf(isLinux)('swift extension dev mode shows command list', async () =>
 
 
 
-       ↵ run command   ↑↓ navigate   ^k actions
 
     "
   `)

package/src/extensions/dev.vitest.tsx

@@ -1,11 +1,33 @@
 import { test, expect, afterEach, beforeEach } from 'vitest'
 import { launchTerminal, Session } from 'tuistory/src'
+import fs from 'node:fs'
 import path from 'node:path'
 
 let session: Session
 
 const fixtureDir = path.resolve(__dirname, '../../fixtures/simple-extension')
 
+async function waitForTextWithDebug({
+  session,
+  waitFor,
+  timeout,
+}: {
+  session: Session
+  waitFor: (text: string) => boolean
+  timeout: number
+}): Promise<string> {
+  try {
+    return await session.text({ waitFor, timeout })
+  } catch (error) {
+    const logPath = path.resolve(process.cwd(), 'app.log')
+    const appLog = fs.existsSync(logPath)
+      ? fs.readFileSync(logPath, 'utf-8').slice(-8000)
+      : 'app.log not found'
+    const message = error instanceof Error ? error.message : String(error)
+    throw new Error(`${message}\n\napp.log tail:\n${appLog}`)
+  }
+}
+
 beforeEach(async () => {
   session = await launchTerminal({
     command: 'bun',
@@ -20,7 +42,8 @@ afterEach(() => {
 })
 
 test('dev command shows extension commands list', async () => {
-  await session.text({
+  await waitForTextWithDebug({
+    session,
     waitFor: (text) => /Simple Test Extension/i.test(text),
     timeout: 10000,
   })
@@ -34,12 +57,12 @@ test('dev command shows extension commands list', async () => {
 
        > Search commands...
 
-       Commands                                              ▲
-      ›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
-       Show State Shows the current application state  view  ▼
+       Commands
+      ›List Items Displays a simple list with some items view
+       Search Items Search and filter through a list of  view
+       Google Oauth                                      view
+       usePromise Demo Shows how to use the usePromise h view
+       Show State Shows the current application state in view
 
 
        ↵ run command   ↑↓ navigate   ^k actions
@@ -48,7 +71,8 @@ test('dev command shows extension commands list', async () => {
 }, 30000)
 
 test('selecting command with arguments shows arguments form', async () => {
-  await session.text({
+  await waitForTextWithDebug({
+    session,
     waitFor: (text) => /Simple Test Extension/i.test(text),
     timeout: 10000,
   })
@@ -69,12 +93,12 @@ test('selecting command with arguments shows arguments form', async () => {
 
        > Search commands...
 
-       Google Oauth                                    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
-       Throw Error Command that throws an error at roo view  ▼
+       Google Oauth                                      view
+       usePromise Demo Shows how to use the usePromise h view
+       Show State Shows the current application state in view
+      ›With Arguments Demonstrates command arguments (te view
+       Quick Action Copies current timestamp to clipb no-view
+       Throw Error Command that throws an error at root  view
 
 
        ↵ run command   ↑↓ navigate   ^k actions
@@ -85,7 +109,8 @@ test('selecting command with arguments shows arguments form', async () => {
   await session.press('enter')
   await session.press('enter')
 
-  await session.text({
+  await waitForTextWithDebug({
+    session,
     waitFor: (text) => /Search query/i.test(text),
     timeout: 10000,
   })
@@ -113,7 +138,8 @@ test('selecting command with arguments shows arguments form', async () => {
 }, 30000)
 
 test('can fill arguments and run command', async () => {
-  await session.text({
+  await waitForTextWithDebug({
+    session,
     waitFor: (text) => /Simple Test Extension/i.test(text),
     timeout: 10000,
   })
@@ -127,7 +153,8 @@ test('can fill arguments and run command', async () => {
   await session.press('enter')
   await session.press('enter')
 
-  await session.text({
+  await waitForTextWithDebug({
+    session,
     waitFor: (text) => /Search query/i.test(text),
     timeout: 10000,
   })
@@ -161,7 +188,8 @@ test('can fill arguments and run command', async () => {
   await session.waitIdle()
   await session.press('enter')
 
-  await session.text({
+  await waitForTextWithDebug({
+    session,
     waitFor: (text) => /Received Arguments/i.test(text),
     timeout: 10000,
   })
@@ -176,9 +204,9 @@ test('can fill arguments and run command', async () => {
        > Search...
 
        Received Arguments
-      ›▼ Search Query (empty)
-       ▼ Secret Key (empty)
-       ▼ Category (empty)
+      ›𝐓 Search Query (empty)
+       𝐓 Secret Key (empty)
+       𝐓 Category (empty)
 
 
 
@@ -189,7 +217,8 @@ test('can fill arguments and run command', async () => {
 }, 30000)
 
 test('can run simple view command without arguments', async () => {
-  await session.text({
+  await waitForTextWithDebug({
+    session,
     waitFor: (text) => /Simple Test Extension/i.test(text),
     timeout: 10000,
   })
@@ -198,7 +227,8 @@ test('can run simple view command without arguments', async () => {
   await session.press('enter')
   await session.press('enter')
 
-  await session.text({
+  await waitForTextWithDebug({
+    session,
     waitFor: (text) => /First Item/i.test(text),
     timeout: 10000,
   })
@@ -212,12 +242,12 @@ 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
-       ▲ Fifth Item This is the fifth item                   ▼
+       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
+       ○ Fifth Item This is the fifth item
 
 
      ✓ Copied to Clipboard  First Item
@@ -247,7 +277,8 @@ test('hot reload updates TUI when source file changes', async () => {
 
   try {
     // Wait for the extension to load
-    await hotReloadSession.text({
+    await waitForTextWithDebug({
+      session: hotReloadSession,
       waitFor: (text) => /Hot Reload Test/i.test(text) && /Detail View/i.test(text),
       timeout: 5000,
     })
@@ -259,7 +290,8 @@ test('hot reload updates TUI when source file changes', async () => {
     await hotReloadSession.waitIdle()
 
     // Wait for the detail view to show
-    await hotReloadSession.text({
+    await waitForTextWithDebug({
+      session: hotReloadSession,
       waitFor: (text) => /MARKER_VALUE/i.test(text),
       timeout: 10000,
     })
@@ -311,7 +343,8 @@ test('hot reload with navigation - preserves navigation and updates content', as
 
   try {
     // Wait for the extension to load
-    await hotReloadSession.text({
+    await waitForTextWithDebug({
+      session: hotReloadSession,
       waitFor: (text) => /Hot Reload Test/i.test(text) && /List With Navigation/i.test(text),
       timeout: 10000,
     })
@@ -327,7 +360,8 @@ test('hot reload with navigation - preserves navigation and updates content', as
     await hotReloadSession.waitIdle()
 
     // Wait for the list to show OR the detail view (enter might auto-execute first action)
-    await hotReloadSession.text({
+    await waitForTextWithDebug({
+      session: hotReloadSession,
       waitFor: (text) => /Item One/i.test(text),
       timeout: 10000,
     })
@@ -341,7 +375,8 @@ test('hot reload with navigation - preserves navigation and updates content', as
       await hotReloadSession.waitIdle()
       
       // Wait for the detail view with the marker
-      await hotReloadSession.text({
+      await waitForTextWithDebug({
+        session: hotReloadSession,
         waitFor: (text) => /NAV_MARKER_VALUE/i.test(text) && /Item One Details/i.test(text),
         timeout: 10000,
       })

package/src/extensions/home.tsx

@@ -181,7 +181,7 @@ function ExtensionsList({
 
 export async function runHomeCommand(): Promise<void> {
   logger.log(`preparing to render the home command component`)
-  await renderWithProviders(<Home />)
+  await renderWithProviders(<Home />, { extensionName: 'termcast-home' })
   logger.log(`rendered home command component`)
 }
 

package/src/extensions/react-refresh-init.tsx

@@ -41,9 +41,10 @@ function initializeReactRefresh() {
 
 // Only load react-refresh in non-production
 if (process.env.NODE_ENV !== 'production') {
-  // Dynamic import to avoid bundling in production
-  RefreshRuntime = require('react-refresh/runtime')
-  initializeReactRefresh()
+  void import('react-refresh/runtime').then((runtime) => {
+    RefreshRuntime = runtime
+    initializeReactRefresh()
+  })
 }
 
 // Get captured renderer internals

package/src/index.tsx

@@ -224,6 +224,7 @@ export { TermcastProvider } from 'termcast/src/internal/providers'
 
 // Helper function for rendering examples
 export { renderWithProviders } from 'termcast/src/utils'
+export type { RenderWithProvidersOptions } from 'termcast/src/utils'
 
 // Window Management
 export { closeMainWindow, PopToRootType } from 'termcast/src/apis/window'