A local-first multi-agent app development platform, built on PenguinHarness
/**
* A settings entry's head: its title with its description behind a "?", its store name, the
* actions it offers
* (what the deployment must do once on the machine, as buttons beside what each will do) and
* its live notices — a spinner for work in progress, a strip for what needs attention, quiet
* text for the rest; a notice's details fold under it, collapsed (the sandbox's headline
* discloses why an installed backend is not in use). While the group's switch is off (as
* drafted), only the title is drawn: the actions and notices concern the group in use.
*/
import type { PluginConfigEntry } from "@adelie/server/api";
import { Button, HelpFold, InfoPopover, NoticeStrip, Spinner } from "@adelie/ui";
import { S } from "../../lib/strings";
import { toneInk } from "../../lib/tone";
import type { Locale } from "../../state/locale";
import { localizedText } from "../chat/skill-use";
import { switchedOff } from "./plugin-config-draft";
export function ConfigHeading({
entry,
draft,
nested,
disabled,
onAction,
locale,
}: {
entry: PluginConfigEntry;
/** The entry's draft: with its `switch` field off, the actions and notices are hidden. */
draft: Record<string, unknown> | undefined;
/** Drawn inside another entry's card (a sandbox backend's group): a step smaller. */
nested: boolean;
disabled: boolean;
onAction: (action: string) => void;
locale: Locale;
}) {
const localized = (en: string | undefined, zh: string | undefined) =>
en === undefined ? undefined : localizedText(locale, en, zh);
const title = localized(entry.configuration.title, entry.configuration.titleZh) ?? entry.name;
// What the group is for sits behind a "?" beside its title.
const description = localized(entry.configuration.description, entry.configuration.descriptionZh);
const live = !switchedOff(entry, draft);
return (
<div className="space-y-1.5">
<div>
<p
className={`inline-flex items-center gap-1 ${nested ? "text-xs font-semibold" : "text-sm font-semibold"}`}
>
{title}
{description !== undefined && <InfoPopover label={title}>{description}</InfoPopover>}
</p>
<p className="font-mono text-xs text-fg-muted">{entry.name}</p>
</div>
{live && (entry.actions ?? []).length > 0 && (
<div className="space-y-2">
{(entry.actions ?? []).map((action) => {
const description = localized(action.description, action.descriptionZh);
return (
<div key={action.id} className="flex items-start gap-3">
<Button
size="sm"
variant="secondary"
disabled={disabled}
onClick={() => onAction(action.id)}
>
{localized(action.title, action.titleZh) ?? action.title}
</Button>
{description !== undefined && (
<p className="text-xs text-fg-muted">{description}</p>
)}
</div>
);
})}
</div>
)}
{live &&
(entry.notices ?? []).map((notice, i) => {
const details = localized(notice.details, notice.detailsZh);
const line =
notice.tone === "progress" ? (
<p key={i} className={`flex items-center gap-2 text-xs ${toneInk.busy}`}>
<Spinner size="sm" label={S.common.loading} />
<span className="min-w-0 break-words">{localized(notice.text, notice.textZh)}</span>
</p>
) : notice.tone === "attention" ? (
<NoticeStrip tone="attention" as="p" key={i} className="rounded-md px-3 py-2 text-xs">
{localized(notice.text, notice.textZh)}
</NoticeStrip>
) : (
<p key={i} className="text-xs text-fg-muted">
{localized(notice.text, notice.textZh)}
</p>
);
if (details === undefined) return line;
// No title of its own to anchor a "?" to: the fold names itself.
return (
<div key={i} className="space-y-1">
{line}
<HelpFold label={title}>
<p className="whitespace-pre-line break-words">{details}</p>
</HelpFold>
</div>
);
})}
</div>
);
}