@effect-tui/react 0.1.0-alpha.1

package/dist/src/utils/border.js

@@ -0,0 +1,81 @@
+/**
+ * Border utilities shared between box and canvas hosts.
+ */
+/**
+ * Get border characters for a given border style.
+ * Returns empty strings for "none" (drawing code should skip when border is "none").
+ */
+export function borderChars(kind) {
+    switch (kind) {
+        case "rounded":
+            return { tl: "╭", tr: "╮", bl: "╰", br: "╯", h: "─", v: "│" };
+        case "square":
+            return { tl: "┌", tr: "┐", bl: "└", br: "┘", h: "─", v: "│" };
+        case "ascii":
+            return { tl: "+", tr: "+", bl: "+", br: "+", h: "-", v: "|" };
+        default:
+            return { tl: "", tr: "", bl: "", br: "", h: "", v: "" };
+    }
+}
+/**
+ * Draw a border around a rectangle.
+ * If clip is provided, only draws within the clip bounds (for canvas).
+ * If clip is not provided, draws the full border (for box).
+ */
+export function drawBorder(buffer, x, y, w, h, chars, style, clip) {
+    if (w < 2 || h < 2)
+        return;
+    const tlcp = chars.tl.codePointAt(0);
+    const trcp = chars.tr.codePointAt(0);
+    const blcp = chars.bl.codePointAt(0);
+    const brcp = chars.br.codePointAt(0);
+    const hcp = chars.h.codePointAt(0);
+    const vcp = chars.v.codePointAt(0);
+    if (clip) {
+        // Clipped drawing (for canvas)
+        const { ox, oy, w: cw, h: ch } = clip;
+        const inBounds = (px, py) => px >= ox && px < ox + cw && py >= oy && py < oy + ch;
+        // Corners
+        if (inBounds(x, y))
+            buffer.drawCP(x, y, tlcp, style);
+        if (inBounds(x + w - 1, y))
+            buffer.drawCP(x + w - 1, y, trcp, style);
+        if (inBounds(x, y + h - 1))
+            buffer.drawCP(x, y + h - 1, blcp, style);
+        if (inBounds(x + w - 1, y + h - 1))
+            buffer.drawCP(x + w - 1, y + h - 1, brcp, style);
+        // Horizontal lines
+        for (let col = 1; col < w - 1; col++) {
+            const xx = x + col;
+            if (inBounds(xx, y))
+                buffer.drawCP(xx, y, hcp, style);
+            if (inBounds(xx, y + h - 1))
+                buffer.drawCP(xx, y + h - 1, hcp, style);
+        }
+        // Vertical lines
+        for (let row = 1; row < h - 1; row++) {
+            const yy = y + row;
+            if (inBounds(x, yy))
+                buffer.drawCP(x, yy, vcp, style);
+            if (inBounds(x + w - 1, yy))
+                buffer.drawCP(x + w - 1, yy, vcp, style);
+        }
+    }
+    else {
+        // Full drawing (for box)
+        // Corners
+        buffer.drawCP(x, y, tlcp, style);
+        buffer.drawCP(x + w - 1, y, trcp, style);
+        buffer.drawCP(x, y + h - 1, blcp, style);
+        buffer.drawCP(x + w - 1, y + h - 1, brcp, style);
+        // Horizontal lines
+        buffer.fillRect(x + 1, y, w - 2, 1, hcp, style);
+        buffer.fillRect(x + 1, y + h - 1, w - 2, 1, hcp, style);
+        // Vertical lines
+        for (let yy = y + 1; yy < y + h - 1; yy++) {
+            buffer.drawCP(x, yy, vcp, style);
+            buffer.drawCP(x + w - 1, yy, vcp, style);
+        }
+    }
+}
+//# sourceMappingURL=border.js.map

package/dist/src/utils/border.js.map

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

package/dist/src/utils/flex-layout.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Generic flex layout algorithm for VStack and HStack.
+ */
+import type { HostInstance, Rect, Size } from "../reconciler/types.js";
+export type FlexAxis = "vertical" | "horizontal";
+export type FlexAlignment = "start" | "center" | "end";
+export interface FlexMeasureResult {
+    sizes: Size[];
+    totalSize: Size;
+}
+/**
+ * Measure children along a flex axis.
+ * Returns cached sizes and total size.
+ */
+export declare function measureFlex(axis: FlexAxis, children: HostInstance[], spacing: number, maxMain: number, maxCross: number): FlexMeasureResult;
+/**
+ * Layout children along a flex axis using cached sizes.
+ */
+export declare function layoutFlex(axis: FlexAxis, children: HostInstance[], cachedSizes: Size[], rect: Rect, spacing: number, alignment: FlexAlignment, stretchCross: boolean): void;
+//# sourceMappingURL=flex-layout.d.ts.map

package/dist/src/utils/flex-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flex-layout.d.ts","sourceRoot":"","sources":["../../../src/utils/flex-layout.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAA;AAGtE,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,YAAY,CAAA;AAChD,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAA;AAEtD,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,IAAI,EAAE,CAAA;IACb,SAAS,EAAE,IAAI,CAAA;CAChB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,QAAQ,EACd,QAAQ,EAAE,YAAY,EAAE,EACxB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,iBAAiB,CA2BnB;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,QAAQ,EACd,QAAQ,EAAE,YAAY,EAAE,EACxB,WAAW,EAAE,IAAI,EAAE,EACnB,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,aAAa,EACxB,YAAY,EAAE,OAAO,GACpB,IAAI,CA2DN"}

package/dist/src/utils/flex-layout.js

@@ -0,0 +1,85 @@
+/**
+ * Generic flex layout algorithm for VStack and HStack.
+ */
+/**
+ * Measure children along a flex axis.
+ * Returns cached sizes and total size.
+ */
+export function measureFlex(axis, children, spacing, maxMain, maxCross) {
+    const sizes = [];
+    let totalMain = 0;
+    let maxChildCross = 0;
+    for (let i = 0; i < children.length; i++) {
+        const child = children[i];
+        const remainingMain = Math.max(0, maxMain - totalMain);
+        // For vertical: maxW=maxCross, maxH=remainingMain
+        // For horizontal: maxW=remainingMain, maxH=maxCross
+        const [childMaxW, childMaxH] = axis === "vertical" ? [maxCross, remainingMain] : [remainingMain, maxCross];
+        const size = child.measure(childMaxW, childMaxH);
+        sizes.push(size);
+        const childMain = axis === "vertical" ? size.h : size.w;
+        const childCross = axis === "vertical" ? size.w : size.h;
+        totalMain += childMain;
+        if (i < children.length - 1)
+            totalMain += spacing;
+        maxChildCross = Math.max(maxChildCross, childCross);
+    }
+    const totalSize = axis === "vertical" ? { w: maxChildCross, h: totalMain } : { w: totalMain, h: maxChildCross };
+    return { sizes, totalSize };
+}
+/**
+ * Layout children along a flex axis using cached sizes.
+ */
+export function layoutFlex(axis, children, cachedSizes, rect, spacing, alignment, stretchCross) {
+    // Calculate totals
+    let totalNaturalMain = 0;
+    let totalFlexGrow = 0;
+    const totalSpacing = Math.max(0, (children.length - 1) * spacing);
+    for (let i = 0; i < children.length; i++) {
+        const child = children[i];
+        const size = cachedSizes[i] ?? child.measure(rect.w, rect.h);
+        const childMain = axis === "vertical" ? size.h : size.w;
+        totalNaturalMain += childMain;
+        totalFlexGrow += child.flexGrow ?? 0;
+    }
+    // Calculate extra space to distribute
+    const availableMain = axis === "vertical" ? rect.h : rect.w;
+    const extraSpace = Math.max(0, availableMain - totalNaturalMain - totalSpacing);
+    // Layout children
+    let mainPos = axis === "vertical" ? rect.y : rect.x;
+    for (let i = 0; i < children.length; i++) {
+        const child = children[i];
+        const size = cachedSizes[i] ?? { w: 0, h: 0 };
+        const flexGrow = child.flexGrow ?? 0;
+        const flexExtra = totalFlexGrow > 0 ? (extraSpace * flexGrow) / totalFlexGrow : 0;
+        const childMain = (axis === "vertical" ? size.h : size.w) + flexExtra;
+        const childCross = axis === "vertical" ? size.w : size.h;
+        const crossSize = axis === "vertical" ? rect.w : rect.h;
+        const crossStart = axis === "vertical" ? rect.x : rect.y;
+        // Calculate cross position based on alignment
+        let crossPos = crossStart;
+        if (alignment === "center") {
+            crossPos = crossStart + Math.floor((crossSize - childCross) / 2);
+        }
+        else if (alignment === "end") {
+            crossPos = crossStart + crossSize - childCross;
+        }
+        // Build child rect
+        const childRect = axis === "vertical"
+            ? {
+                x: crossPos,
+                y: mainPos,
+                w: stretchCross ? crossSize : childCross,
+                h: childMain,
+            }
+            : {
+                x: mainPos,
+                y: crossPos,
+                w: childMain,
+                h: stretchCross ? crossSize : childCross,
+            };
+        child.layout(childRect);
+        mainPos += childMain + spacing;
+    }
+}
+//# sourceMappingURL=flex-layout.js.map

package/dist/src/utils/flex-layout.js.map

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

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

@@ -0,0 +1,5 @@
+export { type BorderKind, type BorderChars, borderChars, type ClipRect, drawBorder } from "./border.js";
+export { type Padding, type PaddingInput, resolvePadding } from "./padding.js";
+export { type StyleOptions } from "./styles.js";
+export { type FlexAxis, type FlexAlignment, type FlexMeasureResult, measureFlex, layoutFlex } from "./flex-layout.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,WAAW,EAAE,WAAW,EAAE,KAAK,QAAQ,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACvG,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC9E,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,aAAa,EAAE,KAAK,iBAAiB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/src/utils/index.js

@@ -0,0 +1,5 @@
+export { borderChars, drawBorder } from "./border.js";
+export { resolvePadding } from "./padding.js";
+export {} from "./styles.js";
+export { measureFlex, layoutFlex } from "./flex-layout.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqC,WAAW,EAAiB,UAAU,EAAE,MAAM,aAAa,CAAA;AACvG,OAAO,EAAmC,cAAc,EAAE,MAAM,cAAc,CAAA;AAC9E,OAAO,EAAqB,MAAM,aAAa,CAAA;AAC/C,OAAO,EAA6D,WAAW,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/src/utils/padding.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Padding utilities shared between box, canvas, and codeblock hosts.
+ */
+export interface Padding {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+}
+export type PaddingInput = number | {
+    x?: number;
+    y?: number;
+    top?: number;
+    right?: number;
+    bottom?: number;
+    left?: number;
+};
+/**
+ * Resolve padding input to a normalized Padding object.
+ * Supports:
+ * - number: uniform padding on all sides
+ * - { x, y }: horizontal and vertical padding
+ * - { top, right, bottom, left }: individual sides
+ */
+export declare function resolvePadding(p?: PaddingInput): Padding;
+//# sourceMappingURL=padding.d.ts.map

package/dist/src/utils/padding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"padding.d.ts","sourceRoot":"","sources":["../../../src/utils/padding.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,MAAM,YAAY,GACpB,MAAM,GACN;IAAE,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAE5F;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,CAAC,CAAC,EAAE,YAAY,GAAG,OAAO,CAsBxD"}

package/dist/src/utils/padding.js

@@ -0,0 +1,34 @@
+/**
+ * Padding utilities shared between box, canvas, and codeblock hosts.
+ */
+/**
+ * Resolve padding input to a normalized Padding object.
+ * Supports:
+ * - number: uniform padding on all sides
+ * - { x, y }: horizontal and vertical padding
+ * - { top, right, bottom, left }: individual sides
+ */
+export function resolvePadding(p) {
+    if (p === undefined) {
+        return { top: 0, right: 0, bottom: 0, left: 0 };
+    }
+    if (typeof p === "number") {
+        return { top: p, right: p, bottom: p, left: p };
+    }
+    // x/y shorthand takes precedence if specified
+    if (p.x !== undefined || p.y !== undefined) {
+        return {
+            top: p.y ?? 0,
+            bottom: p.y ?? 0,
+            left: p.x ?? 0,
+            right: p.x ?? 0,
+        };
+    }
+    return {
+        top: p.top ?? 0,
+        right: p.right ?? 0,
+        bottom: p.bottom ?? 0,
+        left: p.left ?? 0,
+    };
+}
+//# sourceMappingURL=padding.js.map

package/dist/src/utils/padding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"padding.js","sourceRoot":"","sources":["../../../src/utils/padding.ts"],"names":[],"mappings":"AAAA;;GAEG;AAaH;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,CAAgB;IAC7C,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;QACpB,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAA;IACjD,CAAC;IACD,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC1B,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAA;IACjD,CAAC;IACD,8CAA8C;IAC9C,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;QAC3C,OAAO;YACL,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YACb,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YAChB,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YACd,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;SAChB,CAAA;IACH,CAAC;IACD,OAAO;QACL,GAAG,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;QACf,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC;QACnB,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC;QACrB,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC;KAClB,CAAA;AACH,CAAC"}

package/dist/src/utils/styles.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Style utilities for building palette-compatible style objects.
+ */
+import type { ColorValue } from "@effect-tui/core";
+export interface StyleOptions {
+    fg?: ColorValue;
+    bg?: ColorValue;
+    bold?: boolean;
+    italic?: boolean;
+    underline?: boolean;
+    inverse?: boolean;
+}
+//# sourceMappingURL=styles.d.ts.map

package/dist/src/utils/styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../src/utils/styles.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAElD,MAAM,WAAW,YAAY;IAC3B,EAAE,CAAC,EAAE,UAAU,CAAA;IACf,EAAE,CAAC,EAAE,UAAU,CAAA;IACf,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB"}

package/dist/src/utils/styles.js

@@ -0,0 +1,5 @@
+/**
+ * Style utilities for building palette-compatible style objects.
+ */
+export {};
+//# sourceMappingURL=styles.js.map

package/dist/src/utils/styles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.js","sourceRoot":"","sources":["../../../src/utils/styles.ts"],"names":[],"mappings":"AAAA;;GAEG"}

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

@@ -0,0 +1,50 @@
+import { Context, Effect, Layer } from "effect";
+interface VisualizeOptions {
+    /** Show the result value below completion status */
+    showResult?: boolean;
+}
+interface InlineRendererService {
+    readonly stdout: NodeJS.WriteStream;
+    readonly stdin: NodeJS.ReadStream;
+}
+declare const InlineRenderer_base: Context.TagClass<InlineRenderer, "@effect-tui/react/InlineRenderer", InlineRendererService>;
+/**
+ * Service that manages terminal state for inline rendering.
+ * Hides cursor on acquire, shows cursor on release.
+ */
+export declare class InlineRenderer extends InlineRenderer_base {
+}
+/**
+ * Layer that provides InlineRenderer service.
+ * Manages terminal state: hides cursor on start, restores on finalize.
+ */
+export declare const InlineRendererLive: Layer.Layer<InlineRenderer>;
+/**
+ * Wrap an Effect with inline visualization.
+ * Shows a spinner while running, then success/failure status.
+ * Returns the effect's result or propagates its error.
+ *
+ * Requires InlineRenderer service (use InlineRendererLive layer).
+ *
+ * @example
+ * ```ts
+ * const program = Effect.gen(function* () {
+ *   const result = yield* visualize("Fetching data", fetchData)
+ *   yield* visualize("Processing", processData(result))
+ * }).pipe(Effect.provide(InlineRendererLive))
+ * ```
+ */
+export declare const visualize: <A, E, R>(label: string, effect: Effect.Effect<A, E, R>, options?: VisualizeOptions) => Effect.Effect<A, E, R | InlineRenderer>;
+/**
+ * Self-contained visualize that manages its own terminal state.
+ * Use this for single visualize() calls. For multiple sequential calls,
+ * use visualize() with InlineRendererLive layer for better cursor handling.
+ *
+ * @example
+ * ```ts
+ * const result = yield* visualizeSingle("Fetching data", fetchData)
+ * ```
+ */
+export declare const visualizeSingle: <A, E, R>(label: string, effect: Effect.Effect<A, E, R>, options?: VisualizeOptions) => Effect.Effect<A, E, R>;
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/visualize/index.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAS,OAAO,EAAY,MAAM,EAAe,KAAK,EAAU,MAAM,QAAQ,CAAA;AAYrF,UAAU,gBAAgB;IACxB,oDAAoD;IACpD,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB;AA2HD,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,WAAW,CAAA;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,UAAU,CAAA;CAClC;;AAED;;;GAGG;AACH,qBAAa,cAAe,SAAQ,mBAGjC;CAAG;AAEN;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,KAAK,CAAC,KAAK,CAAC,cAAc,CA2B1D,CAAA;AAMD;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,SAAS,GAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAC/B,OAAO,MAAM,EACb,QAAQ,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAC9B,UAAU,gBAAgB,KACzB,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,cAAc,CAuErC,CAAA;AAMJ;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EACrC,OAAO,MAAM,EACb,QAAQ,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAC9B,UAAU,gBAAgB,KACzB,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAC6F,CAAA"}

package/dist/src/visualize/index.js

@@ -0,0 +1,194 @@
+import { jsx as _jsx, jsxs as _jsxs } from "@effect-tui/react/jsx-runtime";
+// Effect visualization wrapper using React
+// Uses Effect Layer for proper terminal state management across multiple calls
+import { useState, useEffect } from "react";
+import { Cause, Context, Duration, Effect, Exit, Fiber, Layer, Option } from "effect";
+import { Colors } from "@effect-tui/core";
+import { createRenderer, createRoot } from "../renderer.js";
+import { ANSI } from "../terminal.js";
+const SPINNER_FRAMES = ["⠋", "⠙", "⠸", "⠴", "⠦", "⠇"];
+const SPIN_INTERVAL_MS = 80;
+const ELAPSED_INTERVAL_MS = 16;
+const COMPLETION_DELAY_MS = 360;
+// Bridges Effect execution with React rendering
+class VisualizerState {
+    status = "pending";
+    spinnerIndex = 0;
+    elapsedMs = 0;
+    errorSummary;
+    result;
+    showResult = false;
+    listeners = new Set();
+    update(patch) {
+        Object.assign(this, patch);
+        this.listeners.forEach((l) => l());
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+}
+const formatDuration = (ms) => Duration.format(Duration.millis(Math.max(0, Math.round(ms))));
+const formatResult = (value) => {
+    if (value === undefined)
+        return "undefined";
+    if (value === null)
+        return "null";
+    if (typeof value === "string")
+        return JSON.stringify(value);
+    if (typeof value === "number" || typeof value === "boolean")
+        return String(value);
+    try {
+        return JSON.stringify(value);
+    }
+    catch {
+        return String(value);
+    }
+};
+const summarizeCause = (cause) => {
+    const failure = Cause.failureOption(cause);
+    if (Option.isSome(failure)) {
+        const error = failure.value;
+        if (error && typeof error === "object" && "_tag" in error && "message" in error) {
+            const message = String(error.message).trim();
+            return message ? `${error._tag}: ${message}` : String(error._tag);
+        }
+        if (error && typeof error === "object" && "message" in error) {
+            return String(error.message);
+        }
+        return String(error);
+    }
+    const pretty = Cause.pretty(cause, { renderErrorCause: false });
+    const firstLine = pretty.split("\n").find((line) => line.trim().length > 0);
+    return firstLine ?? "Unknown failure";
+};
+function Visualizer({ state, label }) {
+    const [, forceUpdate] = useState(0);
+    useEffect(() => {
+        return state.subscribe(() => forceUpdate((n) => n + 1));
+    }, [state]);
+    const elapsed = formatDuration(state.elapsedMs);
+    if (state.status === "pending") {
+        return (_jsxs("vstack", { children: [_jsxs("hstack", { spacing: 1, children: [_jsx("text", { fg: Colors.brightCyan, children: SPINNER_FRAMES[state.spinnerIndex] }), _jsx("text", { bold: true, fg: Colors.brightWhite, children: label })] }), _jsxs("text", { fg: Colors.gray(10), children: ["\u2514 Running\u2026 ", elapsed] })] }));
+    }
+    if (state.status === "success") {
+        const showingResult = state.showResult && state.result !== undefined;
+        return (_jsxs("vstack", { children: [_jsxs("hstack", { spacing: 1, children: [_jsx("text", { bold: true, fg: Colors.brightGreen, children: "\u2713" }), _jsx("text", { bold: true, fg: Colors.brightGreen, children: label })] }), showingResult && _jsxs("text", { fg: Colors.gray(20), children: ["\u251C ", formatResult(state.result)] }), _jsxs("text", { fg: Colors.green, children: [showingResult ? "└" : "└", " Completed in ", elapsed] })] }));
+    }
+    // failure
+    return (_jsxs("vstack", { children: [_jsxs("hstack", { spacing: 1, children: [_jsx("text", { bold: true, fg: Colors.brightRed, children: "\u2717" }), _jsx("text", { bold: true, fg: Colors.brightRed, children: label })] }), _jsxs("text", { fg: Colors.red, children: ["\u251C ", state.errorSummary ?? "Failed"] }), _jsxs("text", { fg: Colors.red, children: ["\u2514 Failed after ", elapsed] })] }));
+}
+/**
+ * Service that manages terminal state for inline rendering.
+ * Hides cursor on acquire, shows cursor on release.
+ */
+export class InlineRenderer extends Context.Tag("@effect-tui/react/InlineRenderer")() {
+}
+/**
+ * Layer that provides InlineRenderer service.
+ * Manages terminal state: hides cursor on start, restores on finalize.
+ */
+export const InlineRendererLive = Layer.scoped(InlineRenderer, Effect.gen(function* () {
+    const stdout = process.stdout;
+    const stdin = process.stdin;
+    // Setup: hide cursor, enable raw mode
+    stdout.write(ANSI.cursor.hide);
+    if (stdin.isTTY && stdin.setRawMode) {
+        stdin.setRawMode(true);
+        stdin.resume();
+    }
+    // Teardown on scope close: show cursor, disable raw mode, pause stdin
+    yield* Effect.addFinalizer(() => Effect.sync(() => {
+        stdout.write(ANSI.cursor.show);
+        if (stdin.isTTY && stdin.setRawMode) {
+            stdin.setRawMode(false);
+        }
+        // Pause stdin so Node can exit
+        stdin.pause();
+    }));
+    return { stdout, stdin };
+}));
+// ============================================================================
+// visualize() - uses InlineRenderer service
+// ============================================================================
+/**
+ * Wrap an Effect with inline visualization.
+ * Shows a spinner while running, then success/failure status.
+ * Returns the effect's result or propagates its error.
+ *
+ * Requires InlineRenderer service (use InlineRendererLive layer).
+ *
+ * @example
+ * ```ts
+ * const program = Effect.gen(function* () {
+ *   const result = yield* visualize("Fetching data", fetchData)
+ *   yield* visualize("Processing", processData(result))
+ * }).pipe(Effect.provide(InlineRendererLive))
+ * ```
+ */
+export const visualize = (label, effect, options) => Effect.gen(function* () {
+    const { stdout, stdin } = yield* InlineRenderer;
+    // Create renderer with skipTerminalSetup (Layer manages terminal state)
+    const renderer = createRenderer({
+        mode: "inline",
+        stdout,
+        stdin,
+        skipTerminalSetup: true,
+    });
+    const root = createRoot(renderer);
+    const state = new VisualizerState();
+    state.showResult = options?.showResult ?? false;
+    // Mount React component
+    root.render(_jsx(Visualizer, { state: state, label: label }));
+    // Spinner tick fiber
+    const startTime = Date.now();
+    const spinnerFiber = yield* Effect.fork(Effect.forever(Effect.gen(function* () {
+        yield* Effect.sleep(SPIN_INTERVAL_MS);
+        state.update({
+            spinnerIndex: (state.spinnerIndex + 1) % SPINNER_FRAMES.length,
+        });
+        renderer.requestRender();
+    })));
+    // High-frequency elapsed timer so duration display stays smooth
+    const elapsedFiber = yield* Effect.fork(Effect.forever(Effect.gen(function* () {
+        yield* Effect.sleep(ELAPSED_INTERVAL_MS);
+        state.update({ elapsedMs: Date.now() - startTime });
+        renderer.requestRender();
+    })));
+    // Run the actual effect
+    const exit = yield* Effect.exit(effect);
+    // Stop spinner, update state to final
+    yield* Fiber.interrupt(spinnerFiber);
+    yield* Fiber.interrupt(elapsedFiber);
+    const isSuccess = Exit.isSuccess(exit);
+    state.update(isSuccess
+        ? { status: "success", elapsedMs: Date.now() - startTime, result: exit.value }
+        : { status: "failure", elapsedMs: Date.now() - startTime, errorSummary: summarizeCause(exit.cause) });
+    renderer.requestRender();
+    renderer.flush(); // Ensure final state is rendered
+    // Wait for completion animation
+    yield* Effect.sleep(COMPLETION_DELAY_MS);
+    // Stop renderer (doesn't touch terminal state since skipTerminalSetup)
+    renderer.stop();
+    // Write newline to advance cursor past the output
+    stdout.write("\n");
+    // Return result or propagate failure
+    if (Exit.isSuccess(exit))
+        return exit.value;
+    return yield* Effect.failCause(exit.cause);
+});
+// ============================================================================
+// Convenience: self-contained visualize that provides its own layer
+// ============================================================================
+/**
+ * Self-contained visualize that manages its own terminal state.
+ * Use this for single visualize() calls. For multiple sequential calls,
+ * use visualize() with InlineRendererLive layer for better cursor handling.
+ *
+ * @example
+ * ```ts
+ * const result = yield* visualizeSingle("Fetching data", fetchData)
+ * ```
+ */
+export const visualizeSingle = (label, effect, options) => Effect.scoped(visualize(label, effect, options).pipe(Effect.provide(InlineRendererLive)));
+//# sourceMappingURL=index.js.map

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

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