@superxd-studio/adptr 0.5.0 → 0.6.0

package/types/reusable/interactions/progress.d.ts

@@ -0,0 +1,45 @@
+import { type ReactNode } from "react";
+/** Working, possibly stuck, waiting for the person, or done */
+export type TaskProgressStatus = "working" | "stuck" | "needs-you" | "done";
+export interface TaskProgressMove {
+    id: string;
+    label: string;
+    onPress: () => void;
+    primary?: boolean;
+}
+export interface TaskProgressProps {
+    /** The task, in words: "Building the new pricing page". Shown once it's done. */
+    task: string;
+    /** What it's doing now, in human words: "Testing the annual toggle", not "Running command" */
+    now: string;
+    /** The agent's plan */
+    stages: readonly string[];
+    /** The stage it's on, from 0. Stages before it are done; stages.length means all done. */
+    stage: number;
+    status?: TaskProgressStatus;
+    /** Time as a range, never a countdown: "~3–8 min left" */
+    estimate: string;
+    /** What the estimate is based on: "From the last 20 runs" */
+    basis?: string;
+    /** Counted progress, when the work can be counted */
+    counted?: {
+        label: string;
+        value: number;
+        max: number;
+        valueLabel?: string;
+    };
+    /** Why the estimate changed */
+    changed?: ReactNode;
+    /** Whether it needs the person, in words. Defaults to "No action needed". */
+    needs?: string;
+    /** Shows Review on the line while it needs the person */
+    onReview?: () => void;
+    /** Moves such as Keep waiting or Stop, at the right end */
+    moves?: readonly TaskProgressMove[];
+    defaultExpanded?: boolean;
+}
+/**
+ * Agent task progress, in one line: what it's doing, how many stages are done and roughly how
+ * long is left. Progress is a fact; time is a range with its basis. It opens to the stages.
+ */
+export declare function TaskProgress({ task, now, stages, stage, status, estimate, basis, counted, changed, needs, onReview, moves, defaultExpanded, }: TaskProgressProps): import("react").JSX.Element;

package/types/reusable/interactions/receipt.d.ts

@@ -0,0 +1,54 @@
+import { type ReactNode } from "react";
+/** How it went: as approved, differently, partly, not at all, not known yet, or undone */
+export type ReceiptOutcome = "done" | "different" | "partial" | "failed" | "unknown" | "undone";
+export type ReceiptChangeState = "changed" | "not-changed" | "unknown" | "reverted";
+export interface ReceiptChange {
+    id: string;
+    /** What changed, in a word or two: "Padding" */
+    what: string;
+    /** How: "12 → 16px" */
+    detail: string;
+    state?: ReceiptChangeState;
+    /** Your own word for the state, such as "Held back" */
+    stateLabel?: string;
+    /** This line's own way back, available while undo is open */
+    back?: {
+        label: string;
+        onPress: () => void;
+    };
+}
+export interface ReceiptAction {
+    id: string;
+    label: string;
+    onPress: () => void;
+    primary?: boolean;
+}
+export interface ActionReceiptProps {
+    outcome: ReceiptOutcome;
+    /** What happened, as a fact with its scale: "Updated the shared Button on 34 screens" */
+    title: string;
+    /** When, and who approved it: "3:41pm · approved by you" */
+    meta?: string;
+    /** What differs from what was approved, or why: said before anything else */
+    note?: ReactNode;
+    changes: readonly ReceiptChange[];
+    /**
+     * A choice with too many answers for buttons, handed back to the person to answer in the
+     * conversation: "What should happen to the 3 locked screens? Reply to the build agent."
+     */
+    ask?: ReactNode;
+    /** Next moves such as Try again or Check what happened; they sit at the right end */
+    actions?: readonly ReceiptAction[];
+    /** When the ways back close. Shows a quiet countdown in whole minutes. */
+    undoClosesAt?: Date;
+    /** When undo closes, in words, for screen readers: "to undo, until 3:51pm" */
+    undoClosesLabel?: string;
+    /** While the host checks what happened */
+    checking?: boolean;
+}
+/**
+ * The Action Receipt: what happened after the person approved, what changed, and how to undo
+ * it. Each change is a line with its own way back while undo is open, and a quiet countdown
+ * says how long that lasts. Facts, not reassurance; the host proves what happened.
+ */
+export declare function ActionReceipt({ outcome, title, meta, note, changes, ask, actions, undoClosesAt, undoClosesLabel, checking, }: ActionReceiptProps): import("react").JSX.Element;

package/types/reusable/interactions/run.d.ts

@@ -0,0 +1,83 @@
+import { type ReactNode } from "react";
+/**
+ * What a dot says: green when a step succeeded, grey for thoughts and the agent's words (smaller
+ * for thoughts), blue while waiting for the person, the pixel matrix while working.
+ */
+export type RunDot = "success" | "note" | "thought" | "waiting" | "working";
+/** Inside a run, a Decision Gate becomes the run's next entry */
+export declare const RunContext: import("react").Context<boolean>;
+export declare const useInRun: () => boolean;
+/**
+ * An agent's run as a timeline, like Claude Code or VS Code: one rail down the left through a
+ * dot for each entry. Put RunStep, RunThought, RunMessage, a DecisionGate and RunWorking inside.
+ */
+export declare function RunTimeline({ label, children }: {
+    label?: string;
+    children: ReactNode;
+}): import("react").JSX.Element;
+/**
+ * One entry: a dot and what happened. The rail runs from the first dot to the last. A text
+ * entry's dot sits on its first line; a card's sits level with the card's tile.
+ */
+export declare function RunEntry({ dot, card, children, }: {
+    dot: RunDot;
+    card?: boolean;
+    children: ReactNode;
+}): import("react").JSX.Element;
+/** A file the agent touched */
+export interface RunFile {
+    name: string;
+    path: string;
+    /** Its contents, or the part worth showing: opens when the name is pressed */
+    lines: readonly string[];
+}
+/** A file's name, as a link to it: ultramarine and monospaced, opening when pressed */
+export declare function RunFileLink({ file }: {
+    file: RunFile;
+}): import("react").JSX.Element;
+/** The icon beside what a step did, as in Claude Code */
+declare const kindIcons: {
+    read: {
+        ({ className, ...props }: import("../../components/icons.js").IconProps): import("react").JSX.Element;
+        displayName: string;
+    };
+    edit: {
+        ({ className, ...props }: import("../../components/icons.js").IconProps): import("react").JSX.Element;
+        displayName: string;
+    };
+    run: {
+        ({ className, ...props }: import("../../components/icons.js").IconProps): import("react").JSX.Element;
+        displayName: string;
+    };
+};
+/**
+ * A step that succeeded: an icon and what it did, to which file or with which command, and what
+ * came of it underneath. An edit can show how many lines changed and its first lines.
+ */
+export declare function RunStep({ kind, icon, verb, file, command, result, added, removed, preview, }: {
+    /** Picks the icon beside the verb: an open book, a pencil or a terminal */
+    kind?: keyof typeof kindIcons;
+    /** Your own icon, for any other kind of step, sized like the text */
+    icon?: ReactNode;
+    verb: string;
+    file?: RunFile;
+    command?: string;
+    result?: string;
+    added?: number;
+    removed?: number;
+    /** Show the file's first lines under the step, fading out, as VS Code does for an edit */
+    preview?: boolean;
+}): import("react").JSX.Element;
+/** A thought, such as "Thought for 12s": a smaller grey dot and quiet text */
+export declare function RunThought({ children }: {
+    children: ReactNode;
+}): import("react").JSX.Element;
+/** The agent, in its own words */
+export declare function RunMessage({ children }: {
+    children: ReactNode;
+}): import("react").JSX.Element;
+/** What the agent is doing now, with the working matrix */
+export declare function RunWorking({ children }: {
+    children: ReactNode;
+}): import("react").JSX.Element;
+export {};

package/types/reusable/ui/index.d.ts

@@ -14,6 +14,7 @@ export { Avatar } from "../../components/avatar.js";
 export { Skeleton } from "../../components/skeleton.js";
 export { Spinner } from "../../components/spinner.js";
 export { ScrollArea } from "../../components/scroll-area.js";
+export { Peek } from "../../components/peek.js";
 export { ResponsiveOverlay } from "../../components/responsive-overlay.js";
 export { DateTimeField } from "../../components/date-time-field.js";
 export { ScenarioPicker } from "../../components/scenario-picker/index.js";

package/ui/index.js

@@ -1,4 +1,4 @@
 "use client";
-import { a as e, i as t, n, o as r, r as i, t as a } from "../chunks/callout-DKMHSnjc.js";
-import { A as o, C as s, D as c, E as l, F as u, M as d, N as f, O as p, P as m, S as h, T as g, _, a as v, b as y, c as b, d as x, f as S, g as C, h as w, i as T, j as E, k as D, l as O, m as k, n as A, o as j, p as M, r as N, s as P, t as F, u as I, v as L, w as R, x as z, y as B } from "../chunks/ui-9DyNsYXY.js";
-export { y as Accordion, I as AspectRatio, j as Avatar, x as Badge, z as Breadcrumbs, n as Button, i as ButtonLink, a as Callout, S as Card, c as Checkbox, p as CheckboxGroup, M as DataTable, A as DateTimeField, D as Form, k as KeyboardHint, h as Menu, s as ModalDialog, R as Pagination, w as Progress, o as RadioGroup, N as ResponsiveOverlay, F as ScenarioPicker, T as ScrollArea, b as SearchPicker, P as SegmentedControl, E as Select, C as Separator, v as Skeleton, d as Slider, r as Spinner, O as Switch, g as Tabs, f as TextField, t as TextLink, _ as ToastRegion, m as Toggle, l as Tooltip, e as buttonStyles, L as createNotificationQueue, B as sortRows, u as uiCopy };
+import { a as e, i as t, n, o as r, r as i, t as a } from "../chunks/callout-B89MDU9m.js";
+import { A as o, C as s, D as c, E as l, F as u, I as d, M as f, N as p, O as m, P as h, S as g, T as _, _ as v, a as y, b, c as x, d as S, f as C, g as w, h as T, i as E, j as D, k as O, l as k, m as A, n as j, o as M, p as N, r as P, s as F, t as I, u as L, v as R, w as z, x as B, y as V } from "../chunks/ui-WR0qTNm7.js";
+export { B as Accordion, S as AspectRatio, F as Avatar, C as Badge, g as Breadcrumbs, n as Button, i as ButtonLink, a as Callout, N as Card, m as Checkbox, O as CheckboxGroup, A as DataTable, j as DateTimeField, o as Form, T as KeyboardHint, s as Menu, z as ModalDialog, _ as Pagination, E as Peek, w as Progress, D as RadioGroup, P as ResponsiveOverlay, I as ScenarioPicker, y as ScrollArea, k as SearchPicker, x as SegmentedControl, f as Select, v as Separator, M as Skeleton, p as Slider, r as Spinner, L as Switch, l as Tabs, h as TextField, t as TextLink, R as ToastRegion, u as Toggle, c as Tooltip, e as buttonStyles, V as createNotificationQueue, b as sortRows, d as uiCopy };