components/activity-line

Import

Import

import * as api from "@fungi.computer/caps/components/activity-line";

Exports

Kind	Export	Description
Ttype alias	ActivityState	Where a piece of agent work stands.
Ttype alias	ActivityLineProps	Props accepted by ActivityLine.
fnfunction	formatElapsed()	Short elapsed time: 0.4s, 4.2s, 42s, 3m 05s.
fnfunction	useElapsed()	A clock that ticks while running and holds still otherwise. Times are epoch milliseconds (Date.now()), owned by the caller.
fnfunction	ActivityLine()	One line of agent activity. While running it says what is happening with a live clock and shows its trace; when done it settles into “Thought for 4.2s” and folds the trace away, one click from reopening.

ActivityStateTtype alias

Signature

type ActivityState = "running" | "done" | "failed";

Where a piece of agent work stands.

---

ActivityLinePropsTtype alias

Signature

type ActivityLineProps = Readonly<{
  state: ActivityState;
  startedAt: number;
  finishedAt?: number;
  label: string;
  doneLabel: string;
  failedLabel?: string;
  children?: ReactNode;
  className?: string;
}>;

Props accepted by ActivityLine.

formatElapsed()fnfunction

Signature

function formatElapsed(milliseconds): string;

Short elapsed time: 0.4s, 4.2s, 42s, 3m 05s.

Parameters

Parameter	Type
milliseconds	number

Returns

string

---

useElapsed()fnfunction

Signature

function useElapsed(startedAt, finishedAt, running): number;

A clock that ticks while running and holds still otherwise. Times are epoch milliseconds (Date.now()), owned by the caller.

Parameters

Parameter	Type
startedAt	number
finishedAt	number | undefined
running	boolean

Returns

number

---

ActivityLine()fnfunction

Signature

function ActivityLine(__namedParameters): Element;

One line of agent activity. While running it says what is happening with a live clock and shows its trace; when done it settles into “Thought for 4.2s” and folds the trace away, one click from reopening.

Parameters

Parameter	Type
__namedParameters	ActivityLineProps

Returns

Element