spawn-term 3.1.3 → 3.1.4

package/dist/esm/components/App.js

@@ -8,6 +8,7 @@ import Divider from './Divider.js';
 import ErrorFooter from './ErrorFooter.js';
 import ExpandedOutput from './ExpandedOutput.js';
 import StatusBar from './StatusBar.js';
+const isMac = process.platform === 'darwin';
 function AppContent({ store }) {
     const { exit } = useApp();
     const { isRawModeSupported } = useStdin();
@@ -30,8 +31,10 @@ function AppContent({ store }) {
     const isInteractive = useSyncExternalStore(store.subscribe, store.getIsInteractive);
     // Calculate visible process count (reserve lines for header, divider, status bar, expanded output)
     // When a process is expanded, reserve space for the expanded output to prevent terminal scrolling
+    // In interactive mode without expansion, reserve space for potential list scroll hint
     const expandedHeight = expandedId ? EXPANDED_MAX_VISIBLE_LINES + 1 : 0; // +1 for scroll hint
-    const reservedLines = (header ? 2 : 0) + (showStatusBar ? 2 : 0) + expandedHeight;
+    const listHintHeight = mode === 'interactive' && !expandedId ? 1 : 0; // Reserve for list scroll hint
+    const reservedLines = (header ? 2 : 0) + (showStatusBar ? 2 : 0) + expandedHeight + listHintHeight;
     const visibleProcessCount = Math.max(1, terminalHeight - reservedLines);
     // Derived state (computed from processes which is already subscribed)
     const runningCount = store.getRunningCount();
@@ -60,6 +63,18 @@ function AppContent({ store }) {
         mode,
         store
     ]);
+    // Clamp viewport when collapsing to avoid empty space
+    // This runs after render with correct visibleProcessCount
+    useEffect(()=>{
+        if (mode === 'interactive' && !expandedId) {
+            store.clampListViewport(visibleProcessCount);
+        }
+    }, [
+        mode,
+        expandedId,
+        visibleProcessCount,
+        store
+    ]);
     // Keyboard handling (only active when raw mode is supported)
     useInput((input, key)=>{
         if (mode === 'normal') {
@@ -68,33 +83,45 @@ function AppContent({ store }) {
                 store.toggleErrorFooter();
             }
         } else if (mode === 'interactive') {
+            // Pre-calculate visible counts for expand/collapse transitions
+            const baseReserved = (header ? 2 : 0) + (showStatusBar ? 2 : 0);
+            const visibleWhenExpanded = Math.max(1, terminalHeight - baseReserved - EXPANDED_MAX_VISIBLE_LINES - 1);
+            const visibleWhenCollapsed = Math.max(1, terminalHeight - baseReserved - 1); // -1 for list hint
             if (input === 'q' || key.escape) {
                 if (expandedId) {
-                    store.collapse();
+                    store.collapse(visibleWhenCollapsed);
                 } else {
                     store.signalExit(()=>{});
                 }
             } else if (key.return) {
-                store.toggleExpand();
+                store.toggleExpand(visibleWhenExpanded, visibleWhenCollapsed);
             // Jump to top - Option+↑ (detected as meta), vim: g
             // Must check meta+arrow BEFORE plain arrow
             } else if (key.meta && key.upArrow || input === 'g') {
                 if (expandedId) {
                     store.scrollToTop();
+                } else {
+                    store.selectFirst(visibleProcessCount);
                 }
             // Jump to bottom - Option+↓ (detected as meta), vim: G
             } else if (key.meta && key.downArrow || input === 'G') {
                 if (expandedId) {
                     store.scrollToBottom(EXPANDED_MAX_VISIBLE_LINES);
+                } else {
+                    store.selectLast(visibleProcessCount);
                 }
-            // Page scrolling - Tab/Shift+Tab
+            // Page scrolling - Tab/Shift+Tab (use same page size as expanded view)
             } else if (key.tab && key.shift) {
                 if (expandedId) {
                     store.scrollPageUp(EXPANDED_MAX_VISIBLE_LINES);
+                } else {
+                    store.selectPageUp(EXPANDED_MAX_VISIBLE_LINES, visibleProcessCount);
                 }
             } else if (key.tab && !key.shift) {
                 if (expandedId) {
                     store.scrollPageDown(EXPANDED_MAX_VISIBLE_LINES);
+                } else {
+                    store.selectPageDown(EXPANDED_MAX_VISIBLE_LINES, visibleProcessCount);
                 }
             // Line scrolling - arrows and vim j/k
             } else if (key.downArrow || input === 'j') {
@@ -142,24 +169,36 @@ function AppContent({ store }) {
                     /*#__PURE__*/ _jsx(Divider, {})
                 ]
             }),
-            /*#__PURE__*/ _jsx(Box, {
+            /*#__PURE__*/ _jsxs(Box, {
                 flexDirection: "column",
-                children: visibleProcesses.map((item)=>{
-                    const originalIndex = processes.indexOf(item);
-                    return /*#__PURE__*/ _jsxs(Box, {
-                        flexDirection: "column",
+                children: [
+                    visibleProcesses.map((item)=>{
+                        const originalIndex = processes.indexOf(item);
+                        return /*#__PURE__*/ _jsxs(Box, {
+                            flexDirection: "column",
+                            children: [
+                                /*#__PURE__*/ _jsx(CompactProcessLine, {
+                                    item: item,
+                                    isSelected: showSelection && originalIndex === selectedIndex
+                                }),
+                                expandedId === item.id && /*#__PURE__*/ _jsx(ExpandedOutput, {
+                                    lines: store.getProcessLines(item.id),
+                                    scrollOffset: scrollOffset
+                                })
+                            ]
+                        }, item.id);
+                    }),
+                    mode === 'interactive' && !expandedId && processes.length > visibleProcessCount && /*#__PURE__*/ _jsxs(Text, {
+                        dimColor: true,
                         children: [
-                            /*#__PURE__*/ _jsx(CompactProcessLine, {
-                                item: item,
-                                isSelected: showSelection && originalIndex === selectedIndex
-                            }),
-                            expandedId === item.id && /*#__PURE__*/ _jsx(ExpandedOutput, {
-                                lines: store.getProcessLines(item.id),
-                                scrollOffset: scrollOffset
-                            })
+                            "[+",
+                            processes.length - visibleProcessCount,
+                            " more, Tab/⇧Tab page, ",
+                            isMac ? '⌥↑/↓' : 'g/G',
+                            " top/bottom]"
                         ]
-                    }, item.id);
-                })
+                    })
+                ]
             }),
             showStatusBar && processes.length > 0 && /*#__PURE__*/ _jsxs(_Fragment, {
                 children: [

package/dist/esm/components/App.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/node/spawn-term/src/components/App.tsx"],"sourcesContent":["import { Box, Text, useApp, useInput, useStdin, useStdout } from 'ink';\nimport { useEffect, useMemo, useSyncExternalStore } from 'react';\nimport { EXPANDED_MAX_VISIBLE_LINES } from '../constants.ts';\nimport type { ProcessStore } from '../state/processStore.ts';\nimport { StoreContext } from '../state/StoreContext.ts';\nimport CompactProcessLine from './CompactProcessLine.ts';\nimport Divider from './Divider.ts';\nimport ErrorFooter from './ErrorFooter.ts';\nimport ExpandedOutput from './ExpandedOutput.ts';\nimport StatusBar from './StatusBar.ts';\n\ninterface AppProps {\n  store: ProcessStore;\n}\n\nfunction AppContent({ store }: AppProps): React.JSX.Element {\n  const { exit } = useApp();\n  const { isRawModeSupported } = useStdin();\n  const { stdout } = useStdout();\n  const terminalHeight = stdout?.rows || 24;\n\n  // Subscribe to store state\n  const processes = useSyncExternalStore(store.subscribe, store.getSnapshot);\n  const shouldExit = useSyncExternalStore(store.subscribe, store.getShouldExit);\n  const mode = useSyncExternalStore(store.subscribe, store.getMode);\n  const selectedIndex = useSyncExternalStore(store.subscribe, store.getSelectedIndex);\n  const expandedId = useSyncExternalStore(store.subscribe, store.getExpandedId);\n  const scrollOffset = useSyncExternalStore(store.subscribe, store.getScrollOffset);\n  const listScrollOffset = useSyncExternalStore(store.subscribe, store.getListScrollOffset);\n  const errorFooterExpanded = useSyncExternalStore(store.subscribe, store.getErrorFooterExpanded);\n  // Subscribe to buffer version to trigger re-renders when terminal buffer content changes\n  const _bufferVersion = useSyncExternalStore(store.subscribe, store.getBufferVersion);\n\n  // Subscribed state that triggers re-renders\n  const header = useSyncExternalStore(store.subscribe, store.getHeader);\n  const showStatusBar = useSyncExternalStore(store.subscribe, store.getShowStatusBar);\n  const isInteractive = useSyncExternalStore(store.subscribe, store.getIsInteractive);\n\n  // Calculate visible process count (reserve lines for header, divider, status bar, expanded output)\n  // When a process is expanded, reserve space for the expanded output to prevent terminal scrolling\n  const expandedHeight = expandedId ? EXPANDED_MAX_VISIBLE_LINES + 1 : 0; // +1 for scroll hint\n  const reservedLines = (header ? 2 : 0) + (showStatusBar ? 2 : 0) + expandedHeight;\n  const visibleProcessCount = Math.max(1, terminalHeight - reservedLines);\n\n  // Derived state (computed from processes which is already subscribed)\n  const runningCount = store.getRunningCount();\n  const doneCount = store.getDoneCount();\n  const errorCount = store.getErrorCount();\n  const errorLineCount = store.getErrorLineCount();\n  const _isAllComplete = store.isAllComplete();\n  const errorLines = store.getErrorLines();\n\n  // Handle exit signal\n  useEffect(() => {\n    if (shouldExit) {\n      exit();\n    }\n  }, [shouldExit, exit]);\n\n  // Auto-enter interactive mode immediately when interactive flag is set\n  // This allows selecting and viewing logs of running processes\n  useEffect(() => {\n    if (isInteractive && mode === 'normal') {\n      store.setMode('interactive');\n    }\n  }, [isInteractive, mode, store]);\n\n  // Keyboard handling (only active when raw mode is supported)\n  useInput(\n    (input, key) => {\n      if (mode === 'normal') {\n        // In non-interactive mode, 'e' toggles error footer\n        if (input === 'e' && errorCount > 0) {\n          store.toggleErrorFooter();\n        }\n      } else if (mode === 'interactive') {\n        if (input === 'q' || key.escape) {\n          if (expandedId) {\n            store.collapse();\n          } else {\n            store.signalExit(() => {});\n          }\n        } else if (key.return) {\n          store.toggleExpand();\n          // Jump to top - Option+↑ (detected as meta), vim: g\n          // Must check meta+arrow BEFORE plain arrow\n        } else if ((key.meta && key.upArrow) || input === 'g') {\n          if (expandedId) {\n            store.scrollToTop();\n          }\n          // Jump to bottom - Option+↓ (detected as meta), vim: G\n        } else if ((key.meta && key.downArrow) || input === 'G') {\n          if (expandedId) {\n            store.scrollToBottom(EXPANDED_MAX_VISIBLE_LINES);\n          }\n          // Page scrolling - Tab/Shift+Tab\n        } else if (key.tab && key.shift) {\n          if (expandedId) {\n            store.scrollPageUp(EXPANDED_MAX_VISIBLE_LINES);\n          }\n        } else if (key.tab && !key.shift) {\n          if (expandedId) {\n            store.scrollPageDown(EXPANDED_MAX_VISIBLE_LINES);\n          }\n          // Line scrolling - arrows and vim j/k\n        } else if (key.downArrow || input === 'j') {\n          if (expandedId) {\n            store.scrollDown(EXPANDED_MAX_VISIBLE_LINES);\n          } else {\n            store.selectNext(visibleProcessCount);\n          }\n        } else if (key.upArrow || input === 'k') {\n          if (expandedId) {\n            store.scrollUp();\n          } else {\n            store.selectPrev(visibleProcessCount);\n          }\n        }\n      }\n    },\n    { isActive: isRawModeSupported === true }\n  );\n\n  // Slice processes to visible viewport in interactive mode\n  const visibleProcesses = useMemo(() => {\n    if (mode === 'interactive') {\n      return processes.slice(listScrollOffset, listScrollOffset + visibleProcessCount);\n    }\n    return processes;\n  }, [processes, mode, listScrollOffset, visibleProcessCount]);\n\n  // Normal/Interactive view - render in original registration order\n  const showSelection = mode === 'interactive';\n\n  // Force full re-render when layout structure changes\n  // Note: scrollOffset is NOT included - scrolling within expansion doesn't change structure\n  const layoutKey = `${listScrollOffset}-${expandedId}-${errorCount}-${errorFooterExpanded}`;\n\n  return (\n    <Box key={layoutKey} flexDirection=\"column\">\n      {/* Header */}\n      {header && (\n        <>\n          <Text>{header}</Text>\n          <Divider />\n        </>\n      )}\n\n      {/* Visible processes */}\n      <Box flexDirection=\"column\">\n        {visibleProcesses.map((item) => {\n          const originalIndex = processes.indexOf(item);\n          return (\n            <Box key={item.id} flexDirection=\"column\">\n              <CompactProcessLine item={item} isSelected={showSelection && originalIndex === selectedIndex} />\n              {expandedId === item.id && <ExpandedOutput lines={store.getProcessLines(item.id)} scrollOffset={scrollOffset} />}\n            </Box>\n          );\n        })}\n      </Box>\n\n      {/* Status bar */}\n      {showStatusBar && processes.length > 0 && (\n        <>\n          <Divider />\n          <StatusBar running={runningCount} done={doneCount} errors={errorCount} errorLines={errorLineCount} />\n        </>\n      )}\n\n      {/* Error footer (non-interactive mode only) */}\n      {!isInteractive && errorCount > 0 && <ErrorFooter errors={errorLines} isExpanded={errorFooterExpanded} />}\n    </Box>\n  );\n}\n\n// Wrapper component that provides store context\nexport default function App({ store }: AppProps): React.JSX.Element {\n  return (\n    <StoreContext.Provider value={store}>\n      <AppContent store={store} />\n    </StoreContext.Provider>\n  );\n}\n"],"names":["Box","Text","useApp","useInput","useStdin","useStdout","useEffect","useMemo","useSyncExternalStore","EXPANDED_MAX_VISIBLE_LINES","StoreContext","CompactProcessLine","Divider","ErrorFooter","ExpandedOutput","StatusBar","AppContent","store","exit","isRawModeSupported","stdout","terminalHeight","rows","processes","subscribe","getSnapshot","shouldExit","getShouldExit","mode","getMode","selectedIndex","getSelectedIndex","expandedId","getExpandedId","scrollOffset","getScrollOffset","listScrollOffset","getListScrollOffset","errorFooterExpanded","getErrorFooterExpanded","_bufferVersion","getBufferVersion","header","getHeader","showStatusBar","getShowStatusBar","isInteractive","getIsInteractive","expandedHeight","reservedLines","visibleProcessCount","Math","max","runningCount","getRunningCount","doneCount","getDoneCount","errorCount","getErrorCount","errorLineCount","getErrorLineCount","_isAllComplete","isAllComplete","errorLines","getErrorLines","setMode","input","key","toggleErrorFooter","escape","collapse","signalExit","return","toggleExpand","meta","upArrow","scrollToTop","downArrow","scrollToBottom","tab","shift","scrollPageUp","scrollPageDown","scrollDown","selectNext","scrollUp","selectPrev","isActive","visibleProcesses","slice","showSelection","layoutKey","flexDirection","map","item","originalIndex","indexOf","isSelected","id","lines","getProcessLines","length","running","done","errors","isExpanded","App","Provider","value"],"mappings":"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"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/node/spawn-term/src/components/App.tsx"],"sourcesContent":["import { Box, Text, useApp, useInput, useStdin, useStdout } from 'ink';\nimport { useEffect, useMemo, useSyncExternalStore } from 'react';\nimport { EXPANDED_MAX_VISIBLE_LINES } from '../constants.ts';\nimport type { ProcessStore } from '../state/processStore.ts';\nimport { StoreContext } from '../state/StoreContext.ts';\nimport CompactProcessLine from './CompactProcessLine.ts';\nimport Divider from './Divider.ts';\nimport ErrorFooter from './ErrorFooter.ts';\nimport ExpandedOutput from './ExpandedOutput.ts';\nimport StatusBar from './StatusBar.ts';\n\nconst isMac = process.platform === 'darwin';\n\ninterface AppProps {\n  store: ProcessStore;\n}\n\nfunction AppContent({ store }: AppProps): React.JSX.Element {\n  const { exit } = useApp();\n  const { isRawModeSupported } = useStdin();\n  const { stdout } = useStdout();\n  const terminalHeight = stdout?.rows || 24;\n\n  // Subscribe to store state\n  const processes = useSyncExternalStore(store.subscribe, store.getSnapshot);\n  const shouldExit = useSyncExternalStore(store.subscribe, store.getShouldExit);\n  const mode = useSyncExternalStore(store.subscribe, store.getMode);\n  const selectedIndex = useSyncExternalStore(store.subscribe, store.getSelectedIndex);\n  const expandedId = useSyncExternalStore(store.subscribe, store.getExpandedId);\n  const scrollOffset = useSyncExternalStore(store.subscribe, store.getScrollOffset);\n  const listScrollOffset = useSyncExternalStore(store.subscribe, store.getListScrollOffset);\n  const errorFooterExpanded = useSyncExternalStore(store.subscribe, store.getErrorFooterExpanded);\n  // Subscribe to buffer version to trigger re-renders when terminal buffer content changes\n  const _bufferVersion = useSyncExternalStore(store.subscribe, store.getBufferVersion);\n\n  // Subscribed state that triggers re-renders\n  const header = useSyncExternalStore(store.subscribe, store.getHeader);\n  const showStatusBar = useSyncExternalStore(store.subscribe, store.getShowStatusBar);\n  const isInteractive = useSyncExternalStore(store.subscribe, store.getIsInteractive);\n\n  // Calculate visible process count (reserve lines for header, divider, status bar, expanded output)\n  // When a process is expanded, reserve space for the expanded output to prevent terminal scrolling\n  // In interactive mode without expansion, reserve space for potential list scroll hint\n  const expandedHeight = expandedId ? EXPANDED_MAX_VISIBLE_LINES + 1 : 0; // +1 for scroll hint\n  const listHintHeight = mode === 'interactive' && !expandedId ? 1 : 0; // Reserve for list scroll hint\n  const reservedLines = (header ? 2 : 0) + (showStatusBar ? 2 : 0) + expandedHeight + listHintHeight;\n  const visibleProcessCount = Math.max(1, terminalHeight - reservedLines);\n\n  // Derived state (computed from processes which is already subscribed)\n  const runningCount = store.getRunningCount();\n  const doneCount = store.getDoneCount();\n  const errorCount = store.getErrorCount();\n  const errorLineCount = store.getErrorLineCount();\n  const _isAllComplete = store.isAllComplete();\n  const errorLines = store.getErrorLines();\n\n  // Handle exit signal\n  useEffect(() => {\n    if (shouldExit) {\n      exit();\n    }\n  }, [shouldExit, exit]);\n\n  // Auto-enter interactive mode immediately when interactive flag is set\n  // This allows selecting and viewing logs of running processes\n  useEffect(() => {\n    if (isInteractive && mode === 'normal') {\n      store.setMode('interactive');\n    }\n  }, [isInteractive, mode, store]);\n\n  // Clamp viewport when collapsing to avoid empty space\n  // This runs after render with correct visibleProcessCount\n  useEffect(() => {\n    if (mode === 'interactive' && !expandedId) {\n      store.clampListViewport(visibleProcessCount);\n    }\n  }, [mode, expandedId, visibleProcessCount, store]);\n\n  // Keyboard handling (only active when raw mode is supported)\n  useInput(\n    (input, key) => {\n      if (mode === 'normal') {\n        // In non-interactive mode, 'e' toggles error footer\n        if (input === 'e' && errorCount > 0) {\n          store.toggleErrorFooter();\n        }\n      } else if (mode === 'interactive') {\n        // Pre-calculate visible counts for expand/collapse transitions\n        const baseReserved = (header ? 2 : 0) + (showStatusBar ? 2 : 0);\n        const visibleWhenExpanded = Math.max(1, terminalHeight - baseReserved - EXPANDED_MAX_VISIBLE_LINES - 1);\n        const visibleWhenCollapsed = Math.max(1, terminalHeight - baseReserved - 1); // -1 for list hint\n\n        if (input === 'q' || key.escape) {\n          if (expandedId) {\n            store.collapse(visibleWhenCollapsed);\n          } else {\n            store.signalExit(() => {});\n          }\n        } else if (key.return) {\n          store.toggleExpand(visibleWhenExpanded, visibleWhenCollapsed);\n          // Jump to top - Option+↑ (detected as meta), vim: g\n          // Must check meta+arrow BEFORE plain arrow\n        } else if ((key.meta && key.upArrow) || input === 'g') {\n          if (expandedId) {\n            store.scrollToTop();\n          } else {\n            store.selectFirst(visibleProcessCount);\n          }\n          // Jump to bottom - Option+↓ (detected as meta), vim: G\n        } else if ((key.meta && key.downArrow) || input === 'G') {\n          if (expandedId) {\n            store.scrollToBottom(EXPANDED_MAX_VISIBLE_LINES);\n          } else {\n            store.selectLast(visibleProcessCount);\n          }\n          // Page scrolling - Tab/Shift+Tab (use same page size as expanded view)\n        } else if (key.tab && key.shift) {\n          if (expandedId) {\n            store.scrollPageUp(EXPANDED_MAX_VISIBLE_LINES);\n          } else {\n            store.selectPageUp(EXPANDED_MAX_VISIBLE_LINES, visibleProcessCount);\n          }\n        } else if (key.tab && !key.shift) {\n          if (expandedId) {\n            store.scrollPageDown(EXPANDED_MAX_VISIBLE_LINES);\n          } else {\n            store.selectPageDown(EXPANDED_MAX_VISIBLE_LINES, visibleProcessCount);\n          }\n          // Line scrolling - arrows and vim j/k\n        } else if (key.downArrow || input === 'j') {\n          if (expandedId) {\n            store.scrollDown(EXPANDED_MAX_VISIBLE_LINES);\n          } else {\n            store.selectNext(visibleProcessCount);\n          }\n        } else if (key.upArrow || input === 'k') {\n          if (expandedId) {\n            store.scrollUp();\n          } else {\n            store.selectPrev(visibleProcessCount);\n          }\n        }\n      }\n    },\n    { isActive: isRawModeSupported === true }\n  );\n\n  // Slice processes to visible viewport in interactive mode\n  const visibleProcesses = useMemo(() => {\n    if (mode === 'interactive') {\n      return processes.slice(listScrollOffset, listScrollOffset + visibleProcessCount);\n    }\n    return processes;\n  }, [processes, mode, listScrollOffset, visibleProcessCount]);\n\n  // Normal/Interactive view - render in original registration order\n  const showSelection = mode === 'interactive';\n\n  // Force full re-render when layout structure changes\n  // Note: scrollOffset is NOT included - scrolling within expansion doesn't change structure\n  const layoutKey = `${listScrollOffset}-${expandedId}-${errorCount}-${errorFooterExpanded}`;\n\n  return (\n    <Box key={layoutKey} flexDirection=\"column\">\n      {/* Header */}\n      {header && (\n        <>\n          <Text>{header}</Text>\n          <Divider />\n        </>\n      )}\n\n      {/* Visible processes */}\n      <Box flexDirection=\"column\">\n        {visibleProcesses.map((item) => {\n          const originalIndex = processes.indexOf(item);\n          return (\n            <Box key={item.id} flexDirection=\"column\">\n              <CompactProcessLine item={item} isSelected={showSelection && originalIndex === selectedIndex} />\n              {expandedId === item.id && <ExpandedOutput lines={store.getProcessLines(item.id)} scrollOffset={scrollOffset} />}\n            </Box>\n          );\n        })}\n        {/* List scroll hint (interactive mode without expansion) */}\n        {mode === 'interactive' && !expandedId && processes.length > visibleProcessCount && (\n          <Text dimColor>\n            [+{processes.length - visibleProcessCount} more, Tab/⇧Tab page, {isMac ? '⌥↑/↓' : 'g/G'} top/bottom]\n          </Text>\n        )}\n      </Box>\n\n      {/* Status bar */}\n      {showStatusBar && processes.length > 0 && (\n        <>\n          <Divider />\n          <StatusBar running={runningCount} done={doneCount} errors={errorCount} errorLines={errorLineCount} />\n        </>\n      )}\n\n      {/* Error footer (non-interactive mode only) */}\n      {!isInteractive && errorCount > 0 && <ErrorFooter errors={errorLines} isExpanded={errorFooterExpanded} />}\n    </Box>\n  );\n}\n\n// Wrapper component that provides store context\nexport default function App({ store }: AppProps): React.JSX.Element {\n  return (\n    <StoreContext.Provider value={store}>\n      <AppContent store={store} />\n    </StoreContext.Provider>\n  );\n}\n"],"names":["Box","Text","useApp","useInput","useStdin","useStdout","useEffect","useMemo","useSyncExternalStore","EXPANDED_MAX_VISIBLE_LINES","StoreContext","CompactProcessLine","Divider","ErrorFooter","ExpandedOutput","StatusBar","isMac","process","platform","AppContent","store","exit","isRawModeSupported","stdout","terminalHeight","rows","processes","subscribe","getSnapshot","shouldExit","getShouldExit","mode","getMode","selectedIndex","getSelectedIndex","expandedId","getExpandedId","scrollOffset","getScrollOffset","listScrollOffset","getListScrollOffset","errorFooterExpanded","getErrorFooterExpanded","_bufferVersion","getBufferVersion","header","getHeader","showStatusBar","getShowStatusBar","isInteractive","getIsInteractive","expandedHeight","listHintHeight","reservedLines","visibleProcessCount","Math","max","runningCount","getRunningCount","doneCount","getDoneCount","errorCount","getErrorCount","errorLineCount","getErrorLineCount","_isAllComplete","isAllComplete","errorLines","getErrorLines","setMode","clampListViewport","input","key","toggleErrorFooter","baseReserved","visibleWhenExpanded","visibleWhenCollapsed","escape","collapse","signalExit","return","toggleExpand","meta","upArrow","scrollToTop","selectFirst","downArrow","scrollToBottom","selectLast","tab","shift","scrollPageUp","selectPageUp","scrollPageDown","selectPageDown","scrollDown","selectNext","scrollUp","selectPrev","isActive","visibleProcesses","slice","showSelection","layoutKey","flexDirection","map","item","originalIndex","indexOf","isSelected","id","lines","getProcessLines","length","dimColor","running","done","errors","isExpanded","App","Provider","value"],"mappings":"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"}

package/dist/esm/components/ErrorFooter.js

@@ -23,11 +23,7 @@ export default /*#__PURE__*/ memo(function ErrorFooter({ errors, isExpanded }) {
                             color: "red",
                             children: '\u25b8'
                         }),
-                        ` ${summary} `,
-                        /*#__PURE__*/ _jsx(Text, {
-                            dimColor: true,
-                            children: "[e]"
-                        })
+                        ` ${summary}`
                     ]
                 })
             ]
@@ -43,11 +39,7 @@ export default /*#__PURE__*/ memo(function ErrorFooter({ errors, isExpanded }) {
                         color: "red",
                         children: '\u25be'
                     }),
-                    ' Errors ',
-                    /*#__PURE__*/ _jsx(Text, {
-                        dimColor: true,
-                        children: "[e]"
-                    })
+                    ' Errors'
                 ]
             }),
             /*#__PURE__*/ _jsx(Box, {

package/dist/esm/components/ErrorFooter.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/node/spawn-term/src/components/ErrorFooter.tsx"],"sourcesContent":["import { Box, Text } from 'ink';\nimport { memo } from 'react';\nimport type { Line } from '../types.ts';\nimport { LineType } from '../types.ts';\nimport Divider from './Divider.ts';\n\ntype ErrorGroup = {\n  processName: string;\n  lines: Line[];\n};\n\ntype Props = {\n  errors: ErrorGroup[];\n  isExpanded: boolean;\n};\n\nexport default memo(function ErrorFooter({ errors, isExpanded }: Props) {\n  // Calculate totals for collapsed summary\n  const totalLines = errors.reduce((sum, e) => sum + e.lines.filter((l) => l.type === LineType.stderr).length, 0);\n  const totalProcesses = errors.length;\n\n  if (totalProcesses === 0) {\n    return null;\n  }\n\n  const processText = totalProcesses === 1 ? 'process' : 'processes';\n\n  if (!isExpanded) {\n    // Collapsed view - single summary line\n    const summary = totalLines > 0 ? `${totalLines} error line${totalLines === 1 ? '' : 's'} in ${totalProcesses} ${processText}` : `${totalProcesses} failed ${processText}`;\n    return (\n      <>\n        <Divider />\n        <Text>\n          <Text color=\"red\">{'\\u25b8'}</Text>\n          {` ${summary} `}\n          <Text dimColor>[e]</Text>\n        </Text>\n      </>\n    );\n  }\n\n  // Expanded view - show all error lines (or just process names if no stderr)\n  return (\n    <>\n      <Divider />\n      <Text>\n        <Text color=\"red\">{'\\u25be'}</Text>\n        {' Errors '}\n        <Text dimColor>[e]</Text>\n      </Text>\n      <Box flexDirection=\"column\">\n        {errors.map((errorGroup) => {\n          const stderrLines = errorGroup.lines.filter((line) => line.type === LineType.stderr);\n          if (stderrLines.length === 0) {\n            // No stderr output - just show process name\n            return (\n              <Text key={errorGroup.processName}>\n                <Text dimColor>[{errorGroup.processName}]</Text> <Text color=\"red\">(failed)</Text>\n              </Text>\n            );\n          }\n          return stderrLines.map((line, index) => (\n            <Text key={`${errorGroup.processName}-${index}`}>\n              <Text dimColor>[{errorGroup.processName}]</Text> {line.text}\n            </Text>\n          ));\n        })}\n      </Box>\n    </>\n  );\n});\n"],"names":["Box","Text","memo","LineType","Divider","ErrorFooter","errors","isExpanded","totalLines","reduce","sum","e","lines","filter","l","type","stderr","length","totalProcesses","processText","summary","color","dimColor","flexDirection","map","errorGroup","stderrLines","line","processName","index","text"],"mappings":";AAAA,SAASA,GAAG,EAAEC,IAAI,QAAQ,MAAM;AAChC,SAASC,IAAI,QAAQ,QAAQ;AAE7B,SAASC,QAAQ,QAAQ,cAAc;AACvC,OAAOC,aAAa,eAAe;AAYnC,6BAAeF,KAAK,SAASG,YAAY,EAAEC,MAAM,EAAEC,UAAU,EAAS;IACpE,yCAAyC;IACzC,MAAMC,aAAaF,OAAOG,MAAM,CAAC,CAACC,KAAKC,IAAMD,MAAMC,EAAEC,KAAK,CAACC,MAAM,CAAC,CAACC,IAAMA,EAAEC,IAAI,KAAKZ,SAASa,MAAM,EAAEC,MAAM,EAAE;IAC7G,MAAMC,iBAAiBZ,OAAOW,MAAM;IAEpC,IAAIC,mBAAmB,GAAG;QACxB,OAAO;IACT;IAEA,MAAMC,cAAcD,mBAAmB,IAAI,YAAY;IAEvD,IAAI,CAACX,YAAY;QACf,uCAAuC;QACvC,MAAMa,UAAUZ,aAAa,IAAI,GAAGA,WAAW,WAAW,EAAEA,eAAe,IAAI,KAAK,IAAI,IAAI,EAAEU,eAAe,CAAC,EAAEC,aAAa,GAAG,GAAGD,eAAe,QAAQ,EAAEC,aAAa;QACzK,qBACE;;8BACE,KAACf;8BACD,MAACH;;sCACC,KAACA;4BAAKoB,OAAM;sCAAO;;wBAClB,CAAC,CAAC,EAAED,QAAQ,CAAC,CAAC;sCACf,KAACnB;4BAAKqB,QAAQ;sCAAC;;;;;;IAIvB;IAEA,4EAA4E;IAC5E,qBACE;;0BACE,KAAClB;0BACD,MAACH;;kCACC,KAACA;wBAAKoB,OAAM;kCAAO;;oBAClB;kCACD,KAACpB;wBAAKqB,QAAQ;kCAAC;;;;0BAEjB,KAACtB;gBAAIuB,eAAc;0BAChBjB,OAAOkB,GAAG,CAAC,CAACC;oBACX,MAAMC,cAAcD,WAAWb,KAAK,CAACC,MAAM,CAAC,CAACc,OAASA,KAAKZ,IAAI,KAAKZ,SAASa,MAAM;oBACnF,IAAIU,YAAYT,MAAM,KAAK,GAAG;wBAC5B,4CAA4C;wBAC5C,qBACE,MAAChB;;8CACC,MAACA;oCAAKqB,QAAQ;;wCAAC;wCAAEG,WAAWG,WAAW;wCAAC;;;gCAAQ;8CAAC,KAAC3B;oCAAKoB,OAAM;8CAAM;;;2BAD1DI,WAAWG,WAAW;oBAIrC;oBACA,OAAOF,YAAYF,GAAG,CAAC,CAACG,MAAME,sBAC5B,MAAC5B;;8CACC,MAACA;oCAAKqB,QAAQ;;wCAAC;wCAAEG,WAAWG,WAAW;wCAAC;;;gCAAQ;gCAAED,KAAKG,IAAI;;2BADlD,GAAGL,WAAWG,WAAW,CAAC,CAAC,EAAEC,OAAO;gBAInD;;;;AAIR,GAAG"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/node/spawn-term/src/components/ErrorFooter.tsx"],"sourcesContent":["import { Box, Text } from 'ink';\nimport { memo } from 'react';\nimport type { Line } from '../types.ts';\nimport { LineType } from '../types.ts';\nimport Divider from './Divider.ts';\n\ntype ErrorGroup = {\n  processName: string;\n  lines: Line[];\n};\n\ntype Props = {\n  errors: ErrorGroup[];\n  isExpanded: boolean;\n};\n\nexport default memo(function ErrorFooter({ errors, isExpanded }: Props) {\n  // Calculate totals for collapsed summary\n  const totalLines = errors.reduce((sum, e) => sum + e.lines.filter((l) => l.type === LineType.stderr).length, 0);\n  const totalProcesses = errors.length;\n\n  if (totalProcesses === 0) {\n    return null;\n  }\n\n  const processText = totalProcesses === 1 ? 'process' : 'processes';\n\n  if (!isExpanded) {\n    // Collapsed view - single summary line\n    const summary = totalLines > 0 ? `${totalLines} error line${totalLines === 1 ? '' : 's'} in ${totalProcesses} ${processText}` : `${totalProcesses} failed ${processText}`;\n    return (\n      <>\n        <Divider />\n        <Text>\n          <Text color=\"red\">{'\\u25b8'}</Text>\n          {` ${summary}`}\n        </Text>\n      </>\n    );\n  }\n\n  // Expanded view - show all error lines (or just process names if no stderr)\n  return (\n    <>\n      <Divider />\n      <Text>\n        <Text color=\"red\">{'\\u25be'}</Text>\n        {' Errors'}\n      </Text>\n      <Box flexDirection=\"column\">\n        {errors.map((errorGroup) => {\n          const stderrLines = errorGroup.lines.filter((line) => line.type === LineType.stderr);\n          if (stderrLines.length === 0) {\n            // No stderr output - just show process name\n            return (\n              <Text key={errorGroup.processName}>\n                <Text dimColor>[{errorGroup.processName}]</Text> <Text color=\"red\">(failed)</Text>\n              </Text>\n            );\n          }\n          return stderrLines.map((line, index) => (\n            <Text key={`${errorGroup.processName}-${index}`}>\n              <Text dimColor>[{errorGroup.processName}]</Text> {line.text}\n            </Text>\n          ));\n        })}\n      </Box>\n    </>\n  );\n});\n"],"names":["Box","Text","memo","LineType","Divider","ErrorFooter","errors","isExpanded","totalLines","reduce","sum","e","lines","filter","l","type","stderr","length","totalProcesses","processText","summary","color","flexDirection","map","errorGroup","stderrLines","line","dimColor","processName","index","text"],"mappings":";AAAA,SAASA,GAAG,EAAEC,IAAI,QAAQ,MAAM;AAChC,SAASC,IAAI,QAAQ,QAAQ;AAE7B,SAASC,QAAQ,QAAQ,cAAc;AACvC,OAAOC,aAAa,eAAe;AAYnC,6BAAeF,KAAK,SAASG,YAAY,EAAEC,MAAM,EAAEC,UAAU,EAAS;IACpE,yCAAyC;IACzC,MAAMC,aAAaF,OAAOG,MAAM,CAAC,CAACC,KAAKC,IAAMD,MAAMC,EAAEC,KAAK,CAACC,MAAM,CAAC,CAACC,IAAMA,EAAEC,IAAI,KAAKZ,SAASa,MAAM,EAAEC,MAAM,EAAE;IAC7G,MAAMC,iBAAiBZ,OAAOW,MAAM;IAEpC,IAAIC,mBAAmB,GAAG;QACxB,OAAO;IACT;IAEA,MAAMC,cAAcD,mBAAmB,IAAI,YAAY;IAEvD,IAAI,CAACX,YAAY;QACf,uCAAuC;QACvC,MAAMa,UAAUZ,aAAa,IAAI,GAAGA,WAAW,WAAW,EAAEA,eAAe,IAAI,KAAK,IAAI,IAAI,EAAEU,eAAe,CAAC,EAAEC,aAAa,GAAG,GAAGD,eAAe,QAAQ,EAAEC,aAAa;QACzK,qBACE;;8BACE,KAACf;8BACD,MAACH;;sCACC,KAACA;4BAAKoB,OAAM;sCAAO;;wBAClB,CAAC,CAAC,EAAED,SAAS;;;;;IAItB;IAEA,4EAA4E;IAC5E,qBACE;;0BACE,KAAChB;0BACD,MAACH;;kCACC,KAACA;wBAAKoB,OAAM;kCAAO;;oBAClB;;;0BAEH,KAACrB;gBAAIsB,eAAc;0BAChBhB,OAAOiB,GAAG,CAAC,CAACC;oBACX,MAAMC,cAAcD,WAAWZ,KAAK,CAACC,MAAM,CAAC,CAACa,OAASA,KAAKX,IAAI,KAAKZ,SAASa,MAAM;oBACnF,IAAIS,YAAYR,MAAM,KAAK,GAAG;wBAC5B,4CAA4C;wBAC5C,qBACE,MAAChB;;8CACC,MAACA;oCAAK0B,QAAQ;;wCAAC;wCAAEH,WAAWI,WAAW;wCAAC;;;gCAAQ;8CAAC,KAAC3B;oCAAKoB,OAAM;8CAAM;;;2BAD1DG,WAAWI,WAAW;oBAIrC;oBACA,OAAOH,YAAYF,GAAG,CAAC,CAACG,MAAMG,sBAC5B,MAAC5B;;8CACC,MAACA;oCAAK0B,QAAQ;;wCAAC;wCAAEH,WAAWI,WAAW;wCAAC;;;gCAAQ;gCAAEF,KAAKI,IAAI;;2BADlD,GAAGN,WAAWI,WAAW,CAAC,CAAC,EAAEC,OAAO;gBAInD;;;;AAIR,GAAG"}

package/dist/esm/index-cjs.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/node/spawn-term/src/index-cjs.ts"],"sourcesContent":["export { default as figures } from './lib/figures.ts';\nexport { default as formatArguments } from './lib/formatArguments.ts';\nexport * from './types.ts';\n\nimport type { createSession as createSessionType, Session } from './session.ts';\nexport type { Session };\nexport const createSession = undefined as typeof createSessionType;\n"],"names":["default","figures","formatArguments","createSession","undefined"],"mappings":"AAAA,SAASA,WAAWC,OAAO,QAAQ,mBAAmB;AACtD,SAASD,WAAWE,eAAe,QAAQ,2BAA2B;AACtE,cAAc,aAAa;AAI3B,OAAO,MAAMC,gBAAgBC,UAAsC"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/node/spawn-term/src/index-cjs.ts"],"sourcesContent":["export { default as figures } from './lib/figures.ts';\nexport { default as formatArguments } from './lib/formatArguments.ts';\nexport type { Navigator } from './state/Navigator.ts';\nexport * from './types.ts';\n\nimport type { createSession as createSessionType, Session } from './session.ts';\nexport type { Session };\nexport const createSession = undefined as typeof createSessionType;\n"],"names":["default","figures","formatArguments","createSession","undefined"],"mappings":"AAAA,SAASA,WAAWC,OAAO,QAAQ,mBAAmB;AACtD,SAASD,WAAWE,eAAe,QAAQ,2BAA2B;AAEtE,cAAc,aAAa;AAI3B,OAAO,MAAMC,gBAAgBC,UAAsC"}

package/dist/esm/index-esm.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/kevin/Dev/OpenSource/node/spawn-term/src/index-esm.ts"],"sourcesContent":["export { default as figures } from './lib/figures.ts';\nexport { default as formatArguments } from './lib/formatArguments.ts';\nexport type { TerminalBuffer } from './lib/TerminalBuffer.ts';\nexport * from './types.ts';\n\nimport type { createSession as createSessionType, Session } from './createSessionWrapper.ts';\nexport type { Session };\n\nconst major = +process.versions.node.split('.')[0];\n\nimport { createSession as createSessionImpl } from './createSessionWrapper.ts';\nexport const createSession = major > 18 ? createSessionImpl : (undefined as typeof createSessionType);\n"],"names":["default","figures","formatArguments","major","process","versions","node","split","createSession","createSessionImpl","undefined"],"mappings":"AAAA,SAASA,WAAWC,OAAO,QAAQ,mBAAmB;AACtD,SAASD,WAAWE,eAAe,QAAQ,2BAA2B;AAEtE,cAAc,aAAa;AAK3B,MAAMC,QAAQ,CAACC,QAAQC,QAAQ,CAACC,IAAI,CAACC,KAAK,CAAC,IAAI,CAAC,EAAE;AAElD,SAASC,iBAAiBC,iBAAiB,QAAQ,4BAA4B;AAC/E,OAAO,MAAMD,gBAAgBL,QAAQ,KAAKM,oBAAqBC,UAAuC"}
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/node/spawn-term/src/index-esm.ts"],"sourcesContent":["export { default as figures } from './lib/figures.ts';\nexport { default as formatArguments } from './lib/formatArguments.ts';\nexport type { TerminalBuffer } from './lib/TerminalBuffer.ts';\nexport type { Navigator } from './state/Navigator.ts';\nexport * from './types.ts';\n\nimport type { createSession as createSessionType, Session } from './createSessionWrapper.ts';\nexport type { Session };\n\nconst major = +process.versions.node.split('.')[0];\n\nimport { createSession as createSessionImpl } from './createSessionWrapper.ts';\nexport const createSession = major > 18 ? createSessionImpl : (undefined as typeof createSessionType);\n"],"names":["default","figures","formatArguments","major","process","versions","node","split","createSession","createSessionImpl","undefined"],"mappings":"AAAA,SAASA,WAAWC,OAAO,QAAQ,mBAAmB;AACtD,SAASD,WAAWE,eAAe,QAAQ,2BAA2B;AAGtE,cAAc,aAAa;AAK3B,MAAMC,QAAQ,CAACC,QAAQC,QAAQ,CAACC,IAAI,CAACC,KAAK,CAAC,IAAI,CAAC,EAAE;AAElD,SAASC,iBAAiBC,iBAAiB,QAAQ,4BAA4B;AAC/E,OAAO,MAAMD,gBAAgBL,QAAQ,KAAKM,oBAAqBC,UAAuC"}

package/dist/esm/src/index-cjs.d.ts

@@ -1,5 +1,6 @@
 export { default as figures } from './lib/figures.js';
 export { default as formatArguments } from './lib/formatArguments.js';
+export type { Navigator } from './state/Navigator.js';
 export * from './types.js';
 import type { createSession as createSessionType, Session } from './session.js';
 export type { Session };

package/dist/esm/src/index-esm.d.ts

@@ -1,6 +1,7 @@
 export { default as figures } from './lib/figures.js';
 export { default as formatArguments } from './lib/formatArguments.js';
 export type { TerminalBuffer } from './lib/TerminalBuffer.js';
+export type { Navigator } from './state/Navigator.js';
 export * from './types.js';
 import type { createSession as createSessionType, Session } from './createSessionWrapper.js';
 export type { Session };

package/dist/esm/src/state/Navigator.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Navigator - a cursor over a bounded list with viewport tracking
+ *
+ * Used for both:
+ * - List navigation (process selection) - wraps around
+ * - Scroll navigation (content viewing) - clamps to bounds
+ */
+export type NavigatorOptions = {
+    getLength: () => number;
+    wrap: boolean;
+    onMove?: () => void;
+};
+export type Navigator = {
+    readonly position: number;
+    readonly viewportOffset: number;
+    up(step?: number): void;
+    down(step?: number): void;
+    pageUp(pageSize: number, viewportSize?: number): void;
+    pageDown(pageSize: number, viewportSize?: number): void;
+    toStart(): void;
+    toEnd(): void;
+    ensureVisible(viewportSize: number): void;
+    clampViewport(viewportSize: number): boolean;
+    setPosition(position: number): void;
+    reset(): void;
+};
+export declare function createNavigator(options: NavigatorOptions): Navigator;

package/dist/esm/src/state/processStore.d.ts

@@ -4,19 +4,17 @@ type Mode = 'normal' | 'interactive';
 export declare class ProcessStore {
     private processes;
     private completedIds;
-    private listeners;
-    private shouldExit;
-    private exitCallback;
+    private listNav;
     private mode;
-    private selectedIndex;
     private expandedId;
-    private scrollOffset;
-    private listScrollOffset;
     private errorFooterExpanded;
-    private bufferVersion;
     private header;
     private showStatusBar;
     private isInteractive;
+    private listeners;
+    private shouldExit;
+    private exitCallback;
+    private bufferVersion;
     constructor(options?: SessionOptions);
     subscribe: (listener: Listener) => (() => void);
     getSnapshot: () => ChildProcess[];
@@ -28,42 +26,47 @@ export declare class ProcessStore {
     getDoneCount: () => number;
     getErrorCount: () => number;
     getErrorLineCount: () => number;
+    getErrorLines(): Array<{
+        processName: string;
+        lines: Line[];
+    }>;
+    addProcess(process: ChildProcess): void;
+    updateProcess(id: string, update: Partial<ChildProcess>): void;
+    appendLines(id: string, newLines: Line[]): void;
+    getProcess(id: string): ChildProcess | undefined;
+    getProcessLines(id: string): Line[];
+    getProcessLineCount(id: string): number;
     getMode: () => Mode;
     getSelectedIndex: () => number;
     getExpandedId: () => string | null;
-    getScrollOffset: () => number;
     getListScrollOffset: () => number;
     getErrorFooterExpanded: () => boolean;
     getBufferVersion: () => number;
+    getScrollOffset: () => number;
     getHeader: () => string | undefined;
     getShowStatusBar: () => boolean;
     getIsInteractive: () => boolean;
     isAllComplete: () => boolean;
-    addProcess(process: ChildProcess): void;
-    updateProcess(id: string, update: Partial<ChildProcess>): void;
-    appendLines(id: string, newLines: Line[]): void;
-    getProcess(id: string): ChildProcess | undefined;
-    getProcessLines(id: string): Line[];
-    getProcessLineCount(id: string): number;
     setMode(mode: Mode): void;
-    selectNext(visibleCount?: number): void;
-    selectPrev(visibleCount?: number): void;
-    private adjustListScroll;
     getSelectedProcess(): ChildProcess | undefined;
     toggleErrorFooter(): void;
     expandErrorFooter(): void;
-    getErrorLines(): Array<{
-        processName: string;
-        lines: Line[];
-    }>;
-    toggleExpand(): void;
-    collapse(): void;
+    selectNext(visibleCount?: number): void;
+    selectPrev(visibleCount?: number): void;
+    selectPageDown(pageSize: number, visibleCount?: number): void;
+    selectPageUp(pageSize: number, visibleCount?: number): void;
+    selectFirst(visibleCount?: number): void;
+    selectLast(visibleCount?: number): void;
+    clampListViewport(visibleCount: number): void;
+    private getExpandedNav;
     scrollDown(maxVisible: number): void;
     scrollUp(): void;
-    scrollPageDown(maxVisible: number): void;
-    scrollPageUp(maxVisible: number): void;
+    scrollPageDown(pageSize: number): void;
+    scrollPageUp(pageSize: number): void;
     scrollToTop(): void;
     scrollToBottom(maxVisible: number): void;
+    toggleExpand(visibleCountWhenExpanded?: number, visibleCountWhenCollapsed?: number): void;
+    collapse(visibleCountWhenCollapsed?: number): void;
     signalExit(callback: () => void): void;
     getShouldExit: () => boolean;
     getExitCallback: () => (() => void) | null;

package/dist/esm/src/types.d.ts

@@ -26,6 +26,9 @@ export type ChildProcess = {
     title: string;
     state: State;
     lines: Line[];
+    /** @internal Virtual terminal for ANSI interpretation */
     terminalBuffer?: TerminalBuffer;
     expanded?: boolean;
+    /** @internal Per-process scroll navigation state */
+    scrollNav?: import('./state/Navigator.js').Navigator;
 };

package/dist/esm/state/Navigator.js

@@ -0,0 +1,114 @@
+/**
+ * Navigator - a cursor over a bounded list with viewport tracking
+ *
+ * Used for both:
+ * - List navigation (process selection) - wraps around
+ * - Scroll navigation (content viewing) - clamps to bounds
+ */ export function createNavigator(options) {
+    const { getLength, wrap, onMove } = options;
+    let position = 0;
+    let viewportOffset = 0;
+    const clamp = (value, min, max)=>{
+        return Math.max(min, Math.min(max, value));
+    };
+    const normalizePosition = (pos)=>{
+        const length = getLength();
+        if (length === 0) return 0;
+        if (wrap) {
+            // Wrap around for list navigation
+            return (pos % length + length) % length;
+        }
+        // Clamp for scroll navigation
+        return clamp(pos, 0, Math.max(0, length - 1));
+    };
+    const ensureVisible = (viewportSize)=>{
+        if (viewportSize <= 0) return;
+        if (position < viewportOffset) {
+            // Position is above viewport - scroll up
+            viewportOffset = position;
+        } else if (position >= viewportOffset + viewportSize) {
+            // Position is below viewport - scroll down
+            viewportOffset = position - viewportSize + 1;
+        }
+    };
+    return {
+        get position () {
+            return position;
+        },
+        get viewportOffset () {
+            return viewportOffset;
+        },
+        up (step = 1) {
+            const length = getLength();
+            if (length === 0) return;
+            position = normalizePosition(position - step);
+            onMove === null || onMove === void 0 ? void 0 : onMove();
+        },
+        down (step = 1) {
+            const length = getLength();
+            if (length === 0) return;
+            position = normalizePosition(position + step);
+            onMove === null || onMove === void 0 ? void 0 : onMove();
+        },
+        pageUp (pageSize, viewportSize) {
+            const length = getLength();
+            if (length === 0) return;
+            // For page navigation, don't wrap - stop at bounds
+            position = clamp(position - pageSize, 0, Math.max(0, length - 1));
+            if (viewportSize) {
+                ensureVisible(viewportSize);
+            }
+            onMove === null || onMove === void 0 ? void 0 : onMove();
+        },
+        pageDown (pageSize, viewportSize) {
+            const length = getLength();
+            if (length === 0) return;
+            // For page navigation, don't wrap - stop at bounds
+            position = clamp(position + pageSize, 0, Math.max(0, length - 1));
+            if (viewportSize) {
+                ensureVisible(viewportSize);
+            }
+            onMove === null || onMove === void 0 ? void 0 : onMove();
+        },
+        toStart () {
+            position = 0;
+            viewportOffset = 0;
+            onMove === null || onMove === void 0 ? void 0 : onMove();
+        },
+        toEnd () {
+            const length = getLength();
+            if (length === 0) return;
+            position = length - 1;
+            onMove === null || onMove === void 0 ? void 0 : onMove();
+        },
+        ensureVisible,
+        clampViewport (viewportSize) {
+            const length = getLength();
+            const oldOffset = viewportOffset;
+            if (length === 0 || viewportSize <= 0) {
+                viewportOffset = 0;
+                return viewportOffset !== oldOffset;
+            }
+            // If all items fit in viewport, start from 0
+            if (length <= viewportSize) {
+                viewportOffset = 0;
+                return viewportOffset !== oldOffset;
+            }
+            // Ensure no empty space at bottom: viewportOffset + viewportSize <= length
+            const maxOffset = length - viewportSize;
+            if (viewportOffset > maxOffset) {
+                viewportOffset = maxOffset;
+            }
+            // Also ensure position is still visible in the (potentially moved) viewport
+            ensureVisible(viewportSize);
+            return viewportOffset !== oldOffset;
+        },
+        setPosition (newPosition) {
+            position = normalizePosition(newPosition);
+        },
+        reset () {
+            position = 0;
+            viewportOffset = 0;
+        }
+    };
+}

package/dist/esm/state/Navigator.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/kevin/Dev/OpenSource/node/spawn-term/src/state/Navigator.ts"],"sourcesContent":["/**\n * Navigator - a cursor over a bounded list with viewport tracking\n *\n * Used for both:\n * - List navigation (process selection) - wraps around\n * - Scroll navigation (content viewing) - clamps to bounds\n */\n\nexport type NavigatorOptions = {\n  getLength: () => number;\n  wrap: boolean;\n  onMove?: () => void;\n};\n\nexport type Navigator = {\n  readonly position: number;\n  readonly viewportOffset: number;\n\n  up(step?: number): void;\n  down(step?: number): void;\n  pageUp(pageSize: number, viewportSize?: number): void;\n  pageDown(pageSize: number, viewportSize?: number): void;\n  toStart(): void;\n  toEnd(): void;\n  ensureVisible(viewportSize: number): void;\n  clampViewport(viewportSize: number): boolean; // Returns true if viewport changed\n  setPosition(position: number): void;\n  reset(): void;\n};\n\nexport function createNavigator(options: NavigatorOptions): Navigator {\n  const { getLength, wrap, onMove } = options;\n\n  let position = 0;\n  let viewportOffset = 0;\n\n  const clamp = (value: number, min: number, max: number): number => {\n    return Math.max(min, Math.min(max, value));\n  };\n\n  const normalizePosition = (pos: number): number => {\n    const length = getLength();\n    if (length === 0) return 0;\n\n    if (wrap) {\n      // Wrap around for list navigation\n      return ((pos % length) + length) % length;\n    }\n    // Clamp for scroll navigation\n    return clamp(pos, 0, Math.max(0, length - 1));\n  };\n\n  const ensureVisible = (viewportSize: number): void => {\n    if (viewportSize <= 0) return;\n\n    if (position < viewportOffset) {\n      // Position is above viewport - scroll up\n      viewportOffset = position;\n    } else if (position >= viewportOffset + viewportSize) {\n      // Position is below viewport - scroll down\n      viewportOffset = position - viewportSize + 1;\n    }\n  };\n\n  return {\n    get position() {\n      return position;\n    },\n\n    get viewportOffset() {\n      return viewportOffset;\n    },\n\n    up(step = 1): void {\n      const length = getLength();\n      if (length === 0) return;\n\n      position = normalizePosition(position - step);\n      onMove?.();\n    },\n\n    down(step = 1): void {\n      const length = getLength();\n      if (length === 0) return;\n\n      position = normalizePosition(position + step);\n      onMove?.();\n    },\n\n    pageUp(pageSize: number, viewportSize?: number): void {\n      const length = getLength();\n      if (length === 0) return;\n\n      // For page navigation, don't wrap - stop at bounds\n      position = clamp(position - pageSize, 0, Math.max(0, length - 1));\n      if (viewportSize) {\n        ensureVisible(viewportSize);\n      }\n      onMove?.();\n    },\n\n    pageDown(pageSize: number, viewportSize?: number): void {\n      const length = getLength();\n      if (length === 0) return;\n\n      // For page navigation, don't wrap - stop at bounds\n      position = clamp(position + pageSize, 0, Math.max(0, length - 1));\n      if (viewportSize) {\n        ensureVisible(viewportSize);\n      }\n      onMove?.();\n    },\n\n    toStart(): void {\n      position = 0;\n      viewportOffset = 0;\n      onMove?.();\n    },\n\n    toEnd(): void {\n      const length = getLength();\n      if (length === 0) return;\n\n      position = length - 1;\n      onMove?.();\n    },\n\n    ensureVisible,\n\n    clampViewport(viewportSize: number): boolean {\n      const length = getLength();\n      const oldOffset = viewportOffset;\n\n      if (length === 0 || viewportSize <= 0) {\n        viewportOffset = 0;\n        return viewportOffset !== oldOffset;\n      }\n\n      // If all items fit in viewport, start from 0\n      if (length <= viewportSize) {\n        viewportOffset = 0;\n        return viewportOffset !== oldOffset;\n      }\n\n      // Ensure no empty space at bottom: viewportOffset + viewportSize <= length\n      const maxOffset = length - viewportSize;\n      if (viewportOffset > maxOffset) {\n        viewportOffset = maxOffset;\n      }\n\n      // Also ensure position is still visible in the (potentially moved) viewport\n      ensureVisible(viewportSize);\n\n      return viewportOffset !== oldOffset;\n    },\n\n    setPosition(newPosition: number): void {\n      position = normalizePosition(newPosition);\n    },\n\n    reset(): void {\n      position = 0;\n      viewportOffset = 0;\n    },\n  };\n}\n"],"names":["createNavigator","options","getLength","wrap","onMove","position","viewportOffset","clamp","value","min","max","Math","normalizePosition","pos","length","ensureVisible","viewportSize","up","step","down","pageUp","pageSize","pageDown","toStart","toEnd","clampViewport","oldOffset","maxOffset","setPosition","newPosition","reset"],"mappings":"AAAA;;;;;;CAMC,GAwBD,OAAO,SAASA,gBAAgBC,OAAyB;IACvD,MAAM,EAAEC,SAAS,EAAEC,IAAI,EAAEC,MAAM,EAAE,GAAGH;IAEpC,IAAII,WAAW;IACf,IAAIC,iBAAiB;IAErB,MAAMC,QAAQ,CAACC,OAAeC,KAAaC;QACzC,OAAOC,KAAKD,GAAG,CAACD,KAAKE,KAAKF,GAAG,CAACC,KAAKF;IACrC;IAEA,MAAMI,oBAAoB,CAACC;QACzB,MAAMC,SAASZ;QACf,IAAIY,WAAW,GAAG,OAAO;QAEzB,IAAIX,MAAM;YACR,kCAAkC;YAClC,OAAO,AAAC,CAAA,AAACU,MAAMC,SAAUA,MAAK,IAAKA;QACrC;QACA,8BAA8B;QAC9B,OAAOP,MAAMM,KAAK,GAAGF,KAAKD,GAAG,CAAC,GAAGI,SAAS;IAC5C;IAEA,MAAMC,gBAAgB,CAACC;QACrB,IAAIA,gBAAgB,GAAG;QAEvB,IAAIX,WAAWC,gBAAgB;YAC7B,yCAAyC;YACzCA,iBAAiBD;QACnB,OAAO,IAAIA,YAAYC,iBAAiBU,cAAc;YACpD,2CAA2C;YAC3CV,iBAAiBD,WAAWW,eAAe;QAC7C;IACF;IAEA,OAAO;QACL,IAAIX,YAAW;YACb,OAAOA;QACT;QAEA,IAAIC,kBAAiB;YACnB,OAAOA;QACT;QAEAW,IAAGC,OAAO,CAAC;YACT,MAAMJ,SAASZ;YACf,IAAIY,WAAW,GAAG;YAElBT,WAAWO,kBAAkBP,WAAWa;YACxCd,mBAAAA,6BAAAA;QACF;QAEAe,MAAKD,OAAO,CAAC;YACX,MAAMJ,SAASZ;YACf,IAAIY,WAAW,GAAG;YAElBT,WAAWO,kBAAkBP,WAAWa;YACxCd,mBAAAA,6BAAAA;QACF;QAEAgB,QAAOC,QAAgB,EAAEL,YAAqB;YAC5C,MAAMF,SAASZ;YACf,IAAIY,WAAW,GAAG;YAElB,mDAAmD;YACnDT,WAAWE,MAAMF,WAAWgB,UAAU,GAAGV,KAAKD,GAAG,CAAC,GAAGI,SAAS;YAC9D,IAAIE,cAAc;gBAChBD,cAAcC;YAChB;YACAZ,mBAAAA,6BAAAA;QACF;QAEAkB,UAASD,QAAgB,EAAEL,YAAqB;YAC9C,MAAMF,SAASZ;YACf,IAAIY,WAAW,GAAG;YAElB,mDAAmD;YACnDT,WAAWE,MAAMF,WAAWgB,UAAU,GAAGV,KAAKD,GAAG,CAAC,GAAGI,SAAS;YAC9D,IAAIE,cAAc;gBAChBD,cAAcC;YAChB;YACAZ,mBAAAA,6BAAAA;QACF;QAEAmB;YACElB,WAAW;YACXC,iBAAiB;YACjBF,mBAAAA,6BAAAA;QACF;QAEAoB;YACE,MAAMV,SAASZ;YACf,IAAIY,WAAW,GAAG;YAElBT,WAAWS,SAAS;YACpBV,mBAAAA,6BAAAA;QACF;QAEAW;QAEAU,eAAcT,YAAoB;YAChC,MAAMF,SAASZ;YACf,MAAMwB,YAAYpB;YAElB,IAAIQ,WAAW,KAAKE,gBAAgB,GAAG;gBACrCV,iBAAiB;gBACjB,OAAOA,mBAAmBoB;YAC5B;YAEA,6CAA6C;YAC7C,IAAIZ,UAAUE,cAAc;gBAC1BV,iBAAiB;gBACjB,OAAOA,mBAAmBoB;YAC5B;YAEA,2EAA2E;YAC3E,MAAMC,YAAYb,SAASE;YAC3B,IAAIV,iBAAiBqB,WAAW;gBAC9BrB,iBAAiBqB;YACnB;YAEA,4EAA4E;YAC5EZ,cAAcC;YAEd,OAAOV,mBAAmBoB;QAC5B;QAEAE,aAAYC,WAAmB;YAC7BxB,WAAWO,kBAAkBiB;QAC/B;QAEAC;YACEzB,WAAW;YACXC,iBAAiB;QACnB;IACF;AACF"}