Blocks / Export dialog

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";
/01 → Default
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
PropTypeDefaultDescription
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.
stateidle | 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 / todaystring—The file name: members-2026-11-19.csv.