@effect-tui/react 0.1.0-alpha.1

package/dist/src/test/mock-streams.d.ts

@@ -0,0 +1,44 @@
+import { EventEmitter } from "node:events";
+import type { KeyMsg } from "@effect-tui/core";
+/**
+ * Mock stdout for testing. Captures all writes and simulates terminal properties.
+ */
+export declare class MockStdout extends EventEmitter {
+    columns: number;
+    rows: number;
+    buf: string;
+    constructor(width?: number, height?: number);
+    write(s: string): boolean;
+    /** Clear captured output */
+    clear(): void;
+    /** Simulate terminal resize */
+    resize(width: number, height: number): void;
+}
+/**
+ * Mock stdin for testing. Simulates TTY input with key event emission.
+ */
+export declare class MockStdin extends EventEmitter {
+    isTTY: boolean;
+    setRawMode(_mode: boolean): this;
+    resume(): this;
+    pause(): this;
+    /** Send raw bytes (for testing decodeKeys directly) */
+    sendRaw(data: Buffer): void;
+    /** Send a key by encoding it to bytes */
+    sendKey(key: KeyMsg): void;
+}
+/**
+ * Encode a KeyMsg to raw bytes for stdin simulation.
+ * This is the reverse of decodeKeys().
+ */
+export declare function encodeKey(key: KeyMsg): Buffer;
+/**
+ * Strip ANSI escape codes from a string for easier assertions.
+ */
+export declare function stripAnsi(str: string): string;
+/**
+ * Extract visible text lines from raw terminal output.
+ * Removes ANSI codes and splits by newlines.
+ */
+export declare function getVisibleLines(output: string): string[];
+//# sourceMappingURL=mock-streams.d.ts.map

package/dist/src/test/mock-streams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-streams.d.ts","sourceRoot":"","sources":["../../../src/test/mock-streams.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAE9C;;GAEG;AACH,qBAAa,UAAW,SAAQ,YAAY;IAC1C,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,SAAK;gBAEI,KAAK,SAAK,EAAE,MAAM,SAAK;IAMnC,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO;IAKzB,4BAA4B;IAC5B,KAAK,IAAI,IAAI;IAIb,+BAA+B;IAC/B,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAK5C;AAED;;GAEG;AACH,qBAAa,SAAU,SAAQ,YAAY;IACzC,KAAK,UAAO;IAEZ,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAIhC,MAAM,IAAI,IAAI;IAId,KAAK,IAAI,IAAI;IAIb,uDAAuD;IACvD,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI3B,yCAAyC;IACzC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;CAI3B;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CA4D7C;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG7C;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAKxD"}

package/dist/src/test/mock-streams.js

@@ -0,0 +1,136 @@
+import { EventEmitter } from "node:events";
+/**
+ * Mock stdout for testing. Captures all writes and simulates terminal properties.
+ */
+export class MockStdout extends EventEmitter {
+    columns;
+    rows;
+    buf = "";
+    constructor(width = 80, height = 24) {
+        super();
+        this.columns = width;
+        this.rows = height;
+    }
+    write(s) {
+        this.buf += s;
+        return true;
+    }
+    /** Clear captured output */
+    clear() {
+        this.buf = "";
+    }
+    /** Simulate terminal resize */
+    resize(width, height) {
+        this.columns = width;
+        this.rows = height;
+        this.emit("resize");
+    }
+}
+/**
+ * Mock stdin for testing. Simulates TTY input with key event emission.
+ */
+export class MockStdin extends EventEmitter {
+    isTTY = true;
+    setRawMode(_mode) {
+        return this;
+    }
+    resume() {
+        return this;
+    }
+    pause() {
+        return this;
+    }
+    /** Send raw bytes (for testing decodeKeys directly) */
+    sendRaw(data) {
+        this.emit("data", data);
+    }
+    /** Send a key by encoding it to bytes */
+    sendKey(key) {
+        const encoded = encodeKey(key);
+        this.emit("data", encoded);
+    }
+}
+/**
+ * Encode a KeyMsg to raw bytes for stdin simulation.
+ * This is the reverse of decodeKeys().
+ */
+export function encodeKey(key) {
+    const name = key.name;
+    const text = key.text;
+    // Control keys (Ctrl + printable character)
+    if (key.ctrl && text) {
+        const lower = text.toLowerCase();
+        if (lower === "c")
+            return Buffer.from([0x03]);
+        if (lower === "d")
+            return Buffer.from([0x04]);
+        if (lower === "z")
+            return Buffer.from([0x1a]);
+        if (lower === "w")
+            return Buffer.from([0x17]);
+        // Ctrl+letter = letter code - 0x60
+        if (text.length === 1) {
+            const code = lower.charCodeAt(0) - 0x60;
+            if (code >= 1 && code <= 26)
+                return Buffer.from([code]);
+        }
+    }
+    // Special keys (escape sequences)
+    switch (name) {
+        case "up":
+            return Buffer.from([0x1b, 0x5b, 0x41]);
+        case "down":
+            return Buffer.from([0x1b, 0x5b, 0x42]);
+        case "right":
+            return Buffer.from([0x1b, 0x5b, 0x43]);
+        case "left":
+            return Buffer.from([0x1b, 0x5b, 0x44]);
+        case "home":
+            return Buffer.from([0x1b, 0x5b, 0x48]);
+        case "end":
+            return Buffer.from([0x1b, 0x5b, 0x46]);
+        case "pageup":
+            return Buffer.from([0x1b, 0x5b, 0x35, 0x7e]);
+        case "pagedown":
+            return Buffer.from([0x1b, 0x5b, 0x36, 0x7e]);
+        case "delete":
+            return Buffer.from([0x1b, 0x5b, 0x33, 0x7e]);
+        case "insert":
+            return Buffer.from([0x1b, 0x5b, 0x32, 0x7e]);
+        case "escape":
+            return Buffer.from([0x1b]);
+        case "tab":
+            return Buffer.from([0x09]);
+        case "enter":
+        case "return":
+            return Buffer.from([0x0d]);
+        case "backspace":
+            return Buffer.from([0x7f]);
+        case "space":
+            return Buffer.from([0x20]);
+    }
+    // Regular character
+    if (text) {
+        return Buffer.from(text, "utf8");
+    }
+    // Unknown key, return empty
+    return Buffer.from([]);
+}
+/**
+ * Strip ANSI escape codes from a string for easier assertions.
+ */
+export function stripAnsi(str) {
+    // eslint-disable-next-line no-control-regex
+    return str.replace(/\x1b\[[0-9;]*[a-zA-Z]/g, "").replace(/\x1b\][^\x07]*\x07/g, "");
+}
+/**
+ * Extract visible text lines from raw terminal output.
+ * Removes ANSI codes and splits by newlines.
+ */
+export function getVisibleLines(output) {
+    const stripped = stripAnsi(output);
+    // Replace carriage returns with newlines for consistency
+    const normalized = stripped.replace(/\r\n/g, "\n").replace(/\r/g, "\n");
+    return normalized.split("\n");
+}
+//# sourceMappingURL=mock-streams.js.map

package/dist/src/test/mock-streams.js.map

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

package/dist/src/test/render-tui.d.ts

@@ -0,0 +1,47 @@
+import type { ReactElement } from "react";
+import type { KeyMsg } from "@effect-tui/core";
+import { MockStdout, MockStdin } from "./mock-streams.js";
+export interface RenderTUIOptions {
+    width?: number;
+    height?: number;
+}
+export interface RenderTUIResult {
+    /** Get last rendered frame as raw string (includes ANSI codes) */
+    lastFrameRaw(): string;
+    /** Get last rendered frame with ANSI codes stripped */
+    lastFrame(): string;
+    /** Get visible text lines from last frame */
+    lines(): string[];
+    /** Send a key event */
+    sendKey(key: KeyMsg): void;
+    /** Trigger a render cycle and process React updates */
+    flush(): void;
+    /** Unmount the component and stop the renderer */
+    unmount(): void;
+    /** Access mock stdout for advanced assertions */
+    stdout: MockStdout;
+    /** Access mock stdin for advanced input simulation */
+    stdin: MockStdin;
+    /** Resize the terminal */
+    resize(width: number, height: number): void;
+}
+/**
+ * Render a TUI component for testing.
+ * Similar to ink-testing-library's render().
+ *
+ * @example
+ * ```ts
+ * const { lastFrame, sendKey, flush, unmount } = renderTUI(<Counter />)
+ *
+ * expect(lastFrame()).toContain("Count: 0")
+ *
+ * sendKey({ key: "up" })
+ * flush()
+ *
+ * expect(lastFrame()).toContain("Count: 1")
+ *
+ * unmount()
+ * ```
+ */
+export declare function renderTUI(element: ReactElement, options?: RenderTUIOptions): RenderTUIResult;
+//# sourceMappingURL=render-tui.d.ts.map

package/dist/src/test/render-tui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-tui.d.ts","sourceRoot":"","sources":["../../../src/test/render-tui.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AACzC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAG9C,OAAO,EAAE,UAAU,EAAE,SAAS,EAA8B,MAAM,mBAAmB,CAAA;AAErF,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,kEAAkE;IAClE,YAAY,IAAI,MAAM,CAAA;IACtB,uDAAuD;IACvD,SAAS,IAAI,MAAM,CAAA;IACnB,6CAA6C;IAC7C,KAAK,IAAI,MAAM,EAAE,CAAA;IACjB,uBAAuB;IACvB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,uDAAuD;IACvD,KAAK,IAAI,IAAI,CAAA;IACb,kDAAkD;IAClD,OAAO,IAAI,IAAI,CAAA;IACf,iDAAiD;IACjD,MAAM,EAAE,UAAU,CAAA;IAClB,sDAAsD;IACtD,KAAK,EAAE,SAAS,CAAA;IAChB,0BAA0B;IAC1B,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAC5C;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,eAAe,CAmE5F"}

package/dist/src/test/render-tui.js

@@ -0,0 +1,76 @@
+import { createRenderer, createRoot } from "../renderer.js";
+import { flushPassiveEffects, flushSync, discreteUpdates } from "../reconciler/host-config.js";
+import { MockStdout, MockStdin, stripAnsi, getVisibleLines } from "./mock-streams.js";
+/**
+ * Render a TUI component for testing.
+ * Similar to ink-testing-library's render().
+ *
+ * @example
+ * ```ts
+ * const { lastFrame, sendKey, flush, unmount } = renderTUI(<Counter />)
+ *
+ * expect(lastFrame()).toContain("Count: 0")
+ *
+ * sendKey({ key: "up" })
+ * flush()
+ *
+ * expect(lastFrame()).toContain("Count: 1")
+ *
+ * unmount()
+ * ```
+ */
+export function renderTUI(element, options) {
+    const width = options?.width ?? 80;
+    const height = options?.height ?? 24;
+    const stdout = new MockStdout(width, height);
+    const stdin = new MockStdin();
+    const renderer = createRenderer({
+        stdout: stdout,
+        stdin: stdin,
+        manualMode: true,
+        skipTerminalSetup: true,
+    });
+    const root = createRoot(renderer);
+    root.render(element, true); // sync mode
+    // Flush effects
+    flushPassiveEffects();
+    // Initial render
+    renderer.flush();
+    const flush = () => {
+        // Flush React updates synchronously
+        flushSync(() => { });
+        flushPassiveEffects();
+        // Clear buffer before re-render to get clean frame
+        stdout.clear();
+        renderer.requestRender();
+        renderer.flush();
+    };
+    return {
+        lastFrameRaw() {
+            return stdout.buf;
+        },
+        lastFrame() {
+            return stripAnsi(stdout.buf);
+        },
+        lines() {
+            return getVisibleLines(stdout.buf);
+        },
+        sendKey(key) {
+            // Use discreteUpdates to ensure React processes state updates synchronously
+            discreteUpdates(() => {
+                stdin.sendKey(key);
+            });
+        },
+        flush,
+        unmount() {
+            root.unmount();
+        },
+        stdout,
+        stdin,
+        resize(w, h) {
+            stdout.resize(w, h);
+            flush();
+        },
+    };
+}
+//# sourceMappingURL=render-tui.js.map

package/dist/src/test/render-tui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-tui.js","sourceRoot":"","sources":["../../../src/test/render-tui.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAC3D,OAAO,EAAE,mBAAmB,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAA;AAC9F,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AA4BrF;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,SAAS,CAAC,OAAqB,EAAE,OAA0B;IACzE,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,EAAE,CAAA;IAClC,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,EAAE,CAAA;IAEpC,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;IAC5C,MAAM,KAAK,GAAG,IAAI,SAAS,EAAE,CAAA;IAE7B,MAAM,QAAQ,GAAG,cAAc,CAAC;QAC9B,MAAM,EAAE,MAAa;QACrB,KAAK,EAAE,KAAY;QACnB,UAAU,EAAE,IAAI;QAChB,iBAAiB,EAAE,IAAI;KACxB,CAAC,CAAA;IAEF,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAA;IACjC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA,CAAC,YAAY;IAEvC,gBAAgB;IAChB,mBAAmB,EAAE,CAAA;IAErB,iBAAiB;IACjB,QAAQ,CAAC,KAAK,EAAE,CAAA;IAEhB,MAAM,KAAK,GAAG,GAAG,EAAE;QACjB,oCAAoC;QACpC,SAAS,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;QACnB,mBAAmB,EAAE,CAAA;QACrB,mDAAmD;QACnD,MAAM,CAAC,KAAK,EAAE,CAAA;QACd,QAAQ,CAAC,aAAa,EAAE,CAAA;QACxB,QAAQ,CAAC,KAAK,EAAE,CAAA;IAClB,CAAC,CAAA;IAED,OAAO;QACL,YAAY;YACV,OAAO,MAAM,CAAC,GAAG,CAAA;QACnB,CAAC;QAED,SAAS;YACP,OAAO,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QAC9B,CAAC;QAED,KAAK;YACH,OAAO,eAAe,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QACpC,CAAC;QAED,OAAO,CAAC,GAAW;YACjB,4EAA4E;YAC5E,eAAe,CAAC,GAAG,EAAE;gBACnB,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;YACpB,CAAC,CAAC,CAAA;QACJ,CAAC;QAED,KAAK;QAEL,OAAO;YACL,IAAI,CAAC,OAAO,EAAE,CAAA;QAChB,CAAC;QAED,MAAM;QACN,KAAK;QAEL,MAAM,CAAC,CAAS,EAAE,CAAS;YACzB,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;YACnB,KAAK,EAAE,CAAA;QACT,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/src/trace/SpanTree.d.ts

@@ -0,0 +1,10 @@
+import type { SpanTreeState } from "./span-state.js";
+interface SpanTreeProps {
+    state: SpanTreeState;
+    spinnerIndex: number;
+    serviceName?: string;
+    showExitPrompt?: boolean;
+}
+export declare function SpanTree({ state, spinnerIndex, serviceName, showExitPrompt }: SpanTreeProps): import("react").ReactNode;
+export {};
+//# sourceMappingURL=SpanTree.d.ts.map

package/dist/src/trace/SpanTree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpanTree.d.ts","sourceRoot":"","sources":["../../../src/trace/SpanTree.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAY,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAqJ9D,UAAU,aAAa;IACrB,KAAK,EAAE,aAAa,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB;AAED,wBAAgB,QAAQ,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,EAAE,aAAa,6BAmC3F"}

package/dist/src/trace/SpanTree.js

@@ -0,0 +1,104 @@
+import { jsxs as _jsxs, jsx as _jsx } from "@effect-tui/react/jsx-runtime";
+// React component for visualizing span tree
+import { Colors } from "@effect-tui/core";
+const SPINNER_FRAMES = ["⠋", "⠙", "⠸", "⠴", "⠦", "⠇"];
+function formatDuration(ms) {
+    if (ms < 1000)
+        return `${Math.round(ms)}ms`;
+    return `${(ms / 1000).toFixed(1)}s`;
+}
+// Map opacity (0-1) to gray level (8-23 for visible range)
+function opacityToGray(opacity) {
+    const minGray = 8;
+    const maxGray = 23;
+    return Math.round(minGray + opacity * (maxGray - minGray));
+}
+// Interpolate RGB color based on opacity
+function dimColor(r, g, b, opacity) {
+    const minOpacity = 0.3; // Don't go completely dark
+    const factor = minOpacity + opacity * (1 - minOpacity);
+    return Colors.rgb(Math.round(r * factor), Math.round(g * factor), Math.round(b * factor));
+}
+// Get log level color
+function logLevelColor(level, opacity) {
+    switch (level) {
+        case "ERROR":
+            return dimColor(255, 80, 80, opacity);
+        case "WARN":
+            return dimColor(255, 200, 0, opacity);
+        case "INFO":
+            return dimColor(100, 180, 255, opacity);
+        default:
+            return Colors.gray(opacityToGray(opacity));
+    }
+}
+function SpanRow({ node, state, spinnerIndex, prefix, isLast }) {
+    const connector = isLast ? "└─" : "├─";
+    const childPrefix = prefix + (isLast ? "   " : "│  ");
+    const opacity = node.opacity;
+    const grayLevel = opacityToGray(opacity);
+    const isSelected = state.selectedSpanId === node.id;
+    const isExpanded = state.expandedSpanIds.has(node.id);
+    // Status icon
+    let icon;
+    let iconColor;
+    if (node.status === "running") {
+        icon = SPINNER_FRAMES[spinnerIndex];
+        iconColor = Colors.brightCyan;
+    }
+    else if (node.status === "success") {
+        icon = "✓";
+        iconColor = dimColor(0, 255, 0, opacity);
+    }
+    else {
+        icon = "✗";
+        iconColor = dimColor(255, 80, 80, opacity);
+    }
+    // Name color - selected gets blue bg with bright text
+    const nameColor = isSelected
+        ? Colors.brightWhite
+        : node.status === "running"
+            ? Colors.brightWhite
+            : Colors.gray(grayLevel);
+    const nameBg = isSelected ? Colors.rgb(30, 60, 120) : undefined;
+    // Duration display
+    const durationStr = node.duration !== undefined
+        ? formatDuration(node.duration)
+        : node.status === "running"
+            ? formatDuration(Date.now() - node.startTime)
+            : "";
+    const durationColor = Colors.gray(Math.max(8, grayLevel - 4));
+    // Log counts from logEntries
+    const logCounts = { info: 0, warn: 0, error: 0, debug: 0 };
+    for (const entry of node.logEntries) {
+        if (entry.level === "INFO")
+            logCounts.info++;
+        else if (entry.level === "WARN")
+            logCounts.warn++;
+        else if (entry.level === "ERROR")
+            logCounts.error++;
+        else
+            logCounts.debug++;
+    }
+    const logParts = [];
+    if (logCounts.error > 0)
+        logParts.push({ text: `${logCounts.error} err`, color: dimColor(255, 80, 80, opacity) });
+    if (logCounts.warn > 0)
+        logParts.push({ text: `${logCounts.warn} warn`, color: dimColor(255, 200, 0, opacity) });
+    if (logCounts.info > 0)
+        logParts.push({ text: `${logCounts.info} info`, color: dimColor(100, 180, 255, opacity) });
+    if (logCounts.debug > 0)
+        logParts.push({ text: `${logCounts.debug} dbg`, color: Colors.gray(grayLevel) });
+    return (_jsxs("vstack", { children: [_jsxs("hstack", { children: [_jsxs("text", { fg: Colors.gray(Math.max(8, grayLevel - 2)), children: [prefix, connector] }), _jsxs("text", { fg: iconColor, children: [" ", icon, " "] }), _jsx("text", { fg: nameColor, bg: nameBg, children: node.name }), durationStr && _jsxs("text", { fg: durationColor, children: [" ", durationStr] }), logParts.length > 0 && _jsx("text", { fg: durationColor, children: " [" }), logParts.map((p, i) => (_jsxs("text", { fg: p.color, children: [i > 0 ? " " : "", p.text] }, i))), logParts.length > 0 && _jsx("text", { fg: durationColor, children: "]" }), node.error && _jsxs("text", { fg: Colors.red, children: [" (", node.error, ")"] })] }), isExpanded &&
+                node.logEntries.map((entry, i) => (_jsxs("hstack", { children: [_jsxs("text", { fg: Colors.gray(10), children: [childPrefix, node.children.length > 0 ? "│  " : "   "] }), _jsx("text", { fg: logLevelColor(entry.level, opacity), children: entry.level }), _jsxs("text", { fg: Colors.gray(16), children: [" ", entry.message] })] }, i))), node.children.map((child, i) => (_jsx(SpanRow, { node: child, state: state, spinnerIndex: spinnerIndex, prefix: childPrefix, isLast: i === node.children.length - 1 }, child.id)))] }));
+}
+export function SpanTree({ state, spinnerIndex, serviceName, showExitPrompt }) {
+    // No subscription needed - parent's 60fps loop drives re-renders
+    const roots = state.getRoots();
+    if (roots.length === 0) {
+        return _jsx("text", { fg: Colors.gray(10), children: "Waiting for spans..." });
+    }
+    const hasAnyLogs = state.getSpansWithLogs().length > 0;
+    return (_jsxs("vstack", { children: [serviceName && (_jsx("text", { fg: Colors.brightWhite, bold: true, children: serviceName })), roots.map((root, i) => (_jsx(SpanRow, { node: root, state: state, spinnerIndex: spinnerIndex, prefix: "", isLast: i === roots.length - 1 }, root.id))), showExitPrompt && (_jsxs("text", { fg: Colors.gray(12), children: ["\n", hasAnyLogs ? "↑↓ navigate, Enter expand, O open, q to exit" : "q to exit"] }))] }));
+}
+//# sourceMappingURL=SpanTree.js.map

package/dist/src/trace/SpanTree.js.map

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

package/dist/src/trace/index.d.ts

@@ -0,0 +1,30 @@
+import type * as OtelResource from "@effect/opentelemetry/Resource";
+import { Effect } from "effect";
+export { SpanTreeState } from "./span-state.js";
+export { TuiSpanProcessor } from "./span-processor.js";
+export { SpanTree } from "./SpanTree.js";
+export { makeTuiLogger } from "./tui-logger.js";
+export interface TraceVisualizeOptions {
+    /** Service name for OpenTelemetry resource (default: "effect-app") */
+    serviceName?: string;
+    /** Show diagnostics panel inside the trace UI */
+    debugPanel?: boolean;
+}
+/**
+ * Run an Effect program with TUI visualization of OpenTelemetry spans.
+ *
+ * Shows a tree of spans as they execute, with spinners for in-progress
+ * and checkmarks/X for completed spans.
+ *
+ * @example
+ * ```ts
+ * const program = Effect.gen(function* () {
+ *   yield* Effect.sleep(1000).pipe(Effect.withSpan("step-1"))
+ *   yield* Effect.sleep(500).pipe(Effect.withSpan("step-2"))
+ * }).pipe(Effect.withSpan("main"))
+ *
+ * await traceVisualize(program)
+ * ```
+ */
+export declare const traceVisualize: <A, E, R>(effect: Effect.Effect<A, E, R>, options?: TraceVisualizeOptions) => Effect.Effect<void, never, Exclude<R, OtelResource.Resource>>;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/trace/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/trace/index.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,KAAK,YAAY,MAAM,gCAAgC,CAAA;AACnE,OAAO,EAAE,MAAM,EAAiB,MAAM,QAAQ,CAAA;AAS9C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAK/C,MAAM,WAAW,qBAAqB;IACpC,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,iDAAiD;IACjD,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB;AAsGD;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,cAAc,GAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EACpC,QAAQ,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAC9B,UAAU,qBAAqB,KAC9B,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,EAAE,YAAY,CAAC,QAAQ,CAAC,CAqDM,CAAA"}

package/dist/src/trace/index.js

@@ -0,0 +1,142 @@
+import { jsx as _jsx, jsxs as _jsxs } from "@effect-tui/react/jsx-runtime";
+// OpenTelemetry trace visualization for Effect programs
+import React from "react";
+import { spawn } from "node:child_process";
+import { fileURLToPath } from "node:url";
+import { isAppPath } from "./location.js";
+import * as NodeSdk from "@effect/opentelemetry/NodeSdk";
+import { Effect, Layer, Logger } from "effect";
+import { createRenderer, createRoot } from "../renderer.js";
+import { useKeyboard } from "../hooks/index.js";
+import { SpanTreeState } from "./span-state.js";
+import { TuiSpanProcessor } from "./span-processor.js";
+import { SpanTree } from "./SpanTree.js";
+import { makeTuiLogger } from "./tui-logger.js";
+import { DiagnosticsPanel } from "../debug/DiagnosticsPanel.js";
+export { SpanTreeState } from "./span-state.js";
+export { TuiSpanProcessor } from "./span-processor.js";
+export { SpanTree } from "./SpanTree.js";
+export { makeTuiLogger } from "./tui-logger.js";
+const FRAME_INTERVAL_MS = 16; // ~60fps
+const COMPLETION_DELAY_MS = 500;
+// Wrapper component that drives 60fps render loop
+function SpanTreeWrapper({ state, renderer, serviceName, done, showDebug, }) {
+    const [, forceUpdate] = React.useState(0);
+    const openInEditor = React.useCallback((location) => {
+        const normalizedFile = location.file.startsWith("file://") ? fileURLToPath(location.file) : location.file;
+        if (!isAppPath(normalizedFile)) {
+            if (process.env.EFFECT_TUI_DEBUG_STACKS === "1") {
+                // eslint-disable-next-line no-console
+                console.error("[effect-tui] refusing to open non-app path", normalizedFile);
+            }
+            return;
+        }
+        const target = location.column !== undefined
+            ? `${normalizedFile}:${location.line}:${location.column}`
+            : `${normalizedFile}:${location.line}`;
+        const candidates = [
+            process.env.EFFECT_TUI_EDITOR ? `${process.env.EFFECT_TUI_EDITOR} ${target}` : null,
+            process.env.EDITOR ? `${process.env.EDITOR} ${target}` : null,
+            `code -g ${target}`,
+            `open ${target}`,
+            `xdg-open ${target}`,
+        ].filter(Boolean);
+        for (const cmd of candidates) {
+            try {
+                const child = spawn(cmd, { shell: true, stdio: "ignore", detached: true });
+                child.unref();
+                return;
+            }
+            catch {
+                // keep trying next candidate
+            }
+        }
+        // eslint-disable-next-line no-console
+        console.error("Could not launch editor. Set EFFECT_TUI_EDITOR or EDITOR to your preferred command.");
+    }, []);
+    React.useEffect(() => {
+        const interval = setInterval(() => {
+            state.tick();
+            forceUpdate((n) => n + 1);
+            renderer.requestRender();
+        }, FRAME_INTERVAL_MS);
+        return () => clearInterval(interval);
+    }, [renderer, state]);
+    // Handle keyboard
+    useKeyboard(React.useCallback((key) => {
+        // q quits when done (Ctrl+C always works via renderer)
+        if (done && key.text === "q") {
+            process.exit(0);
+        }
+        // Navigate between spans with logs
+        if (key.name === "up") {
+            state.selectPrev();
+        }
+        else if (key.name === "down") {
+            state.selectNext();
+        }
+        else if (key.name === "return" || key.name === "enter") {
+            // Toggle expand selected span's logs
+            state.toggleExpand();
+        }
+        else if (key.name === "char" && key.text?.toLowerCase() === "o") {
+            const loc = state.getOpenTarget();
+            if (loc) {
+                openInEditor(loc);
+            }
+            else {
+                state.toggleExpand();
+            }
+        }
+    }, [done, state, openInEditor]));
+    return (_jsxs("vstack", { spacing: 1, children: [_jsx(SpanTree, { state: state, spinnerIndex: state.spinnerIndex, serviceName: serviceName, showExitPrompt: done }), showDebug && _jsx(DiagnosticsPanel, { title: "Trace Diagnostics" })] }));
+}
+/**
+ * Run an Effect program with TUI visualization of OpenTelemetry spans.
+ *
+ * Shows a tree of spans as they execute, with spinners for in-progress
+ * and checkmarks/X for completed spans.
+ *
+ * @example
+ * ```ts
+ * const program = Effect.gen(function* () {
+ *   yield* Effect.sleep(1000).pipe(Effect.withSpan("step-1"))
+ *   yield* Effect.sleep(500).pipe(Effect.withSpan("step-2"))
+ * }).pipe(Effect.withSpan("main"))
+ *
+ * await traceVisualize(program)
+ * ```
+ */
+export const traceVisualize = (effect, options) => Effect.gen(function* () {
+    // Create state and processor
+    const state = new SpanTreeState();
+    // Create renderer - handles terminal setup (raw mode, keyboard)
+    const renderer = createRenderer({ mode: "inline" });
+    const root = createRoot(renderer);
+    // Connect processor to renderer
+    const requestRender = () => renderer.requestRender();
+    const processor = new TuiSpanProcessor(state, requestRender);
+    const serviceName = options?.serviceName ?? "effect-app";
+    const showDebug = options?.debugPanel ?? false;
+    // Create OpenTelemetry layer
+    const TracerLive = NodeSdk.layer(() => ({
+        resource: { serviceName },
+        spanProcessor: processor,
+    }));
+    // Create TUI logger that feeds into state (replaces console logger)
+    const tuiLogger = makeTuiLogger(state, requestRender);
+    const TuiLoggerLive = Logger.replace(Logger.defaultLogger, tuiLogger);
+    // Mount React component
+    root.render(_jsx(SpanTreeWrapper, { state: state, renderer: renderer, serviceName: serviceName, done: false, showDebug: showDebug }));
+    // Combine tracing layer with TUI logger
+    const Live = Layer.merge(TracerLive, TuiLoggerLive);
+    // Run the effect with tracing (ignore result, visualization shows success/failure)
+    yield* effect.pipe(Effect.provide(Live), Effect.ignore);
+    // Wait a bit for final render
+    yield* Effect.sleep(COMPLETION_DELAY_MS);
+    // Show exit prompt - component handles Enter keypress with process.exit(0)
+    root.render(_jsx(SpanTreeWrapper, { state: state, renderer: renderer, serviceName: serviceName, done: true, showDebug: showDebug }));
+    // Keep process alive until user presses Enter (component will call process.exit)
+    return yield* Effect.never;
+});
+//# sourceMappingURL=index.js.map

package/dist/src/trace/index.js.map

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