Invite dialog
Emails pasted by the dozen, teams, a message, then the answer for each: invited, already a member, invalid.
import { InviteDialog, classifyInvites, parseEmails, isInviteEmail, inviteSummary } from "@forgeron/ui";import {
Button,
classifyInvites,
InviteDialog,
type InviteDraft,
type InviteResult,
} from "@forgeron/ui";
import { useState } from "react";
const members = ["ada@example.test", "sam@example.test"];
const teams = [
{ value: "finance", label: "Finance", hint: "4" },
{ value: "support", label: "Support", hint: "9" },
{ value: "ops", label: "Operations", hint: "6" },
];
export default function Default() {
const [open, setOpen] = useState(false);
const [result, setResult] = useState<InviteResult[] | undefined>();
const [draft, setDraft] = useState<InviteDraft>({
emails: ["lea@example.test", "ada@example.test", "not-an-address"],
teams: ["support"],
message: "",
});
return (
<>
<Button onClick={() => setOpen(true)}>Invite people</Button>
{open ? (
<InviteDialog
teams={teams}
members={members}
value={draft}
onChange={setDraft}
result={result}
// A real app sends the request; here every address gets the answer it would.
onInvite={() => setResult(classifyInvites(draft.emails, members))}
onAgain={() => {
setResult(undefined);
setDraft({ emails: [], teams: [], message: "" });
}}
onClose={() => {
setOpen(false);
setResult(undefined);
}}
/>
) : null}
</>
);
}API → Props
| Prop | Type | Default | Description |
|---|---|---|---|
onInvite | ({ emails, teams, message }) => void | — | The valid new addresses, lower-cased, without duplicates. Nothing is sent by the dialog. |
result | { email, outcome: 'invited' | 'member' | 'invalid', detail? }[] | — | While present the dialog shows it in place of the form. |
onAgain | () => void | — | Invite more: clear `result`. |
onClose | () => void | — | Escape, click outside, Cancel, Done. |
teams | ComboboxOption[] | — | Teams they join; none, no picker. |
members | string[] | — | Addresses already in the workspace: left out and counted. |
value / defaultValue / onChange | { emails, teams, message } | — | The draft. |
busy | boolean | — | The request is on its way. |
message / maxEmails / maxMessage | boolean; number; number | — | Options. |