@pentoshi/clai 2.0.62 → 3.0.0

package/dist/tui-v2/controllers/overlay-controller.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Single owner of the one blocking overlay (V2-071..076, PICK-002).
+ *
+ * Holds the overlay's data (picker options, confirm prompt, pager body) and
+ * coordinates with `FocusController`'s context stack so opening while one is
+ * already active is rejected (nested-action prevention) and closing restores
+ * whichever base region had focus (focus restoration) — both for free from
+ * `FocusController`'s existing single-slot design, not reimplemented here.
+ */
+import type { FocusController } from "./focus-controller.js";
+import type { PickerOption } from "../rendering/picker-filter.js";
+export type ConfirmKind = "tool" | "pentest" | "reset" | "continue" | "plan" | "switch";
+export interface ConfirmRequest {
+    readonly kind: ConfirmKind;
+    readonly prompt: string;
+}
+export interface PickerRequest {
+    readonly title: string;
+    readonly options: readonly PickerOption[];
+    readonly searchDescription?: boolean | undefined;
+    readonly twoLine?: boolean | undefined;
+    /**
+     * History-oriented chrome: larger panel, session badges, clearer filter
+     * line, and description-aware search.
+     */
+    readonly historyStyle?: boolean | undefined;
+}
+export interface SecretRequestView {
+    readonly title: string;
+    readonly prompt: string;
+}
+export interface PromptActionsRequest {
+    readonly prompt: string;
+    readonly onResend: () => void;
+}
+export type OverlayState = {
+    readonly kind: "none";
+} | {
+    readonly kind: "picker";
+    readonly request: PickerRequest;
+    readonly onSelect: (value: string) => void;
+} | {
+    readonly kind: "confirm";
+    readonly request: ConfirmRequest;
+    readonly resolve: (ok: boolean) => void;
+    readonly onViewPlan?: (() => void) | undefined;
+} | {
+    readonly kind: "secret";
+    readonly request: SecretRequestView;
+    readonly resolve: (value: string | undefined) => void;
+} | {
+    readonly kind: "prompt-actions";
+    readonly request: PromptActionsRequest;
+} | {
+    readonly kind: "pager";
+    readonly title: string;
+    readonly body: string;
+} | {
+    readonly kind: "jobs";
+};
+export type OverlayListener = () => void;
+export declare class OverlayController {
+    private readonly focus;
+    private state;
+    /** Confirm suspended under a plan-detail pager (classic TUI: confirm chrome + pager overlay). */
+    private suspended;
+    private readonly listeners;
+    private closeFocus;
+    constructor(focus: FocusController);
+    getState(): OverlayState;
+    isOpen(): boolean;
+    subscribe(listener: OverlayListener): () => void;
+    openPicker(request: PickerRequest, onSelect: (value: string) => void): boolean;
+    /**
+     * Opens a pager. Allowed over an open plan confirm so "P" can show full
+     * plan detail without resolving the confirm (F-021); closing the pager
+     * restores the suspended confirm. Any other open overlay is still rejected.
+     */
+    openPager(title: string, body: string): boolean;
+    openJobs(): boolean;
+    openPromptActions(request: PromptActionsRequest): boolean;
+    /** Resolves `false` if a blocking overlay was already open rather than hanging. */
+    openConfirm(request: ConfirmRequest, onViewPlan?: () => void): Promise<boolean>;
+    /** Resolves `undefined` if a blocking overlay was already open rather than hanging. */
+    openSecret(request: SecretRequestView): Promise<string | undefined>;
+    answerConfirm(ok: boolean): void;
+    answerSecret(value: string | undefined): void;
+    /** The picker's own `onSelect` decides whether/when to close (e.g. a
+     * provider pick may chain into a secret prompt instead of closing). */
+    selectPicker(value: string): void;
+    close(): void;
+    dispose(): void;
+    private activeConfirm;
+    private open;
+    private suspendUnder;
+    private restoreSuspended;
+    private forceClose;
+    private notify;
+}

package/dist/tui-v2/controllers/overlay-controller.js

@@ -0,0 +1,195 @@
+/**
+ * Single owner of the one blocking overlay (V2-071..076, PICK-002).
+ *
+ * Holds the overlay's data (picker options, confirm prompt, pager body) and
+ * coordinates with `FocusController`'s context stack so opening while one is
+ * already active is rejected (nested-action prevention) and closing restores
+ * whichever base region had focus (focus restoration) — both for free from
+ * `FocusController`'s existing single-slot design, not reimplemented here.
+ */
+const NONE = { kind: "none" };
+export class OverlayController {
+    focus;
+    state = NONE;
+    /** Confirm suspended under a plan-detail pager (classic TUI: confirm chrome + pager overlay). */
+    suspended;
+    listeners = new Set();
+    closeFocus;
+    constructor(focus) {
+        this.focus = focus;
+    }
+    getState() {
+        return this.state;
+    }
+    isOpen() {
+        return this.state.kind !== "none";
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    openPicker(request, onSelect) {
+        return this.open({ kind: "picker", request, onSelect }, "picker");
+    }
+    /**
+     * Opens a pager. Allowed over an open plan confirm so "P" can show full
+     * plan detail without resolving the confirm (F-021); closing the pager
+     * restores the suspended confirm. Any other open overlay is still rejected.
+     */
+    openPager(title, body) {
+        if (this.state.kind === "confirm" && this.state.request.kind === "plan" && !this.suspended) {
+            return this.suspendUnder({ kind: "pager", title, body }, "pager");
+        }
+        return this.open({ kind: "pager", title, body }, "pager");
+    }
+    openJobs() {
+        return this.open({ kind: "jobs" }, "jobs");
+    }
+    openPromptActions(request) {
+        return this.open({ kind: "prompt-actions", request }, "modal");
+    }
+    /** Resolves `false` if a blocking overlay was already open rather than hanging. */
+    openConfirm(request, onViewPlan) {
+        return new Promise((resolve) => {
+            const opened = this.open({ kind: "confirm", request, resolve, onViewPlan }, "modal");
+            if (!opened)
+                resolve(false);
+        });
+    }
+    /** Resolves `undefined` if a blocking overlay was already open rather than hanging. */
+    openSecret(request) {
+        return new Promise((resolve) => {
+            const opened = this.open({ kind: "secret", request, resolve }, "secret");
+            if (!opened)
+                resolve(undefined);
+        });
+    }
+    answerConfirm(ok) {
+        const confirm = this.activeConfirm();
+        if (!confirm)
+            return;
+        const { resolve } = confirm;
+        this.suspended = undefined;
+        this.forceClose();
+        resolve(ok);
+    }
+    answerSecret(value) {
+        if (this.state.kind !== "secret")
+            return;
+        const { resolve } = this.state;
+        this.forceClose();
+        resolve(value);
+    }
+    /** The picker's own `onSelect` decides whether/when to close (e.g. a
+     * provider pick may chain into a secret prompt instead of closing). */
+    selectPicker(value) {
+        if (this.state.kind !== "picker")
+            return;
+        this.state.onSelect(value);
+    }
+    close() {
+        if (this.state.kind === "none")
+            return;
+        if (this.suspended) {
+            this.restoreSuspended();
+            return;
+        }
+        this.forceClose();
+    }
+    dispose() {
+        if (this.suspended?.kind === "confirm")
+            this.suspended.resolve(false);
+        else if (this.state.kind === "confirm")
+            this.state.resolve(false);
+        else if (this.state.kind === "secret")
+            this.state.resolve(undefined);
+        this.suspended = undefined;
+        this.forceClose();
+        this.listeners.clear();
+    }
+    activeConfirm() {
+        if (this.state.kind === "confirm")
+            return this.state;
+        if (this.suspended?.kind === "confirm")
+            return this.suspended;
+        return undefined;
+    }
+    open(next, context) {
+        if (this.state.kind !== "none" || this.suspended)
+            return false;
+        try {
+            this.closeFocus = this.focus.pushOverlay(context);
+        }
+        catch {
+            return false;
+        }
+        this.state = next;
+        this.notify();
+        return true;
+    }
+    suspendUnder(next, context) {
+        this.suspended = this.state;
+        this.closeFocus?.();
+        try {
+            this.closeFocus = this.focus.pushOverlay(context);
+        }
+        catch {
+            this.suspended = undefined;
+            try {
+                this.closeFocus = this.focus.pushOverlay("modal");
+            }
+            catch {
+                this.closeFocus = undefined;
+            }
+            return false;
+        }
+        this.state = next;
+        this.notify();
+        return true;
+    }
+    restoreSuspended() {
+        const previous = this.suspended;
+        this.suspended = undefined;
+        this.closeFocus?.();
+        this.closeFocus = undefined;
+        if (!previous || previous.kind === "none") {
+            this.state = NONE;
+            this.notify();
+            return;
+        }
+        const context = previous.kind === "confirm"
+            ? "modal"
+            : previous.kind === "secret"
+                ? "secret"
+                : previous.kind === "picker"
+                    ? "picker"
+                    : previous.kind === "jobs"
+                        ? "jobs"
+                        : previous.kind === "prompt-actions"
+                            ? "modal"
+                            : "pager";
+        try {
+            this.closeFocus = this.focus.pushOverlay(context);
+            this.state = previous;
+        }
+        catch {
+            this.state = NONE;
+            if (previous.kind === "confirm")
+                previous.resolve(false);
+            else if (previous.kind === "secret")
+                previous.resolve(undefined);
+        }
+        this.notify();
+    }
+    forceClose() {
+        this.state = NONE;
+        this.closeFocus?.();
+        this.closeFocus = undefined;
+        this.notify();
+    }
+    notify() {
+        for (const listener of this.listeners)
+            listener();
+    }
+}
+//# sourceMappingURL=overlay-controller.js.map

package/dist/tui-v2/controllers/overlay-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay-controller.js","sourceRoot":"","sources":["../../../src/tui-v2/controllers/overlay-controller.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAkDH,MAAM,IAAI,GAAiB,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAE5C,MAAM,OAAO,iBAAiB;IAOC;IANrB,KAAK,GAAiB,IAAI,CAAC;IACnC,iGAAiG;IACzF,SAAS,CAA2B;IAC3B,SAAS,GAAG,IAAI,GAAG,EAAmB,CAAC;IAChD,UAAU,CAA2B;IAE7C,YAA6B,KAAsB;QAAtB,UAAK,GAAL,KAAK,CAAiB;IAAG,CAAC;IAEvD,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC;IACpC,CAAC;IAED,SAAS,CAAC,QAAyB;QACjC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7B,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAED,UAAU,CAAC,OAAsB,EAAE,QAAiC;QAClE,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,QAAQ,CAAC,CAAC;IACpE,CAAC;IAED;;;;OAIG;IACH,SAAS,CAAC,KAAa,EAAE,IAAY;QACnC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YAC3F,OAAO,IAAI,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;QACpE,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;IAC5D,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,MAAM,CAAC,CAAC;IAC7C,CAAC;IAED,iBAAiB,CAAC,OAA6B;QAC7C,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;IACjE,CAAC;IAED,mFAAmF;IACnF,WAAW,CAAC,OAAuB,EAAE,UAAuB;QAC1D,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,OAAO,CAAC,CAAC;YACrF,IAAI,CAAC,MAAM;gBAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC,CAAC,CAAC;IACL,CAAC;IAED,uFAAuF;IACvF,UAAU,CAAC,OAA0B;QACnC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAC;YACzE,IAAI,CAAC,MAAM;gBAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QAClC,CAAC,CAAC,CAAC;IACL,CAAC;IAED,aAAa,CAAC,EAAW;QACvB,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;QACrC,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QAC5B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,OAAO,CAAC,EAAE,CAAC,CAAC;IACd,CAAC;IAED,YAAY,CAAC,KAAyB;QACpC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO;QACzC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;QAC/B,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,OAAO,CAAC,KAAK,CAAC,CAAC;IACjB,CAAC;IAED;2EACuE;IACvE,YAAY,CAAC,KAAa;QACxB,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO;QACzC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED,KAAK;QACH,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM;YAAE,OAAO;QACvC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACxB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,UAAU,EAAE,CAAC;IACpB,CAAC;IAED,OAAO;QACL,IAAI,IAAI,CAAC,SAAS,EAAE,IAAI,KAAK,SAAS;YAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;aACjE,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS;YAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;aAC7D,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ;YAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACrE,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;IAEO,aAAa;QACnB,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC;QACrD,IAAI,IAAI,CAAC,SAAS,EAAE,IAAI,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC,SAAS,CAAC;QAC9D,OAAO,SAAS,CAAC;IACnB,CAAC;IAEO,IAAI,CAAC,IAAkB,EAAE,OAAuB;QACtD,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO,KAAK,CAAC;QAC/D,IAAI,CAAC;YACH,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QACpD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,MAAM,EAAE,CAAC;QACd,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,YAAY,CAAC,IAAkB,EAAE,OAAuB;QAC9D,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC;QAC5B,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC;QACpB,IAAI,CAAC;YACH,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QACpD,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;YAC3B,IAAI,CAAC;gBACH,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YACpD,CAAC;YAAC,MAAM,CAAC;gBACP,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;YAC9B,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,MAAM,EAAE,CAAC;QACd,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,gBAAgB;QACtB,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC;QAChC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC;QACpB,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC5B,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC1C,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;YAClB,IAAI,CAAC,MAAM,EAAE,CAAC;YACd,OAAO;QACT,CAAC;QACD,MAAM,OAAO,GACX,QAAQ,CAAC,IAAI,KAAK,SAAS;YACzB,CAAC,CAAC,OAAO;YACT,CAAC,CAAC,QAAQ,CAAC,IAAI,KAAK,QAAQ;gBAC1B,CAAC,CAAC,QAAQ;gBACV,CAAC,CAAC,QAAQ,CAAC,IAAI,KAAK,QAAQ;oBAC1B,CAAC,CAAC,QAAQ;oBACV,CAAC,CAAC,QAAQ,CAAC,IAAI,KAAK,MAAM;wBACxB,CAAC,CAAC,MAAM;wBACR,CAAC,CAAC,QAAQ,CAAC,IAAI,KAAK,gBAAgB;4BAClC,CAAC,CAAC,OAAO;4BACX,CAAC,CAAC,OAAO,CAAC;QACpB,IAAI,CAAC;YACH,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YAClD,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC;QACxB,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;YAClB,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS;gBAAE,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;iBACpD,IAAI,QAAQ,CAAC,IAAI,KAAK,QAAQ;gBAAE,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACnE,CAAC;QACD,IAAI,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;IAEO,UAAU;QAChB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC;QACpB,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC5B,IAAI,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;IAEO,MAAM;QACZ,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS;YAAE,QAAQ,EAAE,CAAC;IACpD,CAAC;CACF"}

package/dist/tui-v2/controllers/selection-controller.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Pane-scoped selection owner (V2-060..064).
+ *
+ * Owns semantic anchors, drag state, keyboard extension, and explicit copy
+ * (Ctrl+Shift+C). Auto-copy-on-release is off by default — OpenTUI native
+ * selection must not be fought by delayed clipboard side-effects.
+ */
+import type { ClipboardPort } from "../../app/ports/clipboard-port.js";
+import type { ActionId } from "../actions/action-id.js";
+import { type SemanticAnchor, type SemanticDocument, type SemanticMovement, type SemanticRange } from "../state/semantic-document.js";
+export type SelectionPane = "transcript" | "plan";
+export type SelectionGranularity = "character" | "word" | "line";
+export interface PointerPosition {
+    readonly x: number;
+    readonly y: number;
+}
+/** Native scroll primitives are injected to keep this controller renderer-independent. */
+export interface DragEdgeScrollPort {
+    startAutoScroll(x: number, y: number): void;
+    updateAutoScroll(x: number, y: number): void;
+    stopAutoScroll(): void;
+}
+export interface PaneSelectionRange extends SemanticRange {
+    readonly pane: SelectionPane;
+}
+export interface SelectionState {
+    readonly activePane: SelectionPane | undefined;
+    readonly range: PaneSelectionRange | undefined;
+    readonly dragging: boolean;
+    readonly autoscrollPane: SelectionPane | undefined;
+}
+export type SelectionCopyResult = {
+    readonly status: "copied";
+    readonly text: string;
+} | {
+    readonly status: "empty";
+} | {
+    readonly status: "failed";
+    readonly error: unknown;
+};
+export type SelectionListener = () => void;
+export interface SelectionControllerOptions {
+    /** Auto-copy on mouse release. Default false (disabled — was breaking touch/TUI). */
+    readonly copyOnRelease?: boolean | undefined;
+}
+export declare class SelectionController {
+    private readonly clipboard;
+    private readonly documents;
+    private readonly scrollPorts;
+    private readonly listeners;
+    private readonly copyOnRelease;
+    private state;
+    constructor(clipboard: ClipboardPort, options?: SelectionControllerOptions);
+    getState(): SelectionState;
+    subscribe(listener: SelectionListener): () => void;
+    setDocument(pane: SelectionPane, document: SemanticDocument): void;
+    registerScrollPort(pane: SelectionPane, port: DragEdgeScrollPort): () => void;
+    beginDrag(pane: SelectionPane, requested: SemanticAnchor, pointer?: PointerPosition): boolean;
+    dragTo(pane: SelectionPane, requested: SemanticAnchor, pointer?: PointerPosition): boolean;
+    finishDrag(): void;
+    click(pane: SelectionPane, requested: SemanticAnchor, granularity?: SelectionGranularity): boolean;
+    extend(pane: SelectionPane, movement: SemanticMovement): boolean;
+    selectAll(pane: SelectionPane): boolean;
+    clear(): void;
+    selectedText(): string;
+    hasSelection(): boolean;
+    copy(): Promise<SelectionCopyResult>;
+    handleAction(action: ActionId, pane: SelectionPane): boolean;
+    dispose(): void;
+    private maybeAutoCopy;
+    private clamp;
+    private startAutoscroll;
+    private updateAutoscroll;
+    private stopAutoscroll;
+    private setState;
+}

package/dist/tui-v2/controllers/selection-controller.js

@@ -0,0 +1,238 @@
+/**
+ * Pane-scoped selection owner (V2-060..064).
+ *
+ * Owns semantic anchors, drag state, keyboard extension, and explicit copy
+ * (Ctrl+Shift+C). Auto-copy-on-release is off by default — OpenTUI native
+ * selection must not be fought by delayed clipboard side-effects.
+ */
+import { sanitizeDisplayText } from "../rendering/sanitize-display.js";
+import { clampSemanticAnchor, compareSemanticAnchors, documentEnd, documentStart, moveSemanticAnchor, normalizeSemanticDocument, semanticLineRange, semanticRangeText, semanticWordRange, } from "../state/semantic-document.js";
+const EMPTY_SELECTION_STATE = {
+    activePane: undefined,
+    range: undefined,
+    dragging: false,
+    autoscrollPane: undefined,
+};
+export class SelectionController {
+    clipboard;
+    documents = new Map();
+    scrollPorts = new Map();
+    listeners = new Set();
+    copyOnRelease;
+    state = EMPTY_SELECTION_STATE;
+    constructor(clipboard, options = {}) {
+        this.clipboard = clipboard;
+        this.copyOnRelease = options.copyOnRelease ?? false;
+    }
+    getState() {
+        return this.state;
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    setDocument(pane, document) {
+        const normalized = normalizeSemanticDocument(document);
+        this.documents.set(pane, normalized);
+        const range = this.state.range;
+        if (!range || range.pane !== pane)
+            return;
+        const anchor = clampSemanticAnchor(normalized, range.anchor, "start");
+        const focus = clampSemanticAnchor(normalized, range.focus, "end");
+        if (!anchor || !focus) {
+            this.clear();
+            return;
+        }
+        this.setState({ ...this.state, range: { pane, anchor, focus } });
+    }
+    registerScrollPort(pane, port) {
+        this.scrollPorts.set(pane, port);
+        return () => {
+            if (this.scrollPorts.get(pane) !== port)
+                return;
+            if (this.state.autoscrollPane === pane)
+                port.stopAutoScroll();
+            this.scrollPorts.delete(pane);
+        };
+    }
+    beginDrag(pane, requested, pointer) {
+        const anchor = this.clamp(pane, requested);
+        if (!anchor)
+            return false;
+        this.stopAutoscroll();
+        this.setState({
+            activePane: pane,
+            range: { pane, anchor, focus: anchor },
+            dragging: true,
+            autoscrollPane: undefined,
+        });
+        if (pointer)
+            this.startAutoscroll(pane, pointer);
+        return true;
+    }
+    dragTo(pane, requested, pointer) {
+        const range = this.state.range;
+        const activePane = this.state.activePane;
+        if (!range || !this.state.dragging || !activePane)
+            return false;
+        if (pointer)
+            this.updateAutoscroll(activePane, pointer);
+        if (pane !== activePane)
+            return false;
+        const focus = this.clamp(pane, requested);
+        if (!focus)
+            return false;
+        this.setState({ ...this.state, range: { ...range, focus } });
+        return true;
+    }
+    finishDrag() {
+        if (!this.state.dragging && !this.state.autoscrollPane)
+            return;
+        this.stopAutoscroll();
+        this.setState({ ...this.state, dragging: false, autoscrollPane: undefined });
+        this.maybeAutoCopy();
+    }
+    click(pane, requested, granularity = "character") {
+        this.finishDrag();
+        const anchor = this.clamp(pane, requested);
+        if (!anchor)
+            return false;
+        const document = this.documents.get(pane);
+        const range = granularity === "word"
+            ? semanticWordRange(document, anchor)
+            : granularity === "line"
+                ? semanticLineRange(document, anchor)
+                : { anchor, focus: anchor };
+        if (!range)
+            return false;
+        this.setState({ activePane: pane, range: { pane, ...range }, dragging: false, autoscrollPane: undefined });
+        this.maybeAutoCopy();
+        return true;
+    }
+    extend(pane, movement) {
+        const document = this.documents.get(pane);
+        if (!document)
+            return false;
+        const existing = this.state.range?.pane === pane ? this.state.range : undefined;
+        const anchor = existing?.anchor ?? documentStart(document);
+        const focus = existing?.focus ?? anchor;
+        if (!anchor || !focus)
+            return false;
+        const nextFocus = moveSemanticAnchor(document, focus, movement);
+        if (!nextFocus)
+            return false;
+        this.finishDrag();
+        this.setState({
+            activePane: pane,
+            range: { pane, anchor, focus: nextFocus },
+            dragging: false,
+            autoscrollPane: undefined,
+        });
+        return true;
+    }
+    selectAll(pane) {
+        const document = this.documents.get(pane);
+        if (!document)
+            return false;
+        const anchor = documentStart(document);
+        const focus = documentEnd(document);
+        if (!anchor || !focus)
+            return false;
+        this.finishDrag();
+        this.setState({ activePane: pane, range: { pane, anchor, focus }, dragging: false, autoscrollPane: undefined });
+        return true;
+    }
+    clear() {
+        this.stopAutoscroll();
+        this.setState(EMPTY_SELECTION_STATE);
+    }
+    selectedText() {
+        const range = this.state.range;
+        if (!range)
+            return "";
+        const document = this.documents.get(range.pane);
+        if (!document || compareSemanticAnchors(document, range.anchor, range.focus) === 0)
+            return "";
+        return sanitizeDisplayText(semanticRangeText(document, range));
+    }
+    hasSelection() {
+        return this.selectedText().length > 0;
+    }
+    async copy() {
+        const text = this.selectedText();
+        if (!text)
+            return { status: "empty" };
+        try {
+            await this.clipboard.writeText(text);
+            return { status: "copied", text };
+        }
+        catch (error) {
+            return { status: "failed", error };
+        }
+    }
+    handleAction(action, pane) {
+        switch (action) {
+            case "selection.copy":
+                void this.copy();
+                return true;
+            case "selection.clear":
+                this.clear();
+                return true;
+            case "selection.select-all":
+                return this.selectAll(pane);
+            case "selection.extend-left":
+                return this.extend(pane, "left");
+            case "selection.extend-right":
+                return this.extend(pane, "right");
+            case "selection.extend-up":
+                return this.extend(pane, "up");
+            case "selection.extend-down":
+                return this.extend(pane, "down");
+            case "selection.extend-word-left":
+                return this.extend(pane, "word-left");
+            case "selection.extend-word-right":
+                return this.extend(pane, "word-right");
+            case "selection.extend-line-start":
+                return this.extend(pane, "line-start");
+            case "selection.extend-line-end":
+                return this.extend(pane, "line-end");
+            default:
+                return false;
+        }
+    }
+    dispose() {
+        this.stopAutoscroll();
+        this.listeners.clear();
+        this.scrollPorts.clear();
+        this.documents.clear();
+    }
+    maybeAutoCopy() {
+        if (this.copyOnRelease && this.selectedText())
+            void this.copy();
+    }
+    clamp(pane, anchor) {
+        const document = this.documents.get(pane);
+        return document ? clampSemanticAnchor(document, anchor) : undefined;
+    }
+    startAutoscroll(pane, pointer) {
+        this.scrollPorts.get(pane)?.startAutoScroll(pointer.x, pointer.y);
+        this.setState({ ...this.state, autoscrollPane: pane });
+    }
+    updateAutoscroll(pane, pointer) {
+        if (this.state.autoscrollPane !== pane)
+            this.startAutoscroll(pane, pointer);
+        else
+            this.scrollPorts.get(pane)?.updateAutoScroll(pointer.x, pointer.y);
+    }
+    stopAutoscroll() {
+        const pane = this.state.autoscrollPane;
+        if (pane)
+            this.scrollPorts.get(pane)?.stopAutoScroll();
+    }
+    setState(next) {
+        this.state = next;
+        for (const listener of this.listeners)
+            listener();
+    }
+}
+//# sourceMappingURL=selection-controller.js.map

package/dist/tui-v2/controllers/selection-controller.js.map

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

package/dist/tui-v2/controllers/toast-controller.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Ephemeral right-edge toast queue (UI chrome, not transcript history).
+ *
+ * Toasts auto-dismiss after a short TTL (default 2s). The host component
+ * handles slide-in / slide-out; this controller only owns data + timers.
+ */
+export type ToastLevel = "info" | "success" | "warn" | "error";
+export interface ToastItem {
+    readonly id: string;
+    readonly message: string;
+    readonly level: ToastLevel;
+    readonly createdAt: number;
+    readonly durationMs: number;
+}
+export interface ShowToastOptions {
+    readonly level?: ToastLevel | undefined;
+    /** Visible lifetime including leave animation; default 2000ms. */
+    readonly durationMs?: number | undefined;
+}
+export type ToastListener = () => void;
+export declare const DEFAULT_TOAST_DURATION_MS = 2000;
+export declare class ToastController {
+    private items;
+    private readonly timers;
+    private readonly listeners;
+    private seq;
+    private disposed;
+    getToasts(): readonly ToastItem[];
+    subscribe(listener: ToastListener): () => void;
+    show(message: string, options?: ShowToastOptions): string;
+    dismiss(id: string): void;
+    clear(): void;
+    dispose(): void;
+    private emit;
+}