@effect-tui/react 0.1.0-alpha.1

package/dist/src/reconciler/host-config.d.ts

@@ -0,0 +1,16 @@
+import Reconciler from "react-reconciler";
+import type { HostInstance, HostContext } from "./types.js";
+/** Container is the root of our host tree */
+export interface Container {
+    root: HostInstance | null;
+    ctx: HostContext;
+}
+export declare const reconciler: Reconciler.Reconciler<unknown, unknown, unknown, unknown, unknown, unknown>;
+export declare const flushPassiveEffects: (() => boolean) & (() => void);
+export declare const flushSync: {
+    (): void;
+    <R>(fn: () => R): R;
+} & (<T>(fn?: () => T) => T);
+export declare const batchedUpdates: (<A, R>(fn: (a: A) => R, a: A) => R) & (<T>(fn: () => T) => T);
+export declare const discreteUpdates: (<A, B, C, D, R>(fn: (arg0: A, arg1: B, arg2: C, arg3: D) => R, a: A, b: B, c: C, d: D) => R) & (<T>(fn: () => T) => T);
+//# sourceMappingURL=host-config.d.ts.map

package/dist/src/reconciler/host-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-config.d.ts","sourceRoot":"","sources":["../../../src/reconciler/host-config.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,kBAAkB,CAAA;AAEzC,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAO3D,6CAA6C;AAC7C,MAAM,WAAW,SAAS;IACzB,IAAI,EAAE,YAAY,GAAG,IAAI,CAAA;IACzB,GAAG,EAAE,WAAW,CAAA;CAChB;AAoPD,eAAO,MAAM,UAAU,6EAAgC,CAAA;AAgBvD,eAAO,MAAM,mBAAmB,2BARH,IAAI,CAQ8C,CAAA;AAC/E,eAAO,MAAM,SAAS;;;MARR,CAAC,OAAO,MAAM,CAAC,KAAK,CAAC,CAQ2C,CAAA;AAC9E,eAAO,MAAM,cAAc,2CARR,CAAC,MAAM,MAAM,CAAC,KAAK,CAAC,CAQ8C,CAAA;AACrF,eAAO,MAAM,eAAe,oGARR,CAAC,MAAM,MAAM,CAAC,KAAK,CAAC,CAQ+C,CAAA"}

package/dist/src/reconciler/host-config.js

@@ -0,0 +1,174 @@
+import Reconciler from "react-reconciler";
+import { createContext } from "react";
+import { createHostInstance, createTextInstance } from "../hosts/index.js";
+// ============================================================================
+// Priority Management
+// ============================================================================
+const NoEventPriority = 0;
+const DefaultEventPriority = 16;
+let currentUpdatePriority = NoEventPriority;
+// ============================================================================
+// Host Config
+// ============================================================================
+// Note: We define methods with proper types but cast the final config to any
+// because react-reconciler's HostConfig type has ~80 required methods and
+// changes frequently between versions. This gives us type safety within
+// each method while avoiding type compatibility issues with the reconciler.
+const hostConfig = {
+    supportsMutation: true,
+    supportsPersistence: false,
+    supportsHydration: false,
+    createInstance(type, props, rootContainer) {
+        return createHostInstance(type, props, rootContainer.ctx);
+    },
+    appendChild(parent, child) {
+        parent.appendChild(child);
+    },
+    removeChild(parent, child) {
+        parent.removeChild(child);
+        child.destroy();
+    },
+    insertBefore(parent, child, beforeChild) {
+        parent.insertBefore(child, beforeChild);
+    },
+    insertInContainerBefore(container, child, beforeChild) {
+        if (container.root) {
+            container.root.insertBefore(child, beforeChild);
+        }
+    },
+    removeChildFromContainer(container, child) {
+        if (container.root) {
+            container.root.removeChild(child);
+            child.destroy();
+        }
+    },
+    prepareForCommit() {
+        return null;
+    },
+    resetAfterCommit(container) {
+        container.ctx.requestRender();
+    },
+    getRootHostContext() {
+        return { isInsideText: false };
+    },
+    getChildHostContext(parentHostContext, type) {
+        const isInsideText = type === "text" || parentHostContext.isInsideText;
+        return { ...parentHostContext, isInsideText };
+    },
+    shouldSetTextContent() {
+        return false;
+    },
+    createTextInstance(text, rootContainer, hostContext) {
+        // Raw text nodes are only valid inside <text> elements
+        if (!hostContext.isInsideText) {
+            console.warn("Text nodes should be inside <text> elements");
+        }
+        return createTextInstance(text, rootContainer.ctx);
+    },
+    scheduleTimeout: setTimeout,
+    cancelTimeout: clearTimeout,
+    noTimeout: -1,
+    shouldAttemptEagerTransition() {
+        return false;
+    },
+    finalizeInitialChildren(instance, _type, props) {
+        instance.updateProps(props);
+        return false;
+    },
+    commitMount() {
+        // Could handle focus here
+    },
+    commitUpdate(instance, _updatePayload, _type, _oldProps, newProps) {
+        // Handle case where newProps might be a Fiber node (react-reconciler API varies)
+        const props = newProps.pendingProps ??
+            newProps.memoizedProps ??
+            newProps;
+        instance.updateProps(props);
+    },
+    commitTextUpdate(textInstance, _oldText, newText) {
+        textInstance.updateText(newText);
+    },
+    appendChildToContainer(container, child) {
+        // The first child becomes the root
+        container.root = child;
+        child.parent = null;
+    },
+    appendInitialChild(parent, child) {
+        parent.appendChild(child);
+    },
+    hideInstance() {
+        // Could implement visibility
+    },
+    unhideInstance() {
+        // Could implement visibility
+    },
+    hideTextInstance() { },
+    unhideTextInstance() { },
+    clearContainer(container) {
+        container.root = null;
+    },
+    setCurrentUpdatePriority(newPriority) {
+        currentUpdatePriority = newPriority;
+    },
+    getCurrentUpdatePriority: () => currentUpdatePriority,
+    resolveUpdatePriority() {
+        if (currentUpdatePriority !== NoEventPriority) {
+            return currentUpdatePriority;
+        }
+        return DefaultEventPriority;
+    },
+    maySuspendCommit() {
+        return false;
+    },
+    NotPendingTransition: null,
+    HostTransitionContext: createContext(null),
+    resetFormInstance() { },
+    requestPostPaintCallback() { },
+    trackSchedulerEvent() { },
+    resolveEventType() {
+        return null;
+    },
+    resolveEventTimeStamp() {
+        return -1.1;
+    },
+    preloadInstance() {
+        return true;
+    },
+    startSuspendingCommit() { },
+    suspendInstance() { },
+    waitForCommitToBeReady() {
+        return null;
+    },
+    detachDeletedInstance(instance) {
+        if (!instance.parent) {
+            instance.destroy();
+        }
+    },
+    getPublicInstance(instance) {
+        return instance;
+    },
+    preparePortalMount() { },
+    isPrimaryRenderer: true,
+    getInstanceFromNode() {
+        return null;
+    },
+    beforeActiveInstanceBlur() { },
+    afterActiveInstanceBlur() { },
+    prepareScopeUpdate() { },
+    getInstanceFromScope() {
+        return null;
+    },
+    prepareUpdate() {
+        return true;
+    },
+};
+// Cast to any at the boundary - the config is internally typed but
+// react-reconciler's generic constraints are too strict for real-world usage
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export const reconciler = Reconciler(hostConfig);
+const r = reconciler;
+export const flushPassiveEffects = r.flushPassiveEffects?.bind(r) ?? (() => { });
+export const flushSync = r.flushSync?.bind(r) ?? ((fn) => fn?.());
+export const batchedUpdates = r.batchedUpdates?.bind(r) ?? ((fn) => fn());
+export const discreteUpdates = r.discreteUpdates?.bind(r) ?? ((fn) => fn());
+//# sourceMappingURL=host-config.js.map

package/dist/src/reconciler/host-config.js.map

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

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

@@ -0,0 +1,52 @@
+import type { CellBuffer, Palette } from "@effect-tui/core";
+export interface Rect {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+export interface Size {
+    w: number;
+    h: number;
+}
+export interface HostInstance {
+    /** Unique identifier */
+    id: string;
+    /** Component type name */
+    type: string;
+    /** Parent in tree */
+    parent: HostInstance | null;
+    /** Children in tree */
+    children: HostInstance[];
+    /** Computed layout rect (set during layout phase) */
+    rect: Rect | null;
+    /** Measure natural size given constraints */
+    measure(maxW: number, maxH: number): Size;
+    /** Assign final rect and layout children */
+    layout(rect: Rect): void;
+    /** Render to buffer */
+    render(buffer: CellBuffer, palette: Palette): void;
+    /** Update props from React */
+    updateProps(props: Record<string, unknown>): void;
+    /** Cleanup on unmount */
+    destroy(): void;
+    /** Add child */
+    appendChild(child: HostInstance): void;
+    /** Remove child */
+    removeChild(child: HostInstance): void;
+    /** Insert child before another */
+    insertBefore(child: HostInstance, before: HostInstance): void;
+}
+export interface HostContext {
+    requestRender(): void;
+}
+/** Props common to all host components */
+export interface CommonProps {
+    /** Flex grow factor */
+    flexGrow?: number;
+    /** Flex shrink factor */
+    flexShrink?: number;
+    /** Index signature for Record<string, unknown> compatibility */
+    [key: string]: unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/reconciler/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/reconciler/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAE3D,MAAM,WAAW,IAAI;IACnB,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;CACV;AAED,MAAM,WAAW,IAAI;IACnB,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;CACV;AAED,MAAM,WAAW,YAAY;IAC3B,wBAAwB;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAA;IAEZ,qBAAqB;IACrB,MAAM,EAAE,YAAY,GAAG,IAAI,CAAA;IAC3B,uBAAuB;IACvB,QAAQ,EAAE,YAAY,EAAE,CAAA;IAExB,qDAAqD;IACrD,IAAI,EAAE,IAAI,GAAG,IAAI,CAAA;IAEjB,6CAA6C;IAC7C,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAEzC,4CAA4C;IAC5C,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAA;IAExB,uBAAuB;IACvB,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAA;IAElD,8BAA8B;IAC9B,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;IAEjD,yBAAyB;IACzB,OAAO,IAAI,IAAI,CAAA;IAEf,gBAAgB;IAChB,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAA;IAEtC,mBAAmB;IACnB,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAA;IAEtC,kCAAkC;IAClC,YAAY,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAAA;CAC9D;AAED,MAAM,WAAW,WAAW;IAC1B,aAAa,IAAI,IAAI,CAAA;CACtB;AAED,0CAA0C;AAC1C,MAAM,WAAW,WAAW;IAC1B,uBAAuB;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,yBAAyB;IACzB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,gEAAgE;IAChE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB"}

package/dist/src/reconciler/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/reconciler/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/reconciler/types.ts"],"names":[],"mappings":""}

package/dist/src/renderer.d.ts

@@ -0,0 +1,101 @@
+import React, { type ReactNode } from "react";
+import { type KeyMsg } from "@effect-tui/core";
+/** Minimal write stream interface for renderer output */
+export interface TuiWriteStream {
+    write(s: string): void;
+    columns: number;
+    rows: number;
+    on(event: string, cb: () => void): void;
+}
+/** Minimal read stream interface for renderer input */
+export interface TuiReadStream {
+    isTTY?: boolean;
+    setRawMode?(mode: boolean): void;
+    resume?(): void;
+    on(event: string, cb: (data: Buffer) => void): void;
+}
+export interface TuiRenderer {
+    /** Terminal width */
+    width: number;
+    /** Terminal height */
+    height: number;
+    /** Request a re-render */
+    requestRender(): void;
+    /** Subscribe to per-frame stats (if enabled). */
+    onFrameStats?(handler: (stats: FrameStats) => void): () => void;
+    /** Subscribe to keyboard events */
+    onKey(handler: (key: KeyMsg) => void): () => void;
+    /** Subscribe to paste events (bracketed paste mode). */
+    onPaste?(handler: (text: string) => void): () => void;
+    /** Subscribe to resize events */
+    onResize(handler: (width: number, height: number) => void): () => void;
+    /** Stop the renderer */
+    stop(): void;
+    /** Manually trigger one render frame (only in manualMode) */
+    flush(): void;
+}
+export declare const RendererContext: React.Context<TuiRenderer | null>;
+export declare function useRenderer(): TuiRenderer;
+/** Hook that returns terminal size and re-renders on resize */
+export declare function useTerminalSize(): {
+    width: number;
+    height: number;
+};
+export interface RendererOptions {
+    fps?: number;
+    stdout?: NodeJS.WriteStream | TuiWriteStream;
+    stdin?: NodeJS.ReadStream | TuiReadStream;
+    /** Render mode: "fullscreen" uses alternate buffer, "inline" renders in-place */
+    mode?: "fullscreen" | "inline";
+    /** Exit the process on Ctrl+C unless preventDefault was called. Defaults to true. */
+    exitOnCtrlC?: boolean;
+    /** Enable diffed rendering (per-line). Defaults to true in runtime, false in manualMode (tests). */
+    diff?: boolean;
+    /** Enable diffed rendering for inline mode (off by default; eraseLines baseline). */
+    diffInline?: boolean;
+    /** Skip automatic render loop. Call flush() manually to render frames. */
+    manualMode?: boolean;
+    /** Skip fullscreen/raw mode setup (for testing) */
+    skipTerminalSetup?: boolean;
+    /** Enable bracketed paste (default true). */
+    enablePaste?: boolean;
+    /** Optional per-frame diagnostics hook. Called after each frame is written. */
+    debug?: {
+        onFrame?: (stats: FrameStats) => void;
+    };
+}
+export interface FrameStats {
+    mode: "fullscreen" | "inline";
+    width: number;
+    height: number;
+    contentHeight: number;
+    bytes: number;
+    frameMs: number;
+    phases: {
+        clear: number;
+        layout: number;
+        render: number;
+        diffAnsi: number;
+        write: number;
+    };
+    timestamp: number;
+}
+export declare function createRenderer(options?: RendererOptions): TuiRenderer;
+export interface Root {
+    render(element: ReactNode, sync?: boolean): void;
+    unmount(): void;
+}
+export declare function createRoot(renderer: TuiRenderer): Root;
+export interface RenderInstance {
+    renderer: TuiRenderer;
+    root: Root;
+    rerender(element: ReactNode): void;
+    unmount(): void;
+    waitUntilExit(): Promise<void>;
+}
+/**
+ * Render a React tree to the terminal in one call.
+ * Returns helpers similar to Ink: rerender, unmount, waitUntilExit.
+ */
+export declare function render(element: ReactNode, options?: RendererOptions): RenderInstance;
+//# sourceMappingURL=renderer.d.ts.map

package/dist/src/renderer.d.ts.map

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