termcast 1.5.0 → 1.7.0

package/dist/profiler.js

@@ -0,0 +1,390 @@
+// React component profiler for termcast.
+//
+// Captures React 19.2+ PerformanceMeasure entries emitted by the development
+// reconciler (react-reconciler/cjs/react-reconciler.development.js) and writes
+// a .cpuprofile file on process exit. Analyze with profano:
+//
+//   TERMCAST_REACT_PROFILE=1 termcast dev ./my-extension
+//   bunx profano ./tmp/react-profile-*.cpuprofile --sort self
+//   bunx profano ./tmp/react-profile-*.cpuprofile --sort total
+//
+// The reconciler emits performance.measure() calls with:
+//   - name: "\u200b" + componentName (component renders)
+//   - name: trigger string like "Mount", "Cascading Update", etc.
+//   - detail.devtools.track: "Components ⚛" for component renders
+//
+// NOTE: React also emits some entries via console.timeStamp() which are not
+// captured by PerformanceObserver. This profiler captures a useful subset of
+// React's performance track data, not every component render.
+//
+// The profile builds a best-effort call tree from time containment: if measure
+// A fully contains measure B in time, B becomes a child of A. Partially
+// overlapping measures are attached to the nearest containing ancestor.
+// This gives meaningful self vs total times in profano output:
+//   - total time = all time inside a measure (including children)
+//   - self time = time not attributed to any child measure
+//
+// Requirements:
+//   - React 19.2+ in development mode (NODE_ENV !== 'production')
+//   - PerformanceObserver available (Node.js 16+, Bun)
+import fs from 'node:fs';
+import path from 'node:path';
+import { logger } from './logger';
+const measures = [];
+let observerInstalled = false;
+let profileWritten = false;
+let perfObserver = null;
+function writeProfileOnce() {
+    if (profileWritten) {
+        return;
+    }
+    profileWritten = true;
+    // Drain any queued records not yet delivered by the observer callback,
+    // so the last measures before exit are captured.
+    if (perfObserver) {
+        for (const entry of perfObserver.takeRecords()) {
+            const detail = entry.detail;
+            if (!detail?.devtools?.track) {
+                continue;
+            }
+            measures.push({
+                name: entry.name,
+                duration: entry.duration,
+                startTime: entry.startTime,
+                track: detail.devtools.track,
+            });
+        }
+    }
+    writeProfile();
+}
+export function installProfiler() {
+    if (observerInstalled) {
+        return;
+    }
+    if (typeof PerformanceObserver === 'undefined') {
+        logger.error('PerformanceObserver not available, profiling disabled');
+        return;
+    }
+    observerInstalled = true;
+    perfObserver = new PerformanceObserver((list) => {
+        for (const entry of list.getEntries()) {
+            const detail = entry.detail;
+            if (!detail?.devtools?.track) {
+                continue;
+            }
+            measures.push({
+                name: entry.name,
+                duration: entry.duration,
+                startTime: entry.startTime,
+                track: detail.devtools.track,
+            });
+        }
+    });
+    perfObserver.observe({ type: 'measure', buffered: true });
+    // Hook into the devtools fiber tree to collect component source locations
+    // from _debugStack on each commit. This builds the componentSourceMap
+    // incrementally as components render.
+    installFiberHook();
+    // Write profile on exit signals. The named function reference is used so
+    // removeListener actually removes the correct handler, preventing recursion
+    // when process.kill re-raises the signal.
+    const handleSignal = (signal) => {
+        writeProfileOnce();
+        process.removeListener(signal, handleSignal);
+        process.kill(process.pid, signal);
+    };
+    process.on('SIGINT', handleSignal);
+    process.on('SIGTERM', handleSignal);
+    process.on('exit', writeProfileOnce);
+    logger.log('React profiler installed. Profile will be written on exit.');
+}
+// Build a call tree from time containment: if span A fully contains span B,
+// B is a child of A. Each unique (track, name) pair can appear at multiple
+// tree positions when it occurs inside different parent spans.
+//
+// The algorithm: sort spans longest-first so parents come before children.
+// For each span, walk the tree from root finding the deepest ancestor that
+// contains it, then attach a new node there. Each tree node gets a unique ID
+// even if the same component name appears multiple times (different call sites).
+function buildCallTree({ spans, sourceMap }) {
+    const ROOT_ID = 1;
+    const IDLE_ID = 2;
+    const nodes = [
+        {
+            id: ROOT_ID,
+            callFrame: { functionName: '(root)', scriptId: '0', url: '', lineNumber: -1, columnNumber: -1 },
+            children: [IDLE_ID],
+        },
+        {
+            id: IDLE_ID,
+            callFrame: { functionName: '(idle)', scriptId: '0', url: '', lineNumber: -1, columnNumber: -1 },
+            children: [],
+        },
+    ];
+    let nextId = 3;
+    const rootEntry = {
+        nodeId: ROOT_ID,
+        startUs: -Infinity,
+        endUs: Infinity,
+        children: [],
+    };
+    // Sort spans by duration descending so parents (longer) are inserted first
+    const indexed = spans.map((s, i) => ({ ...s, originalIndex: i }));
+    indexed.sort((a, b) => (b.endUs - b.startUs) - (a.endUs - a.startUs));
+    // Map from original span index to the leaf node ID for sampling
+    const spanToLeafId = new Map();
+    for (const span of indexed) {
+        // Find deepest ancestor in the tree that fully contains this span
+        const parent = findDeepestContainer(rootEntry, span.startUs, span.endUs);
+        const id = nextId++;
+        const newEntry = {
+            nodeId: id,
+            startUs: span.startUs,
+            endUs: span.endUs,
+            children: [],
+        };
+        // Resolve source file path from the component name.
+        // Falls back to the React track name (e.g. "Components ⚛") for scheduler
+        // events and components not found in source.
+        // scriptId is stable per source identity so profano aggregates repeated
+        // renders of the same component into one row.
+        const sourcePath = sourceMap.get(span.name);
+        const sourceMatch = sourcePath ? /^(.*):(\d+)$/.exec(sourcePath) : null;
+        const url = sourceMatch ? sourceMatch[1] : (sourcePath || span.track);
+        const lineNumber = sourceMatch ? Number(sourceMatch[2]) : -1;
+        const scriptId = sourcePath || `${span.track}:${span.name}`;
+        nodes.push({
+            id,
+            callFrame: {
+                functionName: span.name,
+                scriptId,
+                url,
+                lineNumber,
+                columnNumber: -1,
+            },
+            children: [],
+        });
+        // Add as child of parent in both the tree and the profile nodes
+        parent.children.push(newEntry);
+        const parentNode = nodes.find((n) => n.id === parent.nodeId);
+        if (!parentNode.children.includes(id)) {
+            parentNode.children.push(id);
+        }
+        spanToLeafId.set(span.originalIndex, id);
+    }
+    return { nodes, spanToLeafId };
+}
+function findDeepestContainer(entry, startUs, endUs) {
+    // Check children for a tighter fit
+    for (const child of entry.children) {
+        if (child.startUs <= startUs && child.endUs >= endUs) {
+            return findDeepestContainer(child, startUs, endUs);
+        }
+    }
+    return entry;
+}
+// Component name → source file:line mapping built from React's fiber _debugStack.
+// Populated at runtime by hooking into __REACT_DEVTOOLS_GLOBAL_HOOK__.onCommitFiberRoot
+// which gives us the actual fiber tree with debug stack traces. Each fiber's _debugStack
+// is an Error whose second stack frame points to where the JSX element was created.
+// This is much more accurate than regex scanning source files.
+const componentSourceMap = new Map();
+// Extract "file:line" from a fiber's _debugStack Error.
+// The stack trace format varies between Bun and Node:
+//   at functionName (/path/to/file.tsx:42:5)    — named frame
+//   at /path/to/file.tsx:42:5                    — anonymous frame
+// We want the first non-React-internal frame. node_modules paths are kept
+// so components from third-party packages show their real location.
+function parseFrameLocation(frame) {
+    // Named frame: at fn (/path/file.tsx:1:2)
+    const parenthesized = /\((.+):(\d+):\d+\)\s*$/.exec(frame);
+    if (parenthesized) {
+        return { filePath: parenthesized[1], line: parenthesized[2] };
+    }
+    // Anonymous frame: at /path/file.tsx:1:2
+    const bare = /^\s*at (.+):(\d+):\d+\s*$/.exec(frame);
+    if (bare) {
+        return { filePath: bare[1], line: bare[2] };
+    }
+    return null;
+}
+function extractSourceFromFiber(fiber) {
+    const debugStack = fiber._debugStack;
+    if (!debugStack) {
+        return null;
+    }
+    const stack = debugStack.stack || String(debugStack);
+    const frames = stack.split('\n');
+    for (const frame of frames) {
+        // Skip only React internals, keep everything else including node_modules
+        if (frame.includes('react.development') ||
+            frame.includes('react-jsx') ||
+            frame.includes('react-reconciler')) {
+            continue;
+        }
+        const loc = parseFrameLocation(frame);
+        if (loc) {
+            const relativePath = path.relative(process.cwd(), loc.filePath);
+            return `${relativePath}:${loc.line}`;
+        }
+    }
+    return null;
+}
+// Get display name from a fiber, handling memo/forwardRef wrappers.
+// React wraps components in objects with .type or .render for these HOCs.
+function getFiberComponentName(fiber) {
+    const type = fiber.type;
+    if (!type) {
+        return null;
+    }
+    // Direct function component or class
+    if (type.displayName || type.name) {
+        return type.displayName || type.name;
+    }
+    // memo(Component) — type is { $$typeof: REACT_MEMO_TYPE, type: innerComponent }
+    if (type.type?.displayName || type.type?.name) {
+        return type.type.displayName || type.type.name;
+    }
+    // forwardRef(Component) — type is { $$typeof: REACT_FORWARD_REF_TYPE, render: fn }
+    if (type.render?.displayName || type.render?.name) {
+        return type.render.displayName || type.render.name;
+    }
+    return null;
+}
+// Iterative fiber tree walk to avoid stack overflow on large flat lists.
+// Sibling chains can be hundreds deep; recursion would overflow.
+function walkFiberTree(root) {
+    const stack = root ? [root] : [];
+    while (stack.length > 0) {
+        const fiber = stack.pop();
+        const name = getFiberComponentName(fiber);
+        if (name && !componentSourceMap.has(name)) {
+            const source = extractSourceFromFiber(fiber);
+            if (source) {
+                componentSourceMap.set(name, source);
+            }
+        }
+        if (fiber.sibling) {
+            stack.push(fiber.sibling);
+        }
+        if (fiber.child) {
+            stack.push(fiber.child);
+        }
+    }
+}
+function installFiberHook() {
+    const hook = globalThis.__REACT_DEVTOOLS_GLOBAL_HOOK__;
+    if (!hook) {
+        return;
+    }
+    // Preserve all arguments and `this` so React Refresh and other hooks
+    // that depend on priorityLevel and didError continue to work.
+    const originalOnCommit = hook.onCommitFiberRoot;
+    hook.onCommitFiberRoot = function (...args) {
+        const root = args[1];
+        try {
+            walkFiberTree(root?.current);
+        }
+        finally {
+            return originalOnCommit?.apply(this, args);
+        }
+    };
+}
+function writeProfile() {
+    if (measures.length === 0) {
+        logger.log('No React performance measures captured, skipping profile write');
+        return;
+    }
+    const TICK = 1000; // microseconds per sample (1ms resolution)
+    // componentSourceMap was populated incrementally by the fiber hook during rendering
+    const sourceMap = componentSourceMap;
+    const sorted = [...measures].sort((a, b) => a.startTime - b.startTime);
+    const t0 = sorted[0].startTime;
+    const endUs = Math.round((Math.max(...sorted.map((m) => m.startTime + m.duration)) - t0) * 1000);
+    // Convert measures to spans with microsecond timestamps
+    const spans = sorted.map((m) => ({
+        startUs: Math.round((m.startTime - t0) * 1000),
+        endUs: Math.round((m.startTime + m.duration - t0) * 1000),
+        name: m.name.replace('\u200b', ''),
+        track: m.track,
+    }));
+    // Build call tree from time containment, passing sourceMap for file paths
+    const { nodes, spanToLeafId } = buildCallTree({ spans, sourceMap });
+    // Generate samples only over active span windows and compress idle gaps.
+    // Instead of iterating every tick across the full timeline (which is O(ticks * spans)
+    // and can hang for long sessions), collect all span boundaries, sort them, and only
+    // sample within active windows. Idle gaps between windows become a single idle sample
+    // with a large timeDelta.
+    const samples = [];
+    const timeDeltas = [];
+    const IDLE_ID = 2;
+    // Collect unique boundary times from all spans
+    const boundaries = new Set();
+    for (const span of spans) {
+        boundaries.add(span.startUs);
+        boundaries.add(span.endUs);
+    }
+    // Add timeline start/end
+    boundaries.add(0);
+    boundaries.add(endUs);
+    const sortedBoundaries = [...boundaries].sort((a, b) => a - b);
+    // Sort spans narrowest-first for fast deepest-leaf lookup
+    const spansByNarrowest = spans
+        .map((s, i) => ({ ...s, idx: i }))
+        .sort((a, b) => (a.endUs - a.startUs) - (b.endUs - b.startUs));
+    // For each window between consecutive boundaries, determine if any span is
+    // active. If yes, sample at TICK resolution. If no, emit one idle sample.
+    for (let w = 0; w < sortedBoundaries.length - 1; w++) {
+        const windowStart = sortedBoundaries[w];
+        const windowEnd = sortedBoundaries[w + 1];
+        if (windowStart >= windowEnd) {
+            continue;
+        }
+        // Check if any span is active at the midpoint of this window
+        const mid = windowStart + Math.floor((windowEnd - windowStart) / 2);
+        let hasActiveSpan = false;
+        for (const span of spansByNarrowest) {
+            if (mid >= span.startUs && mid < span.endUs) {
+                hasActiveSpan = true;
+                break;
+            }
+        }
+        if (!hasActiveSpan) {
+            // Compress idle window into a single sample
+            samples.push(IDLE_ID);
+            timeDeltas.push(windowEnd - windowStart);
+            continue;
+        }
+        // Sample at TICK resolution within this active window.
+        // Use Math.min so the last sample's timeDelta covers only the remainder,
+        // preventing inflation when the window is shorter than TICK or not divisible.
+        for (let t = windowStart; t < windowEnd; t += TICK) {
+            const nextT = Math.min(t + TICK, windowEnd);
+            let leafId = IDLE_ID;
+            for (const span of spansByNarrowest) {
+                if (t >= span.startUs && t < span.endUs) {
+                    leafId = spanToLeafId.get(span.idx) ?? IDLE_ID;
+                    break;
+                }
+            }
+            samples.push(leafId);
+            timeDeltas.push(nextT - t);
+        }
+    }
+    const profile = {
+        nodes,
+        samples,
+        startTime: 0,
+        endTime: endUs,
+        timeDeltas,
+    };
+    // Write to ./tmp/react-profile.cpuprofile relative to cwd
+    const outDir = path.join(process.cwd(), 'tmp');
+    fs.mkdirSync(outDir, { recursive: true });
+    const outPath = path.join(outDir, `react-profile-${Date.now()}.cpuprofile`);
+    fs.writeFileSync(outPath, JSON.stringify(profile));
+    const activeSamples = samples.filter((s) => s !== 2).length;
+    logger.log(`Wrote React profile: ${outPath} (${measures.length} measures, ${nodes.length} nodes, ${activeSamples} active / ${samples.length} total samples)`);
+    console.error(`\nReact profile written: ${outPath}\nAnalyze with: npx profano ${outPath} --sort self`);
+}
+//# sourceMappingURL=profiler.js.map

package/dist/profiler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiler.js","sourceRoot":"","sources":["../src/profiler.tsx"],"names":[],"mappings":"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"}

package/package.json

@@ -1,18 +1,9 @@
 {
   "name": "termcast",
-  "version": "1.5.0",
+  "version": "1.7.0",
   "description": "Raycast for the terminal",
   "repository": "https://github.com/remorses/termcast",
   "types": "./dist/index.d.ts",
-  "scripts": {
-    "build": "tsc",
-    "prepublishOnly": "bun x tsc && chmod +x dist/cli.js",
-    "release": "cd .. && bun changeset version && /Users/morse/Documents/GitHub/changesets/packages/cli/bin.js publish # my own fork to support github releases",
-    "see-raycast-types": "zed node_modules/@raycast/api/types/index.d.ts",
-    "play": "bun src/cli.tsx",
-    "test": "bun test && bun e2e",
-    "e2e": "vitest -u"
-  },
   "bin": {
     "termcast": "./dist/cli.js"
   },
@@ -94,7 +85,6 @@
     "@parcel/watcher": "^2.5.6",
     "@tanstack/react-query": "^5.85.5",
     "@tanstack/react-query-persist-client": "^5.85.5",
-    "@termcast/utils": "^2.2.8",
     "change-case": "^5.4.4",
     "colord": "^2.9.3",
     "goke": "^6.6.0",
@@ -107,7 +97,8 @@
     "react-refresh": "^0.18.0",
     "simple-plist": "^1.3.1",
     "string-dedent": "^3.0.2",
-    "zustand": "^5.0.8"
+    "zustand": "^5.0.8",
+    "@termcast/utils": "^2.2.8"
   },
   "peerDependencies": {
     "@opentui/core": "^0.2.12",
@@ -126,10 +117,18 @@
     "bun-pty": "0.4.8",
     "zigpty": "^0.0.4",
     "react": "^19.2.4",
-    "tuistory": "^0.7.0",
-    "vitest": "^4.0.16"
+    "vitest": "^4.0.16",
+    "tuistory": "^0.8.1"
   },
   "optionalDependencies": {
     "sharp": "^0.34.5"
+  },
+  "scripts": {
+    "build": "tsc",
+    "release": "cd .. && pnpm changeset version && /Users/morse/Documents/GitHub/changesets/packages/cli/bin.js publish # my own fork to support github releases",
+    "see-raycast-types": "zed node_modules/@raycast/api/types/index.d.ts",
+    "play": "bun src/cli.tsx",
+    "test": "bun test && pnpm e2e",
+    "e2e": "vitest -u"
   }
-}
+}

package/src/build.tsx

@@ -244,13 +244,35 @@ export async function buildExtensionCommands({
     packageJsonPath: path.join(resolvedPath, 'package.json'),
   })
 
-  // Filter existing command files as entrypoints
-  const entrypoints = commandsData.commands
-    .filter((cmd) => cmd.exists)
-    .map((cmd) => cmd.filePath)
+  // Build entrypoints. For directory-style entries (e.g. src/tui/index.tsx),
+  // generate a wrapper file named {command}.tsx in the bundle dir so Bun
+  // outputs {command}.js instead of index.js. This avoids collisions when
+  // multiple commands use directory entries (Bun fails with "Multiple files
+  // share the same output path ./index.js" otherwise).
+  const existingCommands = commandsData.commands.filter((cmd) => cmd.exists)
+  const entrypoints = existingCommands.map((cmd) => {
+    const isDirectoryEntry = path.basename(cmd.filePath).startsWith('index.')
+    if (isDirectoryEntry) {
+      const wrapperPath = path.join(bundleDir, `${cmd.name}.tsx`)
+      fs.writeFileSync(
+        wrapperPath,
+        `export * from ${JSON.stringify(cmd.filePath)};\nexport { default } from ${JSON.stringify(cmd.filePath)};\n`,
+      )
+      return wrapperPath
+    }
+    return cmd.filePath
+  })
 
   if (entrypoints.length === 0) {
-    throw new Error('No command files found to build')
+    const tried = commandsData.commands
+      .map((cmd) => {
+        const paths = cmd.checkedPaths.map((p) => `    ${p}`).join('\n')
+        return `  command "${cmd.name}" checked:\n${paths}`
+      })
+      .join('\n')
+    throw new Error(
+      `No command files found to build.\n${tried}\n\nEach command in package.json "commands" needs a matching file: {name}.tsx or {name}/index.tsx in the project root or src/`,
+    )
   }
 
   logger.log(`Building ${entrypoints.length} commands...`)

package/src/compile.tsx

@@ -190,7 +190,15 @@ export async function compileExtension({
   if (!entry) {
     const existingCommands = commands.filter((cmd) => cmd.exists)
     if (existingCommands.length === 0) {
-      throw new Error('No command files found to build')
+      const tried = commands
+        .map((cmd) => {
+          const paths = cmd.checkedPaths.map((p) => `    ${p}`).join('\n')
+          return `  command "${cmd.name}" checked:\n${paths}`
+        })
+        .join('\n')
+      throw new Error(
+        `No command files found to build.\n${tried}\n\nEach command in package.json "commands" needs a matching file: {name}.tsx or {name}/index.tsx in the project root or src/`,
+      )
     }
     logger.log(`Compiling ${existingCommands.length} commands...`)
   } else {

package/src/compile.vitest.tsx

@@ -90,13 +90,13 @@ test('compile extension and run executable', async () => {
 
        Commands
       ›List Items Displays a simple list with some items view
-       Sear...temsSearch and filter...gh a list of items view
+       Search ItemsSearch and filter...h a list of items view
        Google Oauth                                      view
-       useP...DemoShows how to use ...rom @raycast/utils view
-       Sh...ateShows the current a...tate in JSON format view
-
-
-       ↵ run command   ↑↓ navigate   ^k actions   :vim
+       usePr...e Dem Shows how to use...m @raycast/utils view
+       Show Stat Shows the current ...ate in JSON format view
+       With ...mentsDemonstrates com...ssword, dropdown) view
+       Quic...tionCopies current t...t showing a view no-view
+       Throw ErrorCommand that thro...rror at root scope view
     "
   `)
 }, 60000)
@@ -142,7 +142,7 @@ test('compiled executable can run command', async () => {
        ○ Fifth Item This is the fifth item
 
 
-     ✓ Copied to Clipboard  First Item
+
     "
   `)
 }, 60000)
@@ -198,7 +198,7 @@ test('compiled executable can navigate back', async () => {
        ○ Fifth Item This is the fifth item
 
 
-       ↵ copy item title   ↑↓ navigate   ^k actions   :vim
+
     "
   `)
 }, 60000)

package/src/components/bar-chart.tsx

@@ -12,9 +12,11 @@
  *   primary, accent, info, success, warning, error, secondary (cycles with %)
  */
 
-import React, { ReactNode, useMemo } from 'react'
+import React, { ReactNode, useMemo, useRef } from 'react'
+import type { MouseEvent as OpenTUIMouseEvent } from '@opentui/core'
 import { useTheme, getThemePalette } from 'termcast/src/theme'
 import { Color, resolveColor } from 'termcast/src/colors'
+import { ChartTooltip, useChartTooltip, formatTooltipLine } from 'termcast/src/components/chart-tooltip'
 
 // ── Types ────────────────────────────────────────────────────────────
 
@@ -173,6 +175,8 @@ function LabelRow({ segments, labelMap, position, color }: {
 const BarChart: BarChartType = (props) => {
   const theme = useTheme()
   const { height = 1, showLabels = true, children } = props
+  const containerRef = useRef<any>(null)
+  const { tooltip, show: showTooltip, hide: hideTooltip } = useChartTooltip()
 
   // Collect segment data from BarChart.Segment children
   const segments = useMemo<SegmentData[]>(() => {
@@ -242,7 +246,8 @@ const BarChart: BarChartType = (props) => {
   const belowMap = new Map(below.map((l) => [l.segmentIndex, l]))
 
   return (
-    <box flexDirection="column" width="100%" flexShrink={0}>
+    <box ref={containerRef} flexDirection="column" width="100%" flexShrink={0} onMouseOut={hideTooltip}>
+      <ChartTooltip tooltip={tooltip} containerRef={containerRef} />
       <LabelRow
         segments={visibleSegments}
         labelMap={aboveMap}
@@ -252,7 +257,22 @@ const BarChart: BarChartType = (props) => {
       <box flexDirection="row" height={height} width="100%" flexShrink={0}>
         {visibleSegments.map((seg, i) => {
           return (
-            <box key={i} flexGrow={seg.value} flexShrink={0} backgroundColor={seg.resolvedColor} height={height} />
+            <box
+              key={i}
+              flexGrow={seg.value}
+              flexShrink={0}
+              backgroundColor={seg.resolvedColor}
+              height={height}
+              onMouseMove={(evt: OpenTUIMouseEvent) => {
+                const pct = formatValue(seg.value, total)
+                const label = seg.label || `#${i + 1}`
+                showTooltip({
+                  x: evt.x,
+                  y: evt.y,
+                  lines: [formatTooltipLine(label, `${seg.value} (${pct})`)],
+                })
+              }}
+            />
           )
         })}
       </box>