Export dialog
Format, columns, range and a preview count; progress and the download from props.
import { ExportDialog, exportProblem, exportFilename, exportPercent, DEFAULT_EXPORT_FORMATS } from "@forgeron/ui";import { Button, ExportDialog, type ExportState } from "@forgeron/ui";
import { useEffect, useRef, useState } from "react";
const columns = [
{ id: "name", label: "Name" },
{ id: "email", label: "Email", hint: "personal" },
{ id: "team", label: "Team" },
{ id: "joined", label: "Joined" },
{ id: "last", label: "Last seen" },
{ id: "status", label: "Status" },
];
const ranges = [
{ value: "all", label: "Everyone", count: 1284 },
{ value: "filtered", label: "Current filter", count: 37 },
{ value: "selected", label: "Selection", count: 3 },
];
export default function Default() {
const [open, setOpen] = useState(false);
const [state, setState] = useState<ExportState>({ status: "idle" });
const timer = useRef<ReturnType<typeof setInterval> | undefined>(undefined);
useEffect(() => () => clearInterval(timer.current), []);
const start = () => {
let progress = 0;
setState({ status: "running", progress });
clearInterval(timer.current);
timer.current = setInterval(() => {
progress += 0.12;
if (progress >= 1) {
clearInterval(timer.current);
setState({
status: "done",
href: "#",
filename: "members-2026-11-19.csv",
rows: 1284,
size: "212 KB",
});
} else setState({ status: "running", progress, rows: Math.round(progress * 1284) });
}, 350);
};
return (
<>
<Button onClick={() => setOpen(true)}>Export</Button>
{open ? (
<ExportDialog
title="Export members"
columns={columns}
ranges={ranges}
name="Members"
today="2026-11-19"
state={state}
onExport={start}
onCancel={() => {
clearInterval(timer.current);
setState({ status: "idle" });
}}
onClose={() => {
clearInterval(timer.current);
setOpen(false);
setState({ status: "idle" });
}}
/>
) : null}
</>
);
}API → Props
| Prop | Type | Default | Description |
|---|---|---|---|
columns | { id, label, hint? }[] | — | What can be included. |
formats / ranges | { value, label, description? }[]; { value, label, count? }[] | — | Default CSV, JSON, NDJSON; everything. |
value / defaultValue / onChange | { format, columns, range } | — | What is asked for. |
state | idle | running { progress?, rows? } | done { href?, filename?, rows?, size? } | error { message } | — | Where the export stands, as the app reports it. |
onExport / onCancel / onClose | (request) => void; () => void; () => void | — | Columns come back in their order. |
name / today | string | — | The file name: members-2026-11-19.csv. |