jestronaut 0.3.16 → 0.3.18

package/bin/jestronaut.js

@@ -1,5 +1,15 @@
 #!/usr/bin/env node
 
+// If stdout is not a TTY (CI, piped output, etc.), skip the TUI entirely
+// and let Jest run with its default reporter.
+if (!process.stdout.isTTY) {
+  const { run } = await import('jest');
+  // Override the reporter config so DashboardReporter is never instantiated
+  process.argv.push('--reporters=default');
+  await run();
+  process.exit();
+}
+
 // Intercept stdout/stderr before Jest loads anything so its early
 // output ("Determining test suites...") doesn't bleed into the TUI.
 const realStdout = process.stdout.write.bind(process.stdout);
@@ -68,16 +78,13 @@ global.__jestronaut_emit__ = realEmit;
 
 const _origEmit = process.stdin.emit;
 process.stdin.emit = function(event, ...args) {
-  if (event === 'data' && global.__jestronaut_block_jest_input__) return true;
+  if ((event === 'data' || event === 'keypress') && global.__jestronaut_block_jest_input__) return true;
   return _origEmit.apply(this, [event, ...args]);
 };
 
-// Global contract for watch mode:
-//   __jestronaut_ui__                    — { store, unmount } created once, reused across re-runs
-//   __jestronaut_block_jest_input__      — boolean; true when TUI holds input focus
-//   __jestronaut_jest_keypress__         — Jest's raw onKeypress listener (unwrapped)
-//   __jestronaut_emit__                  — original process.stdin.emit before any patching
+global.__jestronaut_update_config_and_run__ = null;
 
 // Forward all CLI args so flags like --testPathPattern, --watch etc. still work
 const { run } = await import('jest');
+
 run();

package/lib/JestronautWatchPlugin.js

@@ -0,0 +1,22 @@
+/**
+ * Jest watch plugin that intercepts updateConfigAndRun from Jest's watch loop.
+ * Activated by sending a null byte (\x00) via stdin — never triggered by real user input.
+ * Once activated, calls updateConfigAndRun with the desired config and resolves immediately.
+ */
+export default class JestronautWatchPlugin {
+  getUsageInfo() {
+    return { key: '\x00', prompt: '' };
+  }
+
+  onKey() {}
+
+  run(_globalConfig, updateConfigAndRun) {
+    global.__jestronaut_update_config_and_run__ = updateConfigAndRun;
+    const opts = global.__jestronaut_run_opts__;
+    global.__jestronaut_run_opts__ = null;
+    if (opts) {
+      updateConfigAndRun(opts);
+    }
+    return Promise.resolve(false);
+  }
+}

package/lib/reporter.js

@@ -88,6 +88,14 @@ export default class DashboardReporter {
   }
 
   onRunComplete(_, results) {
+    // Bootstrap: send null byte to activate our watch plugin and capture updateConfigAndRun
+    if (!global.__jestronaut_update_config_and_run__ && global.__jestronaut_emit__) {
+      setTimeout(() => {
+        global.__jestronaut_block_jest_input__ = false;
+        global.__jestronaut_emit__('data', '\x00');
+        global.__jestronaut_block_jest_input__ = true;
+      }, 500);
+    }
     const s = this._state;
     s.runComplete = true;
     s.runOk = results.numFailedTests === 0;

package/lib/ui/components/Dashboard.js

@@ -1,4 +1,4 @@
-import React, { useState, useEffect, useReducer } from 'react';
+import React, { useState, useEffect, useReducer, useRef } from 'react';
 import { Box, useInput, useApp, useStdout } from 'ink';
 import { SPINNER } from '../../constants.js';
 import { Header } from './Header.js';
@@ -9,6 +9,7 @@ import { SuitesList } from './SuitesList.js';
 import { Footer } from './Footer.js';
 import { SuiteDetailOverlay, buildSuiteDetailItems, moveCursor as moveSuiteDetailCursor } from './SuiteDetailOverlay.js';
 import { TestDetailOverlay, buildLines as buildTestDetailLines } from './TestDetailOverlay.js';
+import { HelpOverlay } from './HelpOverlay.js';
 
 const FIXED_ROWS = 2 + 2 + 2 + 3; // header + stats + progress + footer
 
@@ -16,6 +17,9 @@ export function Dashboard({ store }) {
   const { exit } = useApp();
   const { stdout } = useStdout();
   const [dims, setDims] = useState({ columns: stdout.columns || 80, rows: stdout.rows || 24 });
+  const [helpOpen, setHelpOpen] = useState(false);
+  const helpOpenRef = useRef(false);
+  const jestOnlyFailuresRef = useRef(false); // mirrors Jest's internal onlyFailures toggle state
   const [, forceUpdate] = useReducer(x => x + 1, 0);
 
   useEffect(() => {
@@ -27,8 +31,9 @@ export function Dashboard({ store }) {
   const { columns, rows } = dims;
 
   useEffect(() => {
-    store.on('update', forceUpdate);
-    return () => store.off('update', forceUpdate);
+    const onUpdate = () => { if (!helpOpenRef.current) forceUpdate(); };
+    store.on('update', onUpdate);
+    return () => store.off('update', onUpdate);
   }, [store]);
 
   useEffect(() => {
@@ -56,10 +61,50 @@ export function Dashboard({ store }) {
     }
 
     if (input === 'a' && s.watchWaiting) {
-      // Briefly unblock, forward 'a' to Jest's watch listener, then re-block
-      global.__jestronaut_block_jest_input__ = false;
-      if (global.__jestronaut_emit__) global.__jestronaut_emit__('data', 'a');
-      global.__jestronaut_block_jest_input__ = true;
+      jestOnlyFailuresRef.current = false;
+      if (global.__jestronaut_update_config_and_run__) {
+        // Call updateConfigAndRun directly — no key simulation, no intermediate run
+        global.__jestronaut_update_config_and_run__({
+          mode: 'watchAll',
+          onlyFailures: false,
+          testNamePattern: '',
+          testPathPatterns: [],
+        });
+      } else {
+        // Fallback: simulate 'a' key
+        global.__jestronaut_block_jest_input__ = false;
+        if (global.__jestronaut_emit__) global.__jestronaut_emit__('data', 'a');
+        global.__jestronaut_block_jest_input__ = true;
+      }
+      return;
+    }
+
+    if (input === 'r' && s.watchWaiting && s.stats.failed > 0) {
+      jestOnlyFailuresRef.current = true;
+      if (global.__jestronaut_update_config_and_run__) {
+        global.__jestronaut_update_config_and_run__({ onlyFailures: true });
+      } else {
+        global.__jestronaut_block_jest_input__ = false;
+        if (global.__jestronaut_emit__) global.__jestronaut_emit__('data', 'f');
+        global.__jestronaut_block_jest_input__ = true;
+      }
+      return;
+    }
+
+
+    if (input === '?') {
+      setHelpOpen(prev => {
+        helpOpenRef.current = !prev;
+        return !prev;
+      });
+      return;
+    }
+
+    if (helpOpen) {
+      if (key.escape) {
+        helpOpenRef.current = false;
+        setHelpOpen(false);
+      }
       return;
     }
 
@@ -153,6 +198,9 @@ export function Dashboard({ store }) {
     }
   });
 
+  if (helpOpen) {
+    return React.createElement(HelpOverlay, { rows, columns });
+  }
   if (state.testDetailOpen) {
     return React.createElement(TestDetailOverlay, { state, rows });
   }
@@ -174,6 +222,6 @@ export function Dashboard({ store }) {
       React.createElement(Box, { width: '65%' }, React.createElement(ResultsList, { state, height: listHeight })),
       React.createElement(Box, { width: '35%' }, React.createElement(SuitesList,  { state, height: listHeight }))
     ),
-    React.createElement(Footer, { state })
+    React.createElement(Footer, { state, width: columns })
   );
 }

package/lib/ui/components/Footer.js

@@ -2,7 +2,7 @@ import React from 'react';
 import { Box, Text } from 'ink';
 import { SPINNER } from '../../constants.js';
 
-export function Footer({ state }) {
+export function Footer({ state, width }) {
   const { stats, testDetailOpen, suiteDetailOpen, watchWaiting, spinFrame, suites } = state;
   const elapsed = stats.startTime
     ? (((stats.endTime || Date.now()) - stats.startTime) / 1000).toFixed(1) + 's'
@@ -13,20 +13,27 @@ export function Footer({ state }) {
   let hint;
   if (testDetailOpen)       hint = '[Esc] close   [j/k] scroll';
   else if (suiteDetailOpen) hint = '[j/k] navigate failed   [Enter] open failure   [Esc] back';
-  else if (watchWaiting)    hint = '[a] run all tests   [q] quit';
-  else                      hint = '[Tab] switch panel   [j/k] navigate   [Enter] open failure   [q] quit';
+  else if (watchWaiting)    hint = stats.failed > 0 ? '[a] run all   [r] re-run failed   [q] quit' : '[a] run all   [q] quit';
+  else                      hint = '[Tab] switch panel   [j/k] navigate   [Enter] open   [?] help   [q] quit';
 
   const statusText = runningCount > 0
     ? `${spin} Running ${runningCount} suite${runningCount > 1 ? 's' : ''}...`
     : `Elapsed: ${elapsed}`;
 
+  const totalWidth = width || 80;
+  const hintMaxWidth = Math.max(10, totalWidth - statusText.length - 6);
+
   return React.createElement(
     Box,
-    { height: 3, backgroundColor: '#111133', flexDirection: 'column', justifyContent: 'center', paddingLeft: 2 },
+    { height: 3, width: totalWidth, backgroundColor: '#111133', flexDirection: 'column', justifyContent: 'center', paddingLeft: 2 },
     React.createElement(
       Box,
-      { justifyContent: 'space-between' },
-      React.createElement(Text, { color: 'cyan' }, hint),
+      { width: totalWidth - 2 },
+      React.createElement(
+        Box,
+        { width: hintMaxWidth },
+        React.createElement(Text, { color: 'cyan', wrap: 'truncate' }, hint)
+      ),
       React.createElement(Text, { color: 'gray' }, statusText)
     )
   );

package/lib/ui/components/HelpOverlay.js

@@ -0,0 +1,51 @@
+import React from 'react';
+import { Box, Text } from 'ink';
+
+const SECTIONS = [
+  { heading: 'Navigation', keys: [
+    ['Tab',    'Switch focus between Results / Suites'],
+    ['j / ↓',  'Move cursor down'],
+    ['k / ↑',  'Move cursor up'],
+  ]},
+  { heading: 'Actions', keys: [
+    ['Enter',  'Open suite / test detail'],
+    ['Escape', 'Close overlay'],
+    ['?',      'Toggle this help overlay'],
+    ['q',      'Quit'],
+  ]},
+  { heading: 'Watch Mode', keys: [
+    ['a',      'Run all tests'],
+    ['r',      'Re-run failed tests only'],
+  ]},
+  { heading: 'Detail Overlay', keys: [
+    ['j / k',  'Navigate failed tests (suite detail)'],
+    ['j / k',  'Scroll content (test detail)'],
+  ]},
+];
+
+export function HelpOverlay({ rows, columns }) {
+  const width = Math.min(62, (columns || 80) - 4);
+
+  return React.createElement(
+    Box,
+    { height: rows || 24, width: columns || 80, justifyContent: 'center', alignItems: 'center' },
+    React.createElement(
+      Box,
+      { flexDirection: 'column', borderStyle: 'single', borderColor: 'cyan', width, paddingX: 2, paddingY: 1 },
+      React.createElement(Text, { bold: true, color: 'cyan' }, 'Keybindings'),
+      React.createElement(Box, { height: 1 }),
+      ...SECTIONS.flatMap(section => [
+        React.createElement(Text, { color: 'yellow', key: section.heading }, section.heading),
+        ...section.keys.map(([k, desc]) =>
+          React.createElement(
+            Box, { key: k },
+            React.createElement(Text, { color: 'white' }, `  ${k.padEnd(10)} `),
+            React.createElement(Text, { color: 'gray', wrap: 'truncate' }, desc)
+          )
+        ),
+        React.createElement(Box, { height: 1, key: `${section.heading}-spacer` }),
+      ]),
+      React.createElement(Text, { color: 'gray' }, '[?] or [Esc] to close'),
+    )
+  );
+}

package/package.json

@@ -1,9 +1,14 @@
 {
   "name": "jestronaut",
-  "version": "0.3.16",
+  "version": "0.3.18",
   "description": "An interactive terminal dashboard UI for Jest — navigate live test results, suites, and failure details without leaving your terminal",
   "type": "module",
   "main": "index.js",
+  "exports": {
+    ".": "./index.js",
+    "./watch-plugin": "./lib/JestronautWatchPlugin.js",
+    "./lib/*": "./lib/*"
+  },
   "bin": {
     "jestronaut": "./bin/jestronaut.js"
   },