@effect-tui/core 0.1.0-alpha.1

package/dist/layout/linearStack.js

@@ -0,0 +1,86 @@
+// linearStack.ts — SwiftUI-like linear stacks with flexible children
+/** flexBase[i] = null for fixed, or the child's base main-size for flexible. */
+export function measureLinear(axis, maxW, maxH, spacing, sizes, flexBase) {
+    const n = sizes.length;
+    const gaps = Math.max(0, n - 1) * Math.max(0, spacing);
+    let mainSum = 0;
+    let crossMax = 0;
+    let hasFlex = false;
+    for (let i = 0; i < n; i++) {
+        const s = sizes[i];
+        if (!s)
+            continue;
+        const main = axis === "horizontal" ? s.w : s.h;
+        const cross = axis === "horizontal" ? s.h : s.w;
+        crossMax = Math.max(crossMax, cross);
+        hasFlex ||= flexBase[i] != null;
+        mainSum += flexBase[i] ?? main;
+    }
+    const maxMain = axis === "horizontal" ? maxW : maxH;
+    const totalMain = hasFlex ? maxMain : Math.min(maxMain, mainSum + gaps);
+    return axis === "horizontal"
+        ? { w: Math.min(maxW, totalMain), h: Math.min(maxH, crossMax) }
+        : { w: Math.min(maxW, crossMax), h: Math.min(maxH, totalMain) };
+}
+export function layoutLinear(axis, rect, spacing, crossAlign, sizes, flexBase) {
+    const n = sizes.length;
+    const out = new Array(n);
+    const gaps = Math.max(0, n - 1) * Math.max(0, spacing);
+    const mainAvail = axis === "horizontal" ? rect.w : rect.h;
+    const crossAvail = axis === "horizontal" ? rect.h : rect.w;
+    let baseSum = 0;
+    let flexCount = 0;
+    for (let i = 0; i < n; i++) {
+        if (flexBase[i] != null) {
+            baseSum += flexBase[i];
+            flexCount++;
+        }
+        else {
+            const size = sizes[i];
+            if (size) {
+                baseSum += axis === "horizontal" ? size.w : size.h;
+            }
+        }
+    }
+    const leftover = Math.max(0, mainAvail - baseSum - gaps);
+    const per = flexCount > 0 ? Math.floor(leftover / flexCount) : 0;
+    let rem = flexCount > 0 ? leftover - per * flexCount : 0;
+    const crossOffset = (childCross) => {
+        if (crossAlign === "center")
+            return Math.floor((crossAvail - childCross) / 2);
+        if ((crossAlign === "trailing" && axis === "vertical") || (crossAlign === "bottom" && axis === "horizontal"))
+            return Math.max(0, crossAvail - childCross);
+        return 0;
+    };
+    let pos = 0;
+    for (let i = 0; i < n; i++) {
+        const s = sizes[i];
+        if (!s)
+            continue;
+        const baseMain = flexBase[i] ?? (axis === "horizontal" ? s.w : s.h);
+        const flexExtra = flexBase[i] != null ? per + (rem > 0 ? (rem--, 1) : 0) : 0;
+        const wantMain = baseMain + flexExtra;
+        const childCross = Math.min(crossAvail, axis === "horizontal" ? s.h : s.w);
+        const remaining = Math.max(0, mainAvail - pos);
+        const takeMain = Math.min(wantMain, remaining);
+        const cs = crossOffset(childCross);
+        out[i] =
+            axis === "horizontal"
+                ? { x: rect.x + pos, y: rect.y + cs, w: Math.max(0, takeMain), h: Math.max(0, childCross) }
+                : { x: rect.x + cs, y: rect.y + pos, w: Math.max(0, childCross), h: Math.max(0, takeMain) };
+        pos += takeMain;
+        if (i < n - 1)
+            pos += spacing;
+        if (pos >= mainAvail) {
+            for (let j = i + 1; j < n; j++) {
+                out[j] =
+                    axis === "horizontal"
+                        ? { x: rect.x + mainAvail, y: rect.y, w: 0, h: 0 }
+                        : { x: rect.x, y: rect.y + mainAvail, w: 0, h: 0 };
+            }
+            break;
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=linearStack.js.map

package/dist/layout/linearStack.js.map

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

package/dist/motion-value.d.ts

@@ -0,0 +1,58 @@
+import type { ColorLike, ColorValue } from "./render/surface.js";
+import { type SpringConfig } from "./spring-physics.js";
+export type SpringOptions = SpringConfig & {
+    maxDt?: number;
+};
+export type Unsubscribe = () => void;
+export interface AnimationControls {
+    readonly time: number;
+    readonly speed: number;
+    isRunning(): boolean;
+    play(): void;
+    pause(): void;
+    stop(): void;
+    cancel(): void;
+    seek(t: number): void;
+    finished: Promise<void>;
+}
+export interface Adapter<T> {
+    toArray(v: T): number[];
+    fromArray(a: ReadonlyArray<number>): T;
+    clamp?(a: number[]): number[];
+    equals?(a: T, b: T): boolean;
+}
+export interface MotionValue<T> {
+    get(): T;
+    set(next: T): void;
+    setTarget(next: T): void;
+    getVelocity(): T;
+    onChange(fn: (v: T) => void): Unsubscribe;
+    onSettle(fn: () => void): Unsubscribe;
+    animate(to: T, options?: SpringOptions): AnimationControls;
+    stop(): void;
+    destroy(): void;
+}
+export interface ColorMotionValue extends MotionValue<ColorValue> {
+    animate(to: ColorLike | ColorValue, options?: SpringOptions): AnimationControls;
+}
+export declare const numberAdapter: Adapter<number>;
+export declare const rgbAdapter: Adapter<ColorValue>;
+type AdapterEntry = {
+    test: (value: unknown) => boolean;
+    create: (value: any) => Adapter<any>;
+    normalize?: (value: any) => any;
+};
+export declare function registerAdapter(entry: AdapterEntry): void;
+export declare function motionValue(initial: number, opts?: SpringOptions & {
+    adapter?: Adapter<number>;
+}): MotionValue<number>;
+export declare function motionValue(initial: ColorLike, opts?: SpringOptions & {
+    adapter?: Adapter<ColorValue>;
+}): ColorMotionValue;
+export declare function motionValue<T>(initial: T, opts?: SpringOptions & {
+    adapter?: Adapter<T>;
+}): MotionValue<T>;
+export declare function animate<T>(mv: MotionValue<T>, to: T, opts?: SpringOptions): AnimationControls;
+export declare function animate(mv: ColorMotionValue, to: ColorLike | ColorValue, opts?: SpringOptions): AnimationControls;
+export {};
+//# sourceMappingURL=motion-value.d.ts.map

package/dist/motion-value.d.ts.map

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

package/dist/motion-value.js

@@ -0,0 +1,250 @@
+// motion-value.ts - Generic MotionValue<T> with adapters and animate()
+import { parseColor } from "./render/surface.js";
+import { idxToRGB, clamp255 } from "./render/color-utils.js";
+import { DEFAULTS, fromDurationBounce, stepSpring1D } from "./spring-physics.js";
+import { colorLikeToRGB } from "./spring.js";
+// ---- Built-in adapters ----
+export const numberAdapter = {
+    toArray: (n) => [n],
+    fromArray: (a) => a[0] ?? 0,
+    clamp: (a) => a,
+    equals: (a, b) => Object.is(a, b),
+};
+export const rgbAdapter = {
+    toArray: (c) => [
+        typeof c === "number" ? idxToRGB(c).r : c.r,
+        typeof c === "number" ? idxToRGB(c).g : c.g,
+        typeof c === "number" ? idxToRGB(c).b : c.b,
+    ],
+    fromArray: (a) => ({ r: clamp255(a[0] ?? 0), g: clamp255(a[1] ?? 0), b: clamp255(a[2] ?? 0) }),
+    clamp: (a) => [clamp255(a[0] ?? 0), clamp255(a[1] ?? 0), clamp255(a[2] ?? 0)],
+    equals: (a, b) => typeof a === "number" || typeof b === "number"
+        ? JSON.stringify(colorLikeToRGB(a)) === JSON.stringify(colorLikeToRGB(b))
+        : a.r === b.r && a.g === b.g && a.b === b.b,
+};
+const ADAPTERS = [];
+export function registerAdapter(entry) {
+    ADAPTERS.unshift(entry);
+}
+function isColorObject(x) {
+    return x && typeof x === "object" && typeof x.r === "number" && typeof x.g === "number" && typeof x.b === "number";
+}
+function isColorLike(v) {
+    if (isColorObject(v))
+        return true;
+    if (typeof v === "string" || typeof v === "number") {
+        const parsed = parseColor(v);
+        return typeof parsed === "number" || isColorObject(parsed);
+    }
+    return false;
+}
+// Register built-in adapters
+registerAdapter({
+    test: (v) => isColorLike(v),
+    create: () => rgbAdapter,
+    normalize: (v) => colorLikeToRGB(v),
+});
+registerAdapter({
+    test: (v) => typeof v === "number",
+    create: () => numberAdapter,
+});
+const tickers = new Set();
+let timer = null;
+function pump() {
+    const copy = Array.from(tickers);
+    for (const t of copy) {
+        const keep = t();
+        if (!keep)
+            tickers.delete(t);
+    }
+    if (tickers.size === 0 && timer) {
+        clearTimeout(timer);
+        timer = null;
+    }
+    else {
+        // aim ~60fps
+        timer = setTimeout(pump, 16);
+    }
+}
+function ensureLoop() {
+    if (!timer)
+        timer = setTimeout(pump, 16);
+}
+// ---- AnimationControls implementation ----
+class AnimationControlsImpl {
+    _running = false;
+    _resolve;
+    finished = new Promise((res) => (this._resolve = res));
+    time = 0;
+    speed = 1;
+    isRunning() {
+        return this._running;
+    }
+    play() {
+        if (!this._running) {
+            this._running = true;
+        }
+    }
+    pause() {
+        this._running = false;
+    }
+    stop() {
+        this._running = false;
+        this._resolve();
+    }
+    cancel() {
+        this._running = false;
+    }
+    seek(t) {
+        this.time = Math.max(0, t);
+    }
+}
+// ---- MotionValue implementation ----
+class MotionValueImpl {
+    adapter;
+    opts;
+    x;
+    v;
+    target;
+    last;
+    changeSubs = new Set();
+    settleSubs = new Set();
+    controls;
+    constructor(initial, adapter, opts) {
+        this.adapter = adapter;
+        const base = { ...DEFAULTS, maxDt: 0.1, ...(opts ?? {}) };
+        this.opts = base;
+        if (this.opts.duration != null) {
+            const derived = fromDurationBounce(this.opts.duration, this.opts.bounce ?? DEFAULTS.bounce);
+            this.opts.frequency = derived.frequency;
+            this.opts.dampingRatio = derived.dampingRatio;
+        }
+        this.x = adapter.toArray(initial);
+        this.v = this.x.map(() => 0);
+        this.target = this.x.slice();
+    }
+    get() {
+        return this.adapter.fromArray(this.x);
+    }
+    set(next) {
+        this.x = this.adapter.toArray(next);
+        if (this.adapter.clamp)
+            this.x = this.adapter.clamp(this.x);
+        this.v = this.v.map(() => 0);
+        this.target = this.x.slice();
+        this.emitChange();
+    }
+    setTarget(next) {
+        this.target = this.adapter.toArray(next);
+        if (this.adapter.clamp)
+            this.target = this.adapter.clamp(this.target);
+    }
+    getVelocity() {
+        return this.adapter.fromArray(this.v);
+    }
+    onChange(fn) {
+        this.changeSubs.add(fn);
+        return () => this.changeSubs.delete(fn);
+    }
+    onSettle(fn) {
+        this.settleSubs.add(fn);
+        return () => this.settleSubs.delete(fn);
+    }
+    animate(to, options) {
+        this.setTarget(to);
+        this.opts = { ...this.opts, ...(options ?? {}) };
+        if (this.opts.duration != null) {
+            const derived = fromDurationBounce(this.opts.duration, this.opts.bounce ?? DEFAULTS.bounce);
+            this.opts.frequency = derived.frequency;
+            this.opts.dampingRatio = derived.dampingRatio;
+        }
+        this.controls?.cancel();
+        const controls = new AnimationControlsImpl();
+        controls.play();
+        this.controls = controls;
+        this.last = undefined;
+        const tick = () => {
+            if (!controls.isRunning())
+                return false;
+            const now = Date.now();
+            const last = this.last ?? now;
+            const dt = Math.max(0, Math.min(this.opts.maxDt ?? 0.1, (now - last) / 1000));
+            this.last = now;
+            const { frequency: f, dampingRatio: z, epsilon, bounce } = this.opts;
+            let settled = true;
+            for (let i = 0; i < this.x.length; i++) {
+                const prevX = this.x[i];
+                let { x: nextX, v: nextV } = stepSpring1D(prevX, this.v[i], this.target[i], dt, f, z);
+                if ((bounce ?? DEFAULTS.bounce) <= 0) {
+                    const crossed = (prevX - this.target[i]) * (nextX - this.target[i]) <= 0;
+                    if (crossed) {
+                        nextX = this.target[i];
+                        nextV = 0;
+                    }
+                }
+                this.x[i] = nextX;
+                this.v[i] = nextV;
+                if (!(Math.abs(this.x[i] - this.target[i]) < (epsilon ?? DEFAULTS.epsilon) &&
+                    Math.abs(this.v[i]) < (epsilon ?? DEFAULTS.epsilon))) {
+                    settled = false;
+                }
+            }
+            if (this.adapter.clamp)
+                this.x = this.adapter.clamp(this.x);
+            this.emitChange();
+            if (settled) {
+                this.x = this.target.slice();
+                this.v = this.v.map(() => 0);
+                this.emitChange();
+                this.emitSettle();
+                controls.stop();
+                return false;
+            }
+            return true;
+        };
+        tickers.add(tick);
+        ensureLoop();
+        return controls;
+    }
+    stop() {
+        this.controls?.stop();
+    }
+    destroy() {
+        this.changeSubs.clear();
+        this.settleSubs.clear();
+        this.controls?.cancel();
+    }
+    emitChange() {
+        const v = this.get();
+        this.changeSubs.forEach((fn) => fn(v));
+    }
+    emitSettle() {
+        this.settleSubs.forEach((fn) => fn());
+    }
+}
+class ColorMotionValueImpl extends MotionValueImpl {
+    animate(to, options) {
+        const target = typeof to === "string" || typeof to === "number" ? colorLikeToRGB(to) : to;
+        return super.animate(target, options);
+    }
+}
+export function motionValue(initial, opts) {
+    if (opts?.adapter) {
+        const norm = opts.adapter.fromArray(opts.adapter.toArray(initial));
+        return new MotionValueImpl(norm, opts.adapter, opts);
+    }
+    for (const entry of ADAPTERS) {
+        if (entry.test(initial)) {
+            const adapter = entry.create(initial);
+            const normalized = entry.normalize ? entry.normalize(initial) : adapter.fromArray(adapter.toArray(initial));
+            if (adapter === rgbAdapter)
+                return new ColorMotionValueImpl(normalized, adapter, opts);
+            return new MotionValueImpl(normalized, adapter, opts);
+        }
+    }
+    throw new Error("No adapter found for initial value. Provide { adapter } explicitly.");
+}
+export function animate(mv, to, opts) {
+    return mv.animate(to, opts);
+}
+//# sourceMappingURL=motion-value.js.map

package/dist/motion-value.js.map

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

package/dist/present/display.d.ts

@@ -0,0 +1,58 @@
+import { Palette, type Surface as SurfaceType } from "../render/surface.js";
+import { type RunWriter } from "../render/diff.js";
+import type { View } from "../ui/core/view.js";
+import type { TerminalBackend } from "../runtime/backend_node.js";
+import { Effect } from "effect";
+export interface DisplayRenderer {
+    start(): void;
+    draw(view: View): void;
+    resize(cols: number, rows: number): void;
+    end(): void;
+}
+declare abstract class BaseRenderer implements DisplayRenderer {
+    protected backend: TerminalBackend;
+    protected palette: Palette;
+    protected prev?: SurfaceType;
+    protected next?: SurfaceType;
+    constructor(backend: TerminalBackend);
+    abstract start(): void;
+    abstract end(): void;
+    abstract makeWriter(): RunWriter;
+    protected ensureFrames(cols: number, rows: number): void;
+    protected swap(): void;
+    draw(view: View): void;
+    resize(_c: number, _r: number): void;
+}
+export declare class FullscreenRenderer extends BaseRenderer {
+    /**
+     * Create a fullscreen renderer. Kept as an Effect to align with inline
+     * and allow future async setup without changing call sites.
+     */
+    static make(backend: TerminalBackend): Effect.Effect<FullscreenRenderer, never, never>;
+    start(): void;
+    end(): void;
+    makeWriter(): RunWriter;
+}
+export declare class InlineRenderer extends BaseRenderer {
+    private writer;
+    private baseRow;
+    private skipDiff;
+    private lastPrintedHeight;
+    /**
+     * Create an inline renderer anchored to the current cursor row.
+     */
+    static make(backend: TerminalBackend): Effect.Effect<InlineRenderer, never, never>;
+    setBaseRow(n: number): void;
+    start(): void;
+    end(): void;
+    makeWriter(): RunWriter;
+    resize(c: number, r: number): void;
+    draw(view: View): void;
+}
+export type RendererMode = "fullscreen" | "inline";
+export declare class TerminalRenderer {
+    private constructor();
+    static make(mode: RendererMode, backend: TerminalBackend): Effect.Effect<FullscreenRenderer, never, never>;
+}
+export {};
+//# sourceMappingURL=display.d.ts.map

package/dist/present/display.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"display.d.ts","sourceRoot":"","sources":["../../src/present/display.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAW,KAAK,OAAO,IAAI,WAAW,EAAE,MAAM,sBAAsB,CAAA;AACpF,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAG9D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAA;AAE9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AACjE,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAG/B,MAAM,WAAW,eAAe;IAC9B,KAAK,IAAI,IAAI,CAAA;IACb,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAA;IACtB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACxC,GAAG,IAAI,IAAI,CAAA;CACZ;AAED,uBAAe,YAAa,YAAW,eAAe;IAKxC,SAAS,CAAC,OAAO,EAAE,eAAe;IAJ9C,SAAS,CAAC,OAAO,UAAgB;IACjC,SAAS,CAAC,IAAI,CAAC,EAAE,WAAW,CAAA;IAC5B,SAAS,CAAC,IAAI,CAAC,EAAE,WAAW,CAAA;gBAEN,OAAO,EAAE,eAAe;IAC9C,QAAQ,CAAC,KAAK,IAAI,IAAI;IACtB,QAAQ,CAAC,GAAG,IAAI,IAAI;IACpB,QAAQ,CAAC,UAAU,IAAI,SAAS;IAEhC,SAAS,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAgBjD,SAAS,CAAC,IAAI;IAMd,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAkBtB,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;CAMrC;AAED,qBAAa,kBAAmB,SAAQ,YAAY;IAClD;;;OAGG;IACH,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,eAAe;IAGpC,KAAK,IAAI,IAAI;IAGb,GAAG,IAAI,IAAI;IAGX,UAAU,IAAI,SAAS;CAGxB;AAED,qBAAa,cAAe,SAAQ,YAAY;IAC9C,OAAO,CAAC,MAAM,CAAmC;IACjD,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,iBAAiB,CAAI;IAE7B;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,eAAe;IAWpC,UAAU,CAAC,CAAC,EAAE,MAAM;IAIpB,KAAK,IAAI,IAAI;IAGb,GAAG,IAAI,IAAI;IAMX,UAAU,IAAI,SAAS;IAKd,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAYlC,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;CAoDhC;AAED,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,QAAQ,CAAA;AAElD,qBAAa,gBAAgB;IAC3B,OAAO;IACP,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,eAAe;CAGzD"}

package/dist/present/display.js

@@ -0,0 +1,168 @@
+import { Palette, Surface } from "../render/surface.js";
+import { diffFrames } from "../render/diff.js";
+import { FullscreenWriter } from "./writers/fullscreen.js";
+import { LineDiffWriter } from "./writers/inline.js";
+import { ANSI, Terminal } from "../ansi.js";
+import { Effect } from "effect";
+import { geometryStore } from "../ui/core/geometry-store.js";
+class BaseRenderer {
+    backend;
+    palette = new Palette();
+    prev;
+    next;
+    constructor(backend) {
+        this.backend = backend;
+    }
+    ensureFrames(cols, rows) {
+        const needNew = !this.prev ||
+            !this.next ||
+            this.prev.w !== cols ||
+            this.prev.h !== rows ||
+            this.next.w !== cols ||
+            this.next.h !== rows;
+        if (needNew) {
+            this.prev = new Surface(cols, rows, { palette: this.palette });
+            this.next = new Surface(cols, rows, { palette: this.palette });
+            this.prev.clear(0);
+            this.next.clear(0);
+        }
+    }
+    swap() {
+        const t = this.prev;
+        this.prev = this.next;
+        this.next = t;
+    }
+    draw(view) {
+        const { cols, rows } = this.backend.size();
+        this.ensureFrames(cols, rows);
+        // render into the "next" frame
+        this.next?.clear(0);
+        geometryStore.beginFrame();
+        view.render(this.next, this.palette, { x: 0, y: 0, w: cols, h: rows });
+        geometryStore.endFrame();
+        const writer = this.makeWriter();
+        diffFrames(this.prev, this.next, writer);
+        this.backend.write(writer.flush());
+        // swap for next frame
+        this.swap();
+    }
+    resize(_c, _r) {
+        // Clear terminal and force full rerender
+        this.backend.write(Terminal.clearAndHome); // clear screen + move to top-left
+        delete this.prev;
+        delete this.next;
+    }
+}
+export class FullscreenRenderer extends BaseRenderer {
+    /**
+     * Create a fullscreen renderer. Kept as an Effect to align with inline
+     * and allow future async setup without changing call sites.
+     */
+    static make(backend) {
+        return Effect.sync(() => new FullscreenRenderer(backend));
+    }
+    start() {
+        this.backend.enterFullscreen();
+    }
+    end() {
+        this.backend.exitFullscreen();
+    }
+    makeWriter() {
+        return new FullscreenWriter(this.palette);
+    }
+}
+export class InlineRenderer extends BaseRenderer {
+    writer = new LineDiffWriter(this.palette);
+    baseRow;
+    skipDiff = false;
+    lastPrintedHeight = 1;
+    /**
+     * Create an inline renderer anchored to the current cursor row.
+     */
+    static make(backend) {
+        return Effect.promise(() => backend.getCursorPosition()).pipe(Effect.catchAll(() => Effect.succeed({ row: process.stdout.rows || 24, col: 1 })), Effect.map((pos) => {
+            const r = new InlineRenderer(backend);
+            r.setBaseRow(Math.max(0, (pos.row | 0) - 1));
+            return r;
+        }));
+    }
+    setBaseRow(n) {
+        this.baseRow = Math.max(0, n | 0);
+    }
+    start() {
+        this.backend.hideCursor();
+    }
+    end() {
+        const topRow = this.baseRow ?? 0;
+        const nextRow1 = Math.max(1, topRow + this.lastPrintedHeight);
+        this.backend.write(ANSI.cursor.to(nextRow1 + 1, 1));
+        this.backend.showCursor();
+    }
+    makeWriter() {
+        return this.writer;
+    }
+    // Override resize to clear screen and reset base row for inline mode
+    resize(c, r) {
+        // Clear entire screen, scrollback buffer, and move cursor to top-left
+        this.backend.write(ANSI.screen.clearScrollback + Terminal.clearAndHome);
+        // Reset base row to start from top
+        this.baseRow = 0;
+        // Force full redraw on next draw
+        this.skipDiff = true;
+        // Call parent to clear surfaces
+        super.resize(c, r);
+    }
+    // Override draw to support inline base-row anchoring and scroll-up
+    draw(view) {
+        const { cols, rows } = this.backend.size();
+        this.ensureFrames(cols, rows);
+        let baseRow = this.baseRow ?? 0;
+        const measured = view.measure(cols, rows);
+        const renderW = Math.max(1, Math.min(cols, measured.w || 0));
+        const renderH = Math.max(1, Math.min(rows, measured.h || 0));
+        // Render into the "next" frame (clamp to measured size so we don't fill the viewport)
+        this.next?.clear(0);
+        geometryStore.beginFrame();
+        view.render(this.next, this.palette, { x: 0, y: 0, w: renderW, h: renderH });
+        geometryStore.endFrame();
+        // Determine content footprint
+        const bounds = this.next?.contentBounds();
+        const contentH = Math.max(1, (bounds?.h ?? 0) | 0);
+        this.lastPrintedHeight = contentH;
+        // If bottom would overflow viewport, scroll up and reduce baseRow
+        const bottom1 = baseRow + contentH;
+        if (bottom1 > rows) {
+            const scroll = bottom1 - rows;
+            if (scroll > 0) {
+                this.backend.write(ANSI.scroll.up(scroll));
+                baseRow = Math.max(0, baseRow - scroll);
+            }
+        }
+        // Inform writer of base row for absolute addressing
+        this.writer.setBaseRow?.(baseRow);
+        // If we need to skip diff, render directly
+        if (this.skipDiff) {
+            // Position cursor at base row
+            this.backend.write(ANSI.cursor.to(baseRow + 1, 1));
+            // Just render what we have in the surface (viewport content)
+            const output = this.next?.buildStyledLines({ x: 0, y: 0, w: this.next?.w ?? 0, h: contentH }, this.palette);
+            this.backend.write((output ?? []).join("\n"));
+            this.skipDiff = false;
+        }
+        else {
+            // Normal diff and flush
+            diffFrames(this.prev, this.next, this.writer);
+            this.backend.write(this.writer.flush());
+        }
+        // swap for next frame and advance baseline for subsequent renders
+        this.swap();
+        this.baseRow = baseRow;
+    }
+}
+export class TerminalRenderer {
+    constructor() { }
+    static make(mode, backend) {
+        return mode === "inline" ? InlineRenderer.make(backend) : FullscreenRenderer.make(backend);
+    }
+}
+//# sourceMappingURL=display.js.map