opencode-courier 0.7.1 → 0.7.3

package/dist/tree/tui.d.ts

@@ -1,4 +1,7 @@
 import type { Plugin } from "@opencode/plugin/tui";
+import { RGBA, type EasingFunctions } from "@opentui/core";
+import { type Accessor } from "solid-js";
+import { type MascotState, type Token } from "./mascot.js";
 import { type Forgotten, type Row, type Stopped, type Summary, type Wait } from "./rpc.js";
 type Context = Plugin.Context;
 /** The events after which a summary may read differently: a turn started or ended, a request or form, a session made or removed. */
@@ -11,6 +14,62 @@ export declare const PANEL_SETTLE_MS = 1000;
 export declare const PANEL = "courier-tree";
 /** How often the panel redraws its running times and how long ago each last tool call was. */
 export declare const TICK_MS = 1000;
+/** The panel's animation frame: the spinner's step, and how often a flash or the bar's easing moves. */
+export declare const FRAME_MS = 90;
+/** How long a row's background takes to fade back from its flash after its report arrives: the report's hold. */
+export declare const FLASH_MS = 1500;
+/** How long the header's bar takes to grow, or shrink, to its new length. */
+export declare const BAR_MS = 450;
+/** Whether the panel animates: unless the TUI part's options say `"animations": false`, as the plugin API has no TUI setting for it. */
+export declare function animationsOn(options: Readonly<Record<string, unknown>> | undefined): boolean;
+/** A value eased over the panel's frames by OpenTUI's `Timeline`; reading it in a computation follows the frames. */
+export type Tween = {
+    readonly value: () => number;
+    readonly done: () => boolean;
+};
+/**
+ * The panel's one timer: a frame every `FRAME_MS` while a tween moves or an `animates` predicate holds, every `every` while
+ * only slower ones do, none otherwise, with animations off or once the panel is gone. `frame` counts in `FRAME_MS`.
+ */
+export type Motion = {
+    readonly enabled: boolean;
+    readonly frame: Accessor<number>;
+    readonly animates: (when: Accessor<boolean>, every?: number) => void;
+    readonly tween: (from: number, to: number, duration: number, ease: EasingFunctions) => Tween;
+};
+/** The panel's `Motion`, owned by the computation it is made in. */
+export declare function createMotion(enabled: boolean): Motion;
+/**
+ * Each row's flash, by session, from a read of the rows to the next that finds its report turned to `reported`; not on
+ * the first read. `strength` is a row's, 1 when its report arrives down to 0; `reported` holds for `FLASH_MS` after one.
+ */
+export declare function createFlashes(motion: Motion, rows: Accessor<ReadonlyArray<Row>>): {
+    strength: (sessionID: string) => number;
+    reported: () => boolean;
+};
+/** The header bar's filled cells, eased over `BAR_MS` to its new length once it is shown, at once when it first is. */
+export declare function createBarFill(motion: Motion, counts: Accessor<{
+    reported: number;
+    started: number;
+}>): () => number;
+/** True for `FLASH_MS` after a read of the tree finds a session the one before it did not have; not on the first read. */
+export declare function createSpawns(motion: Motion, rows: Accessor<ReadonlyArray<Row> | undefined>): () => boolean;
+/** Digby's state for the tree's rows, by `summaryLine`'s priority, unless a report or a spawn just arrived. */
+export declare function mascotState(rows: ReadonlyArray<Row>, { reported, spawned }?: {
+    reported?: boolean | undefined;
+    spawned?: boolean | undefined;
+}): MascotState;
+/** What the tree's sessions do, as the header's second line says it: "1 waiting on you · 2 running"; empty with none live. */
+export declare function countsLine(rows: ReadonlyArray<Row>): string;
+/** The panel's size below which it shows no header glyph, so the header keeps to one line and its bar is not cut. */
+export declare const GLYPH_ROWS = 12;
+export declare const GLYPH_COLUMNS = 54;
+/** The empty panel's height from which it shows the 16×16. */
+export declare const ART_ROWS = 14;
+/** The rows left free below the tree's last row from which the 16×16 shows there. */
+export declare const BELOW_ROWS = 10;
+/** `tint` over `rest` by `amount`, from 0 (all `rest`) to 1 (all `tint`). */
+export declare function blend(tint: RGBA, rest: RGBA, amount: number): RGBA;
 /**
  * The status entry's text, such as "courier 1 waiting on you · 2 running · group pair 1/2"; empty when there is nothing to show.
  * Within `maxWidth` it keeps whole parts, most important first, and counts the groups it drops: "· +2 groups".
@@ -23,17 +82,47 @@ export declare function parts(rows: ReadonlyArray<Row>, parentID: string): {
     reported: number;
     started: number;
 };
-/** A bar of parts reported, `width` cells wide: "[████░░░░░░] 2/5 reported". */
-export declare function bar({ reported, started }: {
+/** How many of a bar's `width` cells are filled for the parts reported. */
+export declare function filledCells({ reported, started }: {
     reported: number;
     started: number;
-}, width?: number): string;
+}, width?: number): number;
+/** A bar of parts reported, `width` cells wide: "[████░░░░░░] 2/5 reported"; `filled` cells of it while it eases to its length. */
+export declare function bar(counts: {
+    reported: number;
+    started: number;
+}, width?: number, filled?: number): string;
 /** What a paused session waits on, such as "asks permission: shell echo hi" or "shows a form: Web Search". */
 export declare function waitLine(wait: Wait): string;
 /** What a row's session is doing, its report and its group standing: "idle · reported done · group pair held". */
 export declare function statusLine(row: Row): string;
-/** A leaf's activity: how long it has run, its last tool call and how long ago, and its cost. */
-export declare function activityLine(row: Row, now: number): string;
+/** The parts of `statusLine`, each with the row part the panel colours it as. */
+export declare function statusParts(row: Row): {
+    text: string;
+    kind: "state" | "report" | "plain";
+}[];
+type Feedback<Color> = {
+    text: {
+        feedback: Record<"error" | "warning" | "success" | "info", {
+            base: Color;
+        }>;
+    };
+};
+/** The running mark's frames, one every `FRAME_MS`. */
+export declare const SPINNER: string[];
+/**
+ * The one cell a row's state shows and its theme colour, the blank cell of one with no mark: this is the only place that
+ * chooses them. A running row spins through `SPINNER` at the panel's `frame`, and shows `•` with none (animations off).
+ */
+export declare function rowMark<Color>(row: Row, theme: Feedback<Color>, frame?: number): {
+    mark: string;
+    color: Color | undefined;
+};
+/** Past this fraction of its window, a session's context use is shown in the warning colour. */
+export declare const CONTEXT_WARN = 0.8;
+/** A leaf's activity: how long it has run, its last tool call and how long ago, its context use and its cost. */
+export declare function activityParts(row: Row, now: number): string[];
+export declare const activityLine: (row: Row, now: number) => string;
 /** What a stalled session's row, or the panel of one, says of it: "a message waits in its inbox since 2m 05s, woken again in vain". */
 export declare function stalledLine(since: number, now: number): string;
 /** The lines a row shows under its title: an orchestrator's bar, a paused or stalled session's wait, or else a live leaf's activity. */
@@ -49,6 +138,16 @@ export declare function addTreeStatus(ctx: Context, onWaiting?: (sessionID: stri
 export declare function stoppedLine({ stopped, cancelled }: Stopped): string;
 /** The toast after a forget, as courier_cleanup reports it: forgotten, its worktree removed or already gone, or kept and why. */
 export declare function forgottenLine(title: string, result: Forgotten): string;
+/** The one place Digby's pixel tokens take a theme colour. */
+export declare const digbyColours: (theme: Context["theme"]) => Record<Token, RGBA>;
+/**
+ * A row's background at rest: the selection's while the panel has the keyboard, else one step quieter under the pointer,
+ * else none, the panel's.
+ */
+export declare function restBackground(theme: Context["theme"], { selected, hovered }: {
+    selected: boolean;
+    hovered: boolean;
+}): RGBA | undefined;
 /** The usage the `/courier` command shows for an input it does not know. */
 export declare const USAGE = "/courier tree opens the session tree; /courier stop [session] stops a session and those under it";
 /**