@timurproko/a1 0.2.7-dev.1252 → 0.2.7-dev.1264

package/dist/integrations/pi/tui-runtime/adapter.js

@@ -128,7 +128,7 @@ export class PiTuiRuntimeAdapter {
     #rootBridge;
     #bridges = new WeakMap();
     #mountedComponents = new Set();
-    #scrollViews = new Map();
+    #scrollIds = new Set();
     #overlayGeometry;
     #overlayDisposers = new Set();
     #overlayInputCoordination = new Map();
@@ -136,8 +136,6 @@ export class PiTuiRuntimeAdapter {
     #preInputListeners = new Set();
     #consumeUnhandledMouse;
     #inputCoordinator;
-    #inputDiagnostics;
-    #diagnosticNow;
     #inputSink;
     #state = "idle";
     #stopPromise;
@@ -149,15 +147,14 @@ export class PiTuiRuntimeAdapter {
         this.#overlayGeometry = options.onOverlayGeometry === undefined ? undefined : new OverlayGeometryTracker(options.onOverlayGeometry);
         this.#terminal = options.terminal ?? new ProcessTerminal();
         this.#consumeUnhandledMouse = options.consumeUnhandledMouse ?? false;
-        this.#inputDiagnostics = options.inputDiagnostics;
-        this.#diagnosticNow = options.inputDiagnostics?.now ?? (() => performance.now());
+        const diagnostics = options.inputDiagnostics;
+        const diagnosticNow = diagnostics?.now ?? (() => performance.now());
+        const tracePhase = diagnostics === undefined ? undefined : runtimePhaseTracer(diagnostics, diagnosticNow, () => this.#inputCoordinator);
         // Invariant: the pinned renderer's frames pass through this gate, while writeControl and
         // the stop sequence reach the terminal directly. Freezing drops frames without touching
         // the renderer, so a scheduled repaint cannot land on top of the quit outro.
         const gatedTerminal = frozenGateTerminal(this.#terminal, () => this.#presentationFrozen || this.#presentationHolds.size > 0);
-        const tracedTerminal = options.inputDiagnostics === undefined
-            ? gatedTerminal
-            : diagnosticTerminal(gatedTerminal, phase => this.#traceRuntimePhase(phase));
+        const tracedTerminal = tracePhase === undefined ? gatedTerminal : diagnosticTerminal(gatedTerminal, tracePhase);
         const decoratedTerminal = options.decorateTerminal?.(tracedTerminal) ?? tracedTerminal;
         const coordination = options.inputCoordination ?? (options.inputDiagnostics === undefined
             ? undefined
@@ -173,10 +170,8 @@ export class PiTuiRuntimeAdapter {
                 },
                 ...(coordination.onReceipt === undefined ? {} : { onReceipt: coordination.onReceipt }),
                 ...(coordination.scheduler === undefined ? {} : { scheduler: coordination.scheduler }),
-                now: this.#diagnosticNow,
-                ...(options.inputDiagnostics === undefined ? {} : {
-                    onTrace: event => this.#traceInputCoordination(event),
-                }),
+                now: diagnosticNow,
+                ...(diagnostics === undefined ? {} : { onTrace: event => diagnostics.onEvent(event) }),
             });
         this.#tuiTerminal = this.#inputCoordinator === undefined
             ? preInputTerminal(decoratedTerminal, data => this.#routePreInput(data), this.#overlayGeometry !== undefined)
@@ -187,9 +182,7 @@ export class PiTuiRuntimeAdapter {
         this.#tuiTerminal.restoreOnExit = (before, after) => exitTerminal.restoreOnExit?.(before, after);
         this.#layoutRoot = options.layoutRoot;
         this.#logDirectory = options.logDirectory;
-        this.#rootBridge = new ComponentBridge(options.root, options.inputDiagnostics === undefined
-            ? undefined
-            : phase => this.#traceRuntimePhase(phase));
+        this.#rootBridge = new ComponentBridge(options.root, tracePhase);
         this.#bridges.set(options.root, this.#rootBridge);
         this.#mountedComponents.add(options.root);
         try {
@@ -229,53 +222,6 @@ export class PiTuiRuntimeAdapter {
             rows: Math.max(1, this.#terminal.rows),
         };
     }
-    scrollState(id) {
-        if (id === undefined) {
-            if (!(this.#tui instanceof TuiAltScreen)) {
-                throw new Error("Pi TUI application scrolling is available only in fullscreen mode");
-            }
-            return {
-                scrollTop: this.#tui.viewportTop,
-                viewportHeight: this.viewport().rows,
-                followingEnd: this.#tui.isFollowingOutput,
-                scrollbarVisible: false,
-            };
-        }
-        const scrollView = this.#requireScrollView(id);
-        return {
-            scrollTop: scrollView.scrollTop,
-            viewportHeight: scrollView.viewportHeight,
-            followingEnd: scrollView.isFollowingEnd,
-            scrollbarVisible: scrollView.isScrollbarVisible,
-        };
-    }
-    scrollBy(lines, id) {
-        this.#assertRunning("scroll");
-        if (id === undefined)
-            this.#requireFullscreen().scrollBy(lines);
-        else {
-            this.#requireScrollView(id).scrollBy(lines);
-            this.#tui.requestRender();
-        }
-    }
-    scrollToTop(id) {
-        this.#assertRunning("scroll");
-        if (id === undefined)
-            this.#requireFullscreen().scrollToTop();
-        else {
-            this.#requireScrollView(id).scrollToStart();
-            this.#tui.requestRender();
-        }
-    }
-    scrollToBottom(id) {
-        this.#assertRunning("scroll");
-        if (id === undefined)
-            this.#requireFullscreen().scrollToBottom();
-        else {
-            this.#requireScrollView(id).scrollToEnd();
-            this.#tui.requestRender();
-        }
-    }
     start() {
         if (this.#state === "running")
             return;
@@ -293,12 +239,6 @@ export class PiTuiRuntimeAdapter {
             throw new PiTuiRuntimeError("start", error);
         }
     }
-    setFocus(component) {
-        this.#assertRunning("focus");
-        if (this.#overlayInputCoordination.size > 0)
-            this.#overlayGeometry?.invalidate();
-        this.#tui.setFocus(this.#bridgeFor(component));
-    }
     showOverlay(component, options) {
         this.#assertRunning("overlay");
         if (this.#bridges.has(component))
@@ -347,9 +287,6 @@ export class PiTuiRuntimeAdapter {
         this.#assertRunning("presentation freeze");
         this.#presentationFrozen = true;
     }
-    get presentationFrozen() {
-        return this.#presentationFrozen;
-    }
     /**
      * Keeps asynchronous replacement-surface construction atomic at the terminal. Renderers may
      * compose while held, but their writes are dropped until the final forced repaint on release.
@@ -401,7 +338,7 @@ export class PiTuiRuntimeAdapter {
             previous.clear();
             if (previous instanceof TuiAltScreen)
                 previous.setLayoutRoot(undefined);
-            this.#scrollViews.clear();
+            this.#scrollIds.clear();
             const next = this.#createTui(mode, hardwareCursor);
             next.setClearOnShrink(clearOnShrink);
             this.#mountTui(next);
@@ -424,9 +361,6 @@ export class PiTuiRuntimeAdapter {
         if (this.active)
             this.#tui.requestRender();
     }
-    getHardwareCursor() {
-        return this.#tui.getShowHardwareCursor();
-    }
     setClearOnShrink(enabled) {
         this.#tui.setClearOnShrink(enabled);
     }
@@ -435,9 +369,6 @@ export class PiTuiRuntimeAdapter {
         if (this.#tui instanceof TuiAltScreen)
             this.#tui.setWheelScrollLines(lines);
     }
-    getClearOnShrink() {
-        return this.#tui.getClearOnShrink();
-    }
     setTerminalProgress(active) {
         if (this.#terminalProgress === active)
             return;
@@ -450,11 +381,6 @@ export class PiTuiRuntimeAdapter {
     setTitle(title) {
         this.#terminal.setTitle(title);
     }
-    /** Shows a bounded fullscreen acknowledgement without changing root layout geometry. */
-    showFlash(message, durationMs) {
-        this.#assertRunning("flash");
-        this.#requireFullscreen().flash(message, durationMs);
-    }
     writeAfterStop(text) {
         if (this.#state !== "stopped")
             throw new Error("terminal output requires a stopped Pi TUI runtime");
@@ -560,22 +486,6 @@ export class PiTuiRuntimeAdapter {
         }
         return undefined;
     }
-    #traceInputCoordination(event) {
-        this.#inputDiagnostics?.onEvent(event);
-    }
-    #traceRuntimePhase(phase) {
-        if (this.#inputDiagnostics === undefined)
-            return;
-        const coordinator = this.#inputCoordinator;
-        this.#inputDiagnostics.onEvent({
-            phase,
-            revision: coordinator?.appliedRevision ?? 0,
-            atMs: this.#diagnosticNow(),
-            pendingDepth: coordinator?.pendingDepth ?? 0,
-            pendingPresentationDepth: coordinator?.pendingPresentation === true ? 1 : 0,
-            appliedRevision: coordinator?.appliedRevision ?? 0,
-        });
-    }
     #mountTui(tui) {
         tui.addChild(this.#rootBridge);
         if (tui instanceof TuiAltScreen && this.#layoutRoot !== undefined) {
@@ -603,7 +513,7 @@ export class PiTuiRuntimeAdapter {
         if (node.type === "component")
             return this.#mount(node.component);
         if (node.type === "scroll") {
-            if (this.#scrollViews.has(node.id))
+            if (this.#scrollIds.has(node.id))
                 throw new TypeError(`duplicate Pi TUI scroll layout id: ${node.id}`);
             const options = {
                 ...(node.follow === undefined ? {} : { follow: node.follow }),
@@ -614,9 +524,8 @@ export class PiTuiRuntimeAdapter {
                 ...(node.scrollbarThumbStyle === undefined ? {} : { scrollbarThumbStyle: node.scrollbarThumbStyle }),
                 ...(node.scrollbarHideDelayMs === undefined ? {} : { scrollbarHideDelayMs: node.scrollbarHideDelayMs }),
             };
-            const scrollView = new ScrollView(this.#buildLayout(node.child), options);
-            this.#scrollViews.set(node.id, scrollView);
-            return scrollView;
+            this.#scrollIds.add(node.id);
+            return new ScrollView(this.#buildLayout(node.child), options);
         }
         const children = node.children.map(entry => ({
             component: this.#buildLayout(entry.node),
@@ -633,19 +542,6 @@ export class PiTuiRuntimeAdapter {
         };
         return node.direction === "vertical" ? new VStack(children, options) : new HStack(children, options);
     }
-    #requireFullscreen() {
-        if (!(this.#tui instanceof TuiAltScreen)) {
-            throw new Error("Pi TUI application scrolling is available only in fullscreen mode");
-        }
-        return this.#tui;
-    }
-    #requireScrollView(id) {
-        this.#requireFullscreen();
-        const scrollView = this.#scrollViews.get(id);
-        if (!scrollView)
-            throw new TypeError(`unknown Pi TUI scroll layout id: ${id}`);
-        return scrollView;
-    }
     #assertRunning(operation) {
         if (!this.active)
             throw new Error(`Pi TUI ${operation} requires a running runtime`);
@@ -706,12 +602,33 @@ export class PiTuiRuntimeAdapter {
         this.#disposeRoot();
     }
 }
-function coordinatedInputTerminal(terminal, coordinator, setSink, frameMouse) {
-    const mouse = frameMouse ? new MouseReportInput(data => coordinator.accept(data)) : undefined;
+/**
+ * Forwards every terminal member to `terminal` unless `overrides` replaces it.
+ * Invariant: the size and keyboard getters stay live; spreading the inner terminal would freeze them.
+ */
+function forwardingTerminal(terminal, overrides = {}) {
     return {
         get columns() { return terminal.columns; },
         get rows() { return terminal.rows; },
         get kittyProtocolActive() { return terminal.kittyProtocolActive; },
+        start: overrides.start ?? ((onInput, onResize) => terminal.start(onInput, onResize)),
+        stop: overrides.stop ?? (() => terminal.stop()),
+        drainInput: overrides.drainInput ?? ((maxMs, idleMs) => terminal.drainInput(maxMs, idleMs)),
+        write: overrides.write ?? (data => terminal.write(data)),
+        moveBy: overrides.moveBy ?? (lines => terminal.moveBy(lines)),
+        hideCursor: overrides.hideCursor ?? (() => terminal.hideCursor()),
+        showCursor: overrides.showCursor ?? (() => terminal.showCursor()),
+        clearLine: overrides.clearLine ?? (() => terminal.clearLine()),
+        clearFromCursor: overrides.clearFromCursor ?? (() => terminal.clearFromCursor()),
+        clearScreen: overrides.clearScreen ?? (() => terminal.clearScreen()),
+        setTitle: overrides.setTitle ?? (title => terminal.setTitle(title)),
+        setProgress: overrides.setProgress ?? (active => terminal.setProgress(active)),
+        setProgramStatus: overrides.setProgramStatus ?? (status => terminal.setProgramStatus?.(status)),
+    };
+}
+function coordinatedInputTerminal(terminal, coordinator, setSink, frameMouse) {
+    const mouse = frameMouse ? new MouseReportInput(data => coordinator.accept(data)) : undefined;
+    return forwardingTerminal(terminal, {
         start(onInput, onResize) {
             setSink(onInput);
             terminal.start(data => mouse === undefined ? coordinator.accept(data) : mouse.accept(data), () => {
@@ -726,27 +643,10 @@ function coordinatedInputTerminal(terminal, coordinator, setSink, frameMouse) {
             setSink(undefined);
             terminal.stop();
         },
-        drainInput: (maxMs, idleMs) => terminal.drainInput(maxMs, idleMs),
-        write: data => terminal.write(data),
-        moveBy: lines => terminal.moveBy(lines),
-        hideCursor: () => terminal.hideCursor(),
-        showCursor: () => terminal.showCursor(),
-        clearLine: () => terminal.clearLine(),
-        clearFromCursor: () => terminal.clearFromCursor(),
-        clearScreen: () => terminal.clearScreen(),
-        setTitle: title => terminal.setTitle(title),
-        setProgress: active => terminal.setProgress(active),
-        setProgramStatus: status => terminal.setProgramStatus?.(status),
-    };
+    });
 }
 function diagnosticTerminal(terminal, trace) {
-    return {
-        get columns() { return terminal.columns; },
-        get rows() { return terminal.rows; },
-        get kittyProtocolActive() { return terminal.kittyProtocolActive; },
-        start: (onInput, onResize) => terminal.start(onInput, onResize),
-        stop: () => terminal.stop(),
-        drainInput: (maxMs, idleMs) => terminal.drainInput(maxMs, idleMs),
+    return forwardingTerminal(terminal, {
         write(data) {
             trace("write-start");
             try {
@@ -756,25 +656,10 @@ function diagnosticTerminal(terminal, trace) {
                 trace("write-end");
             }
         },
-        moveBy: lines => terminal.moveBy(lines),
-        hideCursor: () => terminal.hideCursor(),
-        showCursor: () => terminal.showCursor(),
-        clearLine: () => terminal.clearLine(),
-        clearFromCursor: () => terminal.clearFromCursor(),
-        clearScreen: () => terminal.clearScreen(),
-        setTitle: title => terminal.setTitle(title),
-        setProgress: active => terminal.setProgress(active),
-        setProgramStatus: status => terminal.setProgramStatus?.(status),
-    };
+    });
 }
 function frozenGateTerminal(terminal, frozen) {
-    return {
-        get columns() { return terminal.columns; },
-        get rows() { return terminal.rows; },
-        get kittyProtocolActive() { return terminal.kittyProtocolActive; },
-        start: (onInput, onResize) => terminal.start(onInput, onResize),
-        stop: () => terminal.stop(),
-        drainInput: (maxMs, idleMs) => terminal.drainInput(maxMs, idleMs),
+    return forwardingTerminal(terminal, {
         write: data => { if (!frozen())
             terminal.write(data); },
         moveBy: lines => { if (!frozen())
@@ -789,17 +674,11 @@ function frozenGateTerminal(terminal, frozen) {
             terminal.clearFromCursor(); },
         clearScreen: () => { if (!frozen())
             terminal.clearScreen(); },
-        setTitle: title => terminal.setTitle(title),
-        setProgress: active => terminal.setProgress(active),
-        setProgramStatus: status => terminal.setProgramStatus?.(status),
-    };
+    });
 }
 function preInputTerminal(terminal, route, frameMouse) {
     let mouse;
-    return {
-        get columns() { return terminal.columns; },
-        get rows() { return terminal.rows; },
-        get kittyProtocolActive() { return terminal.kittyProtocolActive; },
+    return forwardingTerminal(terminal, {
         start(onInput, onResize) {
             const deliver = (data) => {
                 const routed = route(data);
@@ -813,18 +692,7 @@ function preInputTerminal(terminal, route, frameMouse) {
             });
         },
         stop: () => { mouse?.reset(); terminal.stop(); },
-        drainInput: (maxMs, idleMs) => terminal.drainInput(maxMs, idleMs),
-        write: data => terminal.write(data),
-        moveBy: lines => terminal.moveBy(lines),
-        hideCursor: () => terminal.hideCursor(),
-        showCursor: () => terminal.showCursor(),
-        clearLine: () => terminal.clearLine(),
-        clearFromCursor: () => terminal.clearFromCursor(),
-        clearScreen: () => terminal.clearScreen(),
-        setTitle: title => terminal.setTitle(title),
-        setProgress: active => terminal.setProgress(active),
-        setProgramStatus: status => terminal.setProgramStatus?.(status),
-    };
+    });
 }
 function toOverlayOptions(options) {
     if (options === undefined)
@@ -854,3 +722,17 @@ function toOverlayOptions(options) {
         mapped.nonCapturing = options.nonCapturing;
     return mapped;
 }
+/** Reports one runtime phase with the input coordinator's depth and revision at that moment. */
+function runtimePhaseTracer(diagnostics, now, coordinator) {
+    return phase => {
+        const current = coordinator();
+        diagnostics.onEvent({
+            phase,
+            revision: current?.appliedRevision ?? 0,
+            atMs: now(),
+            pendingDepth: current?.pendingDepth ?? 0,
+            pendingPresentationDepth: current?.pendingPresentation === true ? 1 : 0,
+            appliedRevision: current?.appliedRevision ?? 0,
+        });
+    };
+}

package/dist/integrations/pi/tui-runtime/damage-aware-terminal.d.ts

@@ -1,45 +1,10 @@
-import type { PiTuiTerminalPort } from "./contracts.js";
+import type { TerminalPort } from "../../../contracts/presentation/index.js";
 export declare const PINNED_PI_TUI_DAMAGE_GRAMMAR = "@earendil-works/pi-tui@1.5.0:tui-alt-screen-one-write-v1";
-export interface PiTuiDamageFrameDescriptor {
-    /**
-     * Frame ids are compared only within one presentation epoch; absent means the current epoch. A
-     * presenter switch starts a new epoch, because each presenter numbers its own frames.
-     */
-    readonly epoch?: number;
-    readonly frameId: number;
-    readonly width: number;
-    readonly height: number;
-    readonly transcript: {
-        readonly rowStart: number;
-        readonly rowEnd: number;
-    } | null;
-    readonly dock: {
-        readonly rowStart: number;
-        readonly rowEnd: number;
-    } | null;
-    /**
-     * Visible rows owned by the block that is currently streaming. A live block repaints
-     * every row it owns when it reflows, so the allowed damage follows the declared tail
-     * instead of assuming a one-row tail.
-     */
-    readonly liveTailRows?: number;
-    readonly verticalShiftRows: number;
-    readonly safeVerticalShift: boolean;
-    readonly cause: string;
-}
-export interface PiTuiDamageFrameSafety {
-    readonly overlayActive: boolean;
-    readonly selectionActive: boolean;
-    readonly replacementSurfaceActive: boolean;
-}
-export type PiTuiDamageDecisionReason = "transformed" | "suppressed-redundant-clear" | "hyperlink-cleanup" | "pending-hyperlink-cleanup" | "not-armed" | "unsafe-frame" | "stale-frame" | "unsupported-region-scroll" | "geometry-mismatch" | "grammar-mismatch" | "unsafe-terminal-content" | "incomplete-prior-frame" | "excessive-real-damage";
-export interface PiTuiDamageDecision {
-    readonly frameId: number | null;
-    readonly transformed: boolean;
-    readonly reason: PiTuiDamageDecisionReason;
-    readonly shiftRows: number;
-    readonly paintedRows: readonly number[];
-}
+import type { TerminalDamageDecision, TerminalDamageDecisionReason, TerminalDamageFrameDescriptor, TerminalDamageFrameSafety } from "../../../contracts/presentation/index.js";
+export type PiTuiDamageFrameDescriptor = TerminalDamageFrameDescriptor;
+export type PiTuiDamageFrameSafety = TerminalDamageFrameSafety;
+export type PiTuiDamageDecisionReason = TerminalDamageDecisionReason;
+export type PiTuiDamageDecision = TerminalDamageDecision;
 export interface DamageAwareTerminalOptions {
     readonly regionalScroll: boolean;
     /** The shell supplies visible-row analysis; the terminal layer owns no UI parser. */
@@ -69,11 +34,11 @@ export interface DamageAwareTerminalOptions {
  * viewport metadata authorizes a shift; bytes are inspected only to validate
  * and preserve Pi's complete row paint and cursor syntax.
  */
-export declare class DamageAwareTerminalAdapter implements PiTuiTerminalPort {
+export declare class DamageAwareTerminalAdapter implements TerminalPort {
     #private;
-    readonly inner: PiTuiTerminalPort;
+    readonly inner: TerminalPort;
     readonly options: DamageAwareTerminalOptions;
-    constructor(inner: PiTuiTerminalPort, options: DamageAwareTerminalOptions);
+    constructor(inner: TerminalPort, options: DamageAwareTerminalOptions);
     get columns(): number;
     get rows(): number;
     get kittyProtocolActive(): boolean;

package/dist/integrations/pi/tui-runtime/index.d.ts

@@ -1,5 +1,5 @@
-export type { PiTuiComponentPort, PiTuiInputDiagnosticsEvent, PiTuiInputDiagnosticsPhase, PiTuiInputListener, PiTuiInputListenerResult, PiTuiLayoutEntry, PiTuiLayoutNode, PiTuiOverlayAnchor, PiTuiOverlayHandle, PiTuiOverlayMargin, PiTuiOverlayOptions, PiTuiOverlayUnfocusOptions, PiTuiPointerSurface, PiTuiPreInputListener, PiTuiRuntimeAdapterOptions, PiTuiRuntimeState, PiTuiScrollState, PiTuiSizeValue, PiTuiStopOptions, PiTuiTerminalPort, PiTuiViewport, } from "./contracts.js";
 export { samePointerSurfaces } from "./overlay-geometry.js";
+export { PI_TERMINAL_RUNTIME } from "./runtime-factory.js";
 export { DamageAwareTerminalAdapter, PINNED_PI_TUI_DAMAGE_GRAMMAR, paintTerminalCanvasFrame, rebaseTerminalDefaultBackground, } from "./damage-aware-terminal.js";
 export type { DamageAwareTerminalOptions, PiTuiDamageDecision, PiTuiDamageDecisionReason, PiTuiDamageFrameDescriptor, PiTuiDamageFrameSafety, } from "./damage-aware-terminal.js";
 export { InputPresentationCoordinator, classifyPiTuiInput } from "./input-presentation-coordinator.js";

package/dist/integrations/pi/tui-runtime/index.js

@@ -1,4 +1,5 @@
 export { samePointerSurfaces } from "./overlay-geometry.js";
+export { PI_TERMINAL_RUNTIME } from "./runtime-factory.js";
 export { DamageAwareTerminalAdapter, PINNED_PI_TUI_DAMAGE_GRAMMAR, paintTerminalCanvasFrame, rebaseTerminalDefaultBackground, } from "./damage-aware-terminal.js";
 export { InputPresentationCoordinator, classifyPiTuiInput } from "./input-presentation-coordinator.js";
 export { PiTuiRuntimeAdapter, PiTuiRuntimeError } from "./adapter.js";

package/dist/integrations/pi/tui-runtime/input-presentation-coordinator.d.ts

@@ -1,9 +1,7 @@
-export type PiTuiInputCoordinationDecision = "safe" | "barrier";
-export type PiTuiInputSurfaceKind = "editor" | "owned" | "opaque";
-export interface PiTuiInputCoordinationScheduler {
-    scheduleImmediate(callback: () => void): ReturnType<typeof setImmediate>;
-    cancelImmediate(handle: ReturnType<typeof setImmediate>): void;
-}
+import type { TerminalInputCoordinationDecision, TerminalInputCoordinationScheduler, TerminalInputSurfaceKind } from "../../../contracts/presentation/index.js";
+export type PiTuiInputCoordinationDecision = TerminalInputCoordinationDecision;
+export type PiTuiInputSurfaceKind = TerminalInputSurfaceKind;
+export type PiTuiInputCoordinationScheduler = TerminalInputCoordinationScheduler;
 export interface PiTuiInputCoordinationTrace {
     readonly phase: "receipt" | "semantic-start" | "semantic-end";
     readonly revision: number;

package/dist/integrations/pi/tui-runtime/overlay-geometry.d.ts

@@ -1,6 +1,7 @@
 import { TuiAltScreen, type Component, type OverlayHandle, type OverlayOptions } from "@earendil-works/pi-tui";
 import type { PresentationComponentPort, PresentationPointerSurface } from "../../../contracts/presentation/index.js";
-import type { PiTuiOverlayOptions } from "./contracts.js";
+import { samePointerSurfaces } from "../../../contracts/presentation/index.js";
+import type { TerminalOverlayOptions } from "../../../contracts/presentation/index.js";
 /** Observes public component renders in compositor order, without accessing renderer state. */
 export declare class OverlayGeometryTracker {
     #private;
@@ -9,7 +10,7 @@ export declare class OverlayGeometryTracker {
     constructor(publish: (surfaces: readonly PresentationPointerSurface[] | null) => void);
     invalidate(): void;
     begin(columns: number, rows: number): void;
-    record(component: PresentationComponentPort, options: PiTuiOverlayOptions | undefined, width: number, height: number): void;
+    record(component: PresentationComponentPort, options: TerminalOverlayOptions | undefined, width: number, height: number): void;
     end(): void;
 }
 /** The protected composition hook brackets the actual visible, focus-ordered overlay renders. */
@@ -22,11 +23,4 @@ export declare class GeometryObservedAltScreen extends TuiAltScreen {
     hideOverlay(): void;
     protected compositeOverlays(lines: string[], width: number, height: number): string[];
 }
-/** Compare only geometry and ownership, never animation content or transcript position. */
-export declare function samePointerSurfaces(a: readonly PresentationPointerSurface[], b: readonly PresentationPointerSurface[]): boolean;
-/**
- * Resolve the pinned public overlay options against the actual render width/height.
- * The runtime still owns layout and painting. Independent terminal-cell tests certify
- * this option-to-hit-region projection against its compositor, including clipping.
- */
-export declare function overlayPointerSurface(component: PresentationComponentPort, options: PiTuiOverlayOptions | undefined, width: number, renderedHeight: number, columns: number, rows: number): PresentationPointerSurface | undefined;
+export { samePointerSurfaces };

package/dist/integrations/pi/tui-runtime/overlay-geometry.js

@@ -1,4 +1,5 @@
 import { TuiAltScreen, isFocusable } from "@earendil-works/pi-tui";
+import { samePointerSurfaces } from "../../../contracts/presentation/index.js";
 /** Observes public component renders in compositor order, without accessing renderer state. */
 export class OverlayGeometryTracker {
     #frame = [];
@@ -97,20 +98,13 @@ export class GeometryObservedAltScreen extends TuiAltScreen {
         return result;
     }
 }
-/** Compare only geometry and ownership, never animation content or transcript position. */
-export function samePointerSurfaces(a, b) {
-    return a.length === b.length && a.every((surface, index) => {
-        const other = b[index];
-        return surface.component === other.component && surface.columnStart === other.columnStart
-            && surface.columnEnd === other.columnEnd && surface.rowStart === other.rowStart && surface.rowEnd === other.rowEnd;
-    });
-}
+export { samePointerSurfaces };
 /**
  * Resolve the pinned public overlay options against the actual render width/height.
  * The runtime still owns layout and painting. Independent terminal-cell tests certify
  * this option-to-hit-region projection against its compositor, including clipping.
  */
-export function overlayPointerSurface(component, options, width, renderedHeight, columns, rows) {
+function overlayPointerSurface(component, options, width, renderedHeight, columns, rows) {
     const opt = options ?? {};
     const margin = typeof opt.margin === "number"
         ? { top: opt.margin, right: opt.margin, bottom: opt.margin, left: opt.margin }

package/dist/integrations/pi/tui-runtime/presentation-adapter.d.ts

@@ -1,4 +1,4 @@
 import type { PresentationComponentPort, PresentationRuntimePort, PresentationTerminalPort } from "../../../contracts/presentation/index.js";
-import type { PiTuiTerminalPort } from "./contracts.js";
+import type { TerminalPort } from "../../../contracts/presentation/index.js";
 export declare function createPiPresentationRuntime(root: PresentationComponentPort, terminal: PresentationTerminalPort): PresentationRuntimePort;
-export declare function createPiTerminalBridge(terminal: PresentationTerminalPort): PiTuiTerminalPort;
+export declare function createPiTerminalBridge(terminal: PresentationTerminalPort): TerminalPort;

package/dist/integrations/pi/tui-runtime/runtime-factory.d.ts

@@ -0,0 +1,3 @@
+import type { TerminalRuntimeFactory } from "../../../contracts/presentation/index.js";
+/** The Pi TUI runtime behind the neutral terminal runtime factory the shell uses. */
+export declare const PI_TERMINAL_RUNTIME: TerminalRuntimeFactory;

package/dist/integrations/pi/tui-runtime/runtime-factory.js

@@ -0,0 +1,11 @@
+import { legacyKeyInput, PiTuiRuntimeAdapter } from "./adapter.js";
+import { DamageAwareTerminalAdapter, rebaseTerminalDefaultBackground } from "./damage-aware-terminal.js";
+import { classifyPiTuiInput } from "./input-presentation-coordinator.js";
+/** The Pi TUI runtime behind the neutral terminal runtime factory the shell uses. */
+export const PI_TERMINAL_RUNTIME = Object.freeze({
+    createRuntime: options => new PiTuiRuntimeAdapter(options),
+    createDamageTerminal: (terminal, options) => new DamageAwareTerminalAdapter(terminal, options),
+    classifyInput: (data, surface) => classifyPiTuiInput(data, surface),
+    legacyKeyInput: data => legacyKeyInput(data),
+    rebaseDefaultBackground: (content, backgroundAnsi) => rebaseTerminalDefaultBackground(content, backgroundAnsi),
+});

package/dist/ui/components/index.d.ts

@@ -44,7 +44,7 @@ export { displayColumnSlice, displayWidth, displayWordColumnRange, faint, padToW
 export type { DisplayColumnRange, DisplayColumnSlice } from "./text.js";
 export { TEXT_SELECTION_MULTI_CLICK_MS, extendTextSelection, orderedTextSelection, paintTextSelection, plainTextBetweenColumns, pressTextSelection, releaseTextSelection, textSelectionLineExtendColumn, textSelectionPointAt, textSelectionText, usefulTextLineContent, } from "./text-selection.js";
 export type { OrderedTextSelection, TextSelection, TextSelectionClick, TextSelectionLineContent, TextSelectionPoint, TextSelectionPressInput, } from "./text-selection.js";
-export { PLAIN_THEME } from "./theme.js";
-export type { UiTheme, UiThemeToken } from "./theme.js";
+export { PLAIN_THEME, PLAIN_THEME_SOURCE } from "./theme.js";
+export type { ThemeSource, UiTheme, UiThemeBackground, UiThemeToken } from "./theme.js";
 export { menuRowAt, renderValueMenu, valueMenuFrame } from "./value-menu.js";
 export type { ValueMenuAnchor, ValueMenuFrame, ValueMenuLayout, ValueMenuState } from "./value-menu.js";

package/dist/ui/components/index.js

@@ -22,5 +22,5 @@ export { TranscriptViewport, assertTranscriptViewportFrameDescriptor } from "./t
 export { RAIL_COLUMNS, renderEmptyState, withScrollbarRail } from "./surface.js";
 export { displayColumnSlice, displayWidth, displayWordColumnRange, faint, padToWidth, stripAnsi, truncateToWidth } from "./text.js";
 export { TEXT_SELECTION_MULTI_CLICK_MS, extendTextSelection, orderedTextSelection, paintTextSelection, plainTextBetweenColumns, pressTextSelection, releaseTextSelection, textSelectionLineExtendColumn, textSelectionPointAt, textSelectionText, usefulTextLineContent, } from "./text-selection.js";
-export { PLAIN_THEME } from "./theme.js";
+export { PLAIN_THEME, PLAIN_THEME_SOURCE } from "./theme.js";
 export { menuRowAt, renderValueMenu, valueMenuFrame } from "./value-menu.js";

package/dist/ui/components/selection-copy.d.ts

@@ -19,6 +19,5 @@ export interface SelectionCopySnapshot {
     readonly rejected?: "size";
 }
 export declare function selectionCopyLineContent(text: string, prompt: SelectionCopyPrompt): TextSelectionLineContent;
-export declare function literalSelectionCopySnapshot(text: string, revision?: number): SelectionCopySnapshot | null;
 /** Extracts one snapshot row with the existing grapheme/newline policy; run expensive rows off-thread. */
 export declare function selectionCopyRowText(snapshot: Pick<SelectionCopySnapshot, "selection" | "literal">, row: SelectionCopyRow, index: number): string;

package/dist/ui/components/selection-copy.js

@@ -22,18 +22,6 @@ export function selectionCopyLineContent(text, prompt) {
         return { from, to: from + 1 };
     return usefulTextLineContent(plain, from);
 }
-export function literalSelectionCopySnapshot(text, revision = 0) {
-    if (text.trim().length === 0)
-        return null;
-    const selection = {
-        start: { line: 0, column: 0 },
-        end: { line: 0, column: Number.MAX_SAFE_INTEGER },
-    };
-    if (text.length > MAX_COPY_SOURCE_UNITS) {
-        return { literal: true, selection, revision, rows: [], sourceUnits: 0, rejected: "size" };
-    }
-    return { literal: true, selection, revision, rows: [{ text }], sourceUnits: text.length };
-}
 /** Extracts one snapshot row with the existing grapheme/newline policy; run expensive rows off-thread. */
 export function selectionCopyRowText(snapshot, row, index) {
     if (snapshot.literal)

package/dist/ui/components/theme.d.ts

@@ -1,21 +1,6 @@
-export type UiThemeToken = "accent" | "mdHeading" | "text" | "muted" | "dim" | "border" | "error" | "success";
-export interface UiTheme {
-    fg(token: UiThemeToken, text: string): string;
-    bold(text: string): string;
-    /**
-     * The terminal's own foreground, left unpainted. What a list's own text is:
-     * a theme built for a light background would otherwise write near-black rows
-     * into a dark terminal, which is how the engine leaves its lists too.
-     */
-    plain(text: string): string;
-    /** Optional palette preview used by controls that choose the active accent. */
-    accentPreview?(color: string, text: string): string | null;
-    /** Selection background for an active list item or floating-surface row. */
-    highlight(text: string): string;
-    /** A control that is present but cannot act: quieter than quiet text. */
-    disabled(text: string): string;
-    /** Background for a floating surface, so it reads as above the content. */
-    panel(text: string): string;
-}
+import type { ThemeSource, UiTheme, UiThemeBackground, UiThemeToken } from "../../contracts/presentation/index.js";
+export type { ThemeSource, UiTheme, UiThemeBackground, UiThemeToken };
 /** Renders every token as plain text. What tests assert against. */
 export declare const PLAIN_THEME: UiTheme;
+/** A theme source that never changes and paints nothing. */
+export declare const PLAIN_THEME_SOURCE: ThemeSource;