@vamos-ui/react 0.0.0-stage → 0.3.0

package/dist/business/export.d.ts

@@ -0,0 +1,148 @@
+import * as React from "react";
+import { type LabelFn } from "../lib/labels.js";
+import { Button } from "../components/button.js";
+import type { ListState } from "../data-table/types.js";
+import { type CsvExportOptions, type ExportColumn, type ExportFormat } from "./export-core.js";
+export declare const exportLabels: {
+    title: string;
+    description: string;
+    scope: string;
+    scopeSelected: string;
+    scopeFiltered: string;
+    scopeAll: string;
+    scopeFilteredHint: string;
+    scopeFilteredHintNoQ: string;
+    rows: string;
+    noneSelected: string;
+    columns: string;
+    columnsCount: string;
+    selectAll: string;
+    searchColumns: string;
+    noColumns: string;
+    personal: string;
+    mask: string;
+    maskHint: string;
+    format: string;
+    csv: string;
+    csvHint: string;
+    comma: string;
+    semicolon: string;
+    tab: string;
+    pointDecimal: string;
+    commaDecimal: string;
+    xlsx: string;
+    xlsxHint: string;
+    json: string;
+    jsonHint: string;
+    privacyTitle: string;
+    privacyBody: string;
+    reason: string;
+    reasonHint: string;
+    reasonMissing: string;
+    reasonPlaceholder: string;
+    background: string;
+    export: string;
+    exporting: string;
+    cancel: string;
+    close: string;
+    nothing: string;
+    noColumnsSelected: string;
+    queued: string;
+    running: string;
+    done: string;
+    failed: string;
+    download: string;
+    retry: string;
+    saved: string;
+    quick: string;
+};
+export type ExportLabels = typeof exportLabels;
+export type ExportScope = "selected" | "filtered" | "all";
+export interface ExportRequest {
+    scope: ExportScope;
+    /** Column ids in the chosen order. */
+    columns: string[];
+    /** Column ids to write masked. */
+    masked: string[];
+    format: ExportFormat;
+    reason?: string;
+    csv: Required<CsvExportOptions>;
+    /** Suggested file name ("contacts-2026-11-10.csv"). */
+    filename: string;
+}
+export type ExportResult = {
+    blob: Blob;
+    filename?: string;
+} | {
+    jobId: string;
+};
+export interface ExportJobState {
+    status: "queued" | "running" | "done" | "failed";
+    /** 0–100. */
+    progress?: number;
+    url?: string;
+    error?: string;
+}
+export interface ExportDialogProps {
+    columns: ExportColumn[];
+    /** What "Current view" means: filters and search of the list. */
+    listState?: ListState;
+    selectedCount?: number;
+    /** Rows matching the current view. */
+    filteredCount?: number;
+    totalCount?: number;
+    /** Plural noun for titles ("contacts"). Default "records". */
+    resource?: string;
+    formats?: ExportFormat[];
+    csv?: CsvExportOptions;
+    /** `true` always asks for a reason; `"personal-data"` only when unmasked personal columns are included. */
+    requireReason?: boolean | "personal-data";
+    /** Rows above this are announced as a background job. Default 10,000. */
+    syncLimit?: number;
+    onExport: (request: ExportRequest) => Promise<ExportResult>;
+    /** Polled every 1.5 s for background jobs. */
+    pollJob?: (jobId: string) => Promise<ExportJobState>;
+    presentation?: "dialog" | "sheet";
+    /** The element that opens the dialog (rendered with `asChild`). */
+    trigger?: React.ReactElement;
+    open?: boolean;
+    defaultOpen?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    defaultScope?: ExportScope;
+    defaultFormat?: ExportFormat;
+    labels?: Partial<ExportLabels>;
+}
+/**
+ * Export a collection: scope (selected / current view / all), columns (searchable, reorderable,
+ * personal data maskable), format (CSV / XLSX / JSON with locale CSV conventions), a reason for
+ * personal-data exports and background jobs with a download link.
+ *
+ * ```tsx
+ * <ExportDialog resource="contacts" columns={columns} listState={state} selectedCount={3} filteredCount={248} totalCount={1240}
+ *   trigger={<Button><Download /> Export</Button>}
+ *   onExport={async (r) => ({ blob: await exportToBlob({ rows, columns: pick(r.columns), format: r.format, masked: r.masked }) })} />
+ * ```
+ */
+export declare function ExportDialog(props: ExportDialogProps): React.JSX.Element;
+export interface ExportJobStatusProps {
+    job: ExportJobState;
+    filename: string;
+    onRetry?: () => void;
+    labels?: Partial<ExportLabels>;
+    className?: string;
+}
+/** Background export progress: queued → running (progress bar) → done (focusable download link) / failed (retry). */
+export declare function ExportJobStatus({ job, filename, onRetry, labels, className, t: tProp, downloadRef, }: ExportJobStatusProps & {
+    t?: LabelFn<ExportLabels>;
+    downloadRef?: React.Ref<HTMLAnchorElement>;
+}): React.JSX.Element;
+export interface QuickExportButtonProps extends Omit<React.ComponentProps<typeof Button>, "onClick"> {
+    /** Exports the current view with default columns. Return a Blob to download it. */
+    onExport: () => Promise<{
+        blob: Blob;
+        filename: string;
+    }>;
+    labels?: Partial<ExportLabels>;
+}
+/** One click: current view, default columns, default format. */
+export declare function QuickExportButton({ onExport, labels, children, ...props }: QuickExportButtonProps): React.JSX.Element;

package/dist/business/export.js

@@ -0,0 +1,264 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import * as React from "react";
+import { Download, FileSpreadsheet, FileText, Braces, Search, ShieldAlert, RotateCw } from "lucide-react";
+import { cn } from "../lib/cn.js";
+import { useLabels } from "../lib/labels.js";
+import { useLocale } from "../lib/locale.js";
+import { foldText } from "../lib/text.js";
+import { Button } from "../components/button.js";
+import { Badge } from "../components/badge.js";
+import { Alert } from "../components/alert.js";
+import { Checkbox } from "../components/checkbox.js";
+import { Input, Field, Textarea } from "../components/input.js";
+import { RadioGroup } from "../components/radio-group.js";
+import { Progress } from "../components/progress.js";
+import { Dialog, DialogBody, DialogContent, DialogFooter, DialogHeader, DialogTrigger } from "../components/dialog.js";
+import { Sheet, SheetBody, SheetContent, SheetFooter, SheetHeader, SheetTrigger } from "../components/sheet.js";
+import { Sortable, SortableHandle, SortableItem } from "../sortable/sortable.js";
+import { csvDelimiter } from "../data-table/csv.js";
+import { downloadBlob, exportFilename } from "./export-core.js";
+export const exportLabels = {
+    title: "Export {resource}",
+    description: "Choose rows, columns and a file format.",
+    scope: "Rows",
+    scopeSelected: "Selected rows",
+    scopeFiltered: "Current view",
+    scopeAll: "All {resource}",
+    scopeFilteredHint: "{count} filters · search “{q}”",
+    scopeFilteredHintNoQ: "{count, plural, =0 {No filters} one {# filter} other {# filters}}",
+    rows: "{count, plural, one {# row} other {# rows}}",
+    noneSelected: "Select rows in the list first",
+    columns: "Columns",
+    columnsCount: "{selected} of {total}",
+    selectAll: "All columns",
+    searchColumns: "Find a column",
+    noColumns: "No column matches “{q}”",
+    personal: "Personal data",
+    mask: "Mask",
+    maskHint: "Masked: {label}",
+    format: "Format",
+    csv: "CSV",
+    csvHint: "{delimiter}-separated · {decimal} decimals · UTF-8",
+    comma: "Comma",
+    semicolon: "Semicolon",
+    tab: "Tab",
+    pointDecimal: "point",
+    commaDecimal: "comma",
+    xlsx: "Excel (XLSX)",
+    xlsxHint: "One sheet, typed number and date cells",
+    json: "JSON",
+    jsonHint: "Array of objects, for developers and APIs",
+    privacyTitle: "This export contains personal data",
+    privacyBody: "{columns} will leave the system unmasked. Exports are logged with your name and reason.",
+    reason: "Reason for export",
+    reasonHint: "Kept in the audit log (KVKK / GDPR).",
+    reasonMissing: "Add a reason to export personal data.",
+    reasonPlaceholder: "What is this file for?",
+    background: "Large export: it runs in the background and you get a link when it's ready.",
+    export: "Export",
+    exporting: "Exporting…",
+    cancel: "Cancel",
+    close: "Close",
+    nothing: "Nothing to export",
+    noColumnsSelected: "Pick at least one column",
+    queued: "Queued",
+    running: "Preparing file…",
+    done: "Your file is ready",
+    failed: "Export failed",
+    download: "Download {filename}",
+    retry: "Try again",
+    saved: "Saved {filename}",
+    quick: "Export",
+};
+function activeFilterCount(ls) {
+    if (!ls?.filters)
+        return 0;
+    const walk = (g) => g.clauses.reduce((n, c) => n + ("clauses" in c ? walk(c) : 1), 0);
+    return walk(ls.filters);
+}
+/**
+ * Export a collection: scope (selected / current view / all), columns (searchable, reorderable,
+ * personal data maskable), format (CSV / XLSX / JSON with locale CSV conventions), a reason for
+ * personal-data exports and background jobs with a download link.
+ *
+ * ```tsx
+ * <ExportDialog resource="contacts" columns={columns} listState={state} selectedCount={3} filteredCount={248} totalCount={1240}
+ *   trigger={<Button><Download /> Export</Button>}
+ *   onExport={async (r) => ({ blob: await exportToBlob({ rows, columns: pick(r.columns), format: r.format, masked: r.masked }) })} />
+ * ```
+ */
+export function ExportDialog(props) {
+    const { presentation = "dialog", trigger, open: openProp, defaultOpen = false, onOpenChange, labels, resource = "records" } = props;
+    const t = useLabels("export", exportLabels, labels);
+    const [inner, setInner] = React.useState(defaultOpen);
+    const open = openProp ?? inner;
+    const setOpen = (o) => {
+        if (openProp === undefined)
+            setInner(o);
+        onOpenChange?.(o);
+    };
+    const title = t("title", { resource });
+    if (presentation === "sheet") {
+        return (_jsxs(Sheet, { open: open, onOpenChange: setOpen, children: [trigger ? _jsx(SheetTrigger, { asChild: true, children: trigger }) : null, _jsxs(SheetContent, { size: "md", children: [_jsx(SheetHeader, { title: title, description: t("description") }), open ? _jsx(ExportForm, { ...props, t: t, onClose: () => setOpen(false), Body: SheetBody, Footer: SheetFooter }) : null] })] }));
+    }
+    return (_jsxs(Dialog, { open: open, onOpenChange: setOpen, children: [trigger ? _jsx(DialogTrigger, { asChild: true, children: trigger }) : null, _jsxs(DialogContent, { size: "lg", mobile: "fullscreen", children: [_jsx(DialogHeader, { title: title, description: t("description") }), open ? _jsx(ExportForm, { ...props, t: t, onClose: () => setOpen(false), Body: DialogBody, Footer: DialogFooter }) : null] })] }));
+}
+function ExportForm({ columns, listState, selectedCount = 0, filteredCount, totalCount, resource = "records", formats = ["csv", "xlsx"], csv, requireReason = "personal-data", syncLimit = 10_000, onExport, pollJob, defaultScope, defaultFormat, t, onClose, Body, Footer, }) {
+    const { locale, format: f } = useLocale();
+    const [scope, setScope] = React.useState(defaultScope ?? (selectedCount > 0 ? "selected" : "filtered"));
+    const [order, setOrder] = React.useState(columns);
+    const [picked, setPicked] = React.useState(() => new Set(columns.filter((c) => c.defaultSelected !== false).map((c) => c.id)));
+    const [masked, setMasked] = React.useState(() => new Set(columns.filter((c) => c.personalData && c.maskByDefault).map((c) => c.id)));
+    const [q, setQ] = React.useState("");
+    const [fmt, setFmt] = React.useState(defaultFormat ?? formats[0] ?? "csv");
+    const [reason, setReason] = React.useState("");
+    const [touched, setTouched] = React.useState(false);
+    const [busy, setBusy] = React.useState(false);
+    const [error, setError] = React.useState(null);
+    const [job, setJob] = React.useState(null);
+    const [announce, setAnnounce] = React.useState("");
+    const downloadRef = React.useRef(null);
+    const csvResolved = {
+        delimiter: csv?.delimiter ?? csvDelimiter(locale),
+        bom: csv?.bom ?? true,
+        decimal: csv?.decimal ?? "locale",
+    };
+    const counts = { selected: selectedCount, filtered: filteredCount, all: totalCount };
+    const rowCount = counts[scope];
+    const filters = activeFilterCount(listState);
+    const chosen = order.filter((c) => picked.has(c.id));
+    const exposed = chosen.filter((c) => c.personalData && !masked.has(c.id));
+    const needsReason = requireReason === true || (requireReason === "personal-data" && exposed.length > 0);
+    const filename = exportFilename(resource, fmt);
+    const nothing = rowCount === 0;
+    const visibleCols = q ? order.filter((c) => foldText(c.label, locale).includes(foldText(q, locale))) : order;
+    const allState = picked.size === 0 ? false : picked.size === columns.length ? true : "indeterminate";
+    // Poll background jobs.
+    React.useEffect(() => {
+        if (!job || !pollJob || job.status === "done" || job.status === "failed")
+            return;
+        let alive = true;
+        const id = setTimeout(async () => {
+            try {
+                const s = await pollJob(job.id);
+                if (!alive)
+                    return;
+                setJob((j) => (j ? { ...j, ...s } : j));
+                if (s.status === "done")
+                    setAnnounce(t("done"));
+                if (s.status === "failed")
+                    setAnnounce(t("failed"));
+            }
+            catch (e) {
+                if (alive)
+                    setJob((j) => (j ? { ...j, status: "failed", error: e instanceof Error ? e.message : String(e) } : j));
+            }
+        }, 1500);
+        return () => {
+            alive = false;
+            clearTimeout(id);
+        };
+    }, [job, pollJob, t]);
+    React.useEffect(() => {
+        if (job?.status === "done")
+            requestAnimationFrame(() => downloadRef.current?.focus());
+    }, [job?.status]);
+    const run = async () => {
+        setTouched(true);
+        if (nothing || chosen.length === 0)
+            return;
+        if (needsReason && !reason.trim())
+            return;
+        setBusy(true);
+        setError(null);
+        try {
+            const res = await onExport({
+                scope,
+                columns: chosen.map((c) => c.id),
+                masked: chosen.filter((c) => masked.has(c.id)).map((c) => c.id),
+                format: fmt,
+                reason: reason.trim() || undefined,
+                csv: csvResolved,
+                filename,
+            });
+            if ("jobId" in res) {
+                setJob({ id: res.jobId, status: "queued", filename });
+                setAnnounce(t("queued"));
+            }
+            else {
+                const name = res.filename ?? filename;
+                downloadBlob(res.blob, name);
+                setAnnounce(t("saved", { filename: name }));
+                onClose();
+            }
+        }
+        catch (e) {
+            setError(e instanceof Error ? e.message : String(e));
+        }
+        finally {
+            setBusy(false);
+        }
+    };
+    const delimiterName = csvResolved.delimiter === ";" ? t("semicolon") : csvResolved.delimiter === "\t" ? t("tab") : t("comma");
+    const decimalName = csvResolved.decimal === "." ? t("pointDecimal") : f.number(1.5).includes(",") ? t("commaDecimal") : t("pointDecimal");
+    const formatItems = formats.map((x) => ({
+        value: x,
+        label: t(x),
+        icon: x === "csv" ? _jsx(FileText, {}) : x === "xlsx" ? _jsx(FileSpreadsheet, {}) : _jsx(Braces, {}),
+        description: x === "csv" ? t("csvHint", { delimiter: delimiterName, decimal: decimalName }) : x === "xlsx" ? t("xlsxHint") : t("jsonHint"),
+    }));
+    if (job) {
+        return (_jsxs(_Fragment, { children: [_jsxs(Body, { children: [_jsx(ExportJobStatus, { job: job, filename: job.filename, labels: {}, t: t, downloadRef: downloadRef, onRetry: () => { setJob(null); void run(); } }), _jsx("span", { className: "sr-only", "aria-live": "polite", children: announce })] }), _jsx(Footer, { children: _jsx(Button, { variant: "secondary", onClick: onClose, children: t("close") }) })] }));
+    }
+    return (_jsxs(_Fragment, { children: [_jsxs(Body, { className: "flex flex-col gap-6", children: [error ? (_jsx(Alert, { tone: "danger", title: t("failed"), live: "assertive", children: error })) : null, _jsxs("fieldset", { className: "m-0 min-w-0 border-0 p-0", "data-slot": "export-scope", children: [_jsx("legend", { className: "mb-2 text-[13px] font-medium text-fg", children: t("scope") }), _jsx(RadioGroup, { value: scope, onValueChange: setScope, variant: "card", orientation: "horizontal", size: "sm", "aria-label": t("scope"), className: "grid gap-2 sm:grid-cols-3", items: [
+                                    {
+                                        value: "selected",
+                                        label: t("scopeSelected"),
+                                        description: selectedCount ? t("rows", { count: selectedCount }) : t("noneSelected"),
+                                        disabled: !selectedCount,
+                                    },
+                                    {
+                                        value: "filtered",
+                                        label: t("scopeFiltered"),
+                                        description: (_jsxs(_Fragment, { children: [filteredCount != null ? t("rows", { count: filteredCount }) : null, listState ? _jsx("span", { className: "block text-fg-subtle", children: listState.q ? t("scopeFilteredHint", { count: filters, q: listState.q }) : t("scopeFilteredHintNoQ", { count: filters }) }) : null] })),
+                                    },
+                                    { value: "all", label: t("scopeAll", { resource }), description: totalCount != null ? t("rows", { count: totalCount }) : undefined },
+                                ] }), rowCount != null && rowCount > syncLimit ? _jsx("p", { className: "mt-2 text-xs text-fg-muted", children: t("background") }) : null] }), _jsxs("fieldset", { className: "m-0 min-w-0 border-0 p-0", "data-slot": "export-columns", children: [_jsxs("div", { className: "mb-2 flex flex-wrap items-center justify-between gap-2", children: [_jsxs("legend", { className: "float-start text-[13px] font-medium text-fg", children: [t("columns"), " ", _jsx("span", { className: "ms-1 font-normal text-fg-subtle tabular", children: t("columnsCount", { selected: picked.size, total: columns.length }) })] }), _jsx(Input, { size: "sm", leading: _jsx(Search, {}), value: q, onChange: (e) => setQ(e.target.value), placeholder: t("searchColumns"), "aria-label": t("searchColumns"), className: "w-full sm:w-52", clearable: true })] }), _jsxs("div", { className: "rounded-ui-lg border border-line", children: [_jsx("div", { className: "flex items-center gap-2 border-b border-line px-3 py-2", children: _jsx(Checkbox, { size: "sm", checked: allState, onCheckedChange: (c) => setPicked(c === true ? new Set(columns.map((x) => x.id)) : new Set()), label: _jsx("span", { className: "text-[13px] font-medium", children: t("selectAll") }) }) }), _jsx(Sortable, { items: order, getLabel: (c) => c.label, onReorder: setOrder, disabled: !!q, children: _jsxs("ul", { className: "m-0 max-h-64 list-none overflow-y-auto p-1", "aria-label": t("columns"), children: [visibleCols.map((c) => (_jsxs(SortableItem, { id: c.id, as: "li", className: "flex min-h-9 items-center gap-1.5 rounded-ui-sm pe-2 hover:bg-hover", children: [q ? _jsx("span", { className: "w-6", "aria-hidden": true }) : _jsx(SortableHandle, { size: "sm" }), _jsx(Checkbox, { size: "sm", className: "min-w-0 flex-1", checked: picked.has(c.id), onCheckedChange: (v) => setPicked((s) => {
+                                                                const n = new Set(s);
+                                                                if (v === true)
+                                                                    n.add(c.id);
+                                                                else
+                                                                    n.delete(c.id);
+                                                                return n;
+                                                            }), label: _jsx("span", { className: "truncate text-[13px]", children: c.label }) }), c.personalData ? (_jsxs(_Fragment, { children: [_jsxs(Badge, { tone: "warning", size: "sm", className: "shrink-0", children: [_jsx(ShieldAlert, {}), " ", t("personal")] }), _jsx(Checkbox, { size: "sm", disabled: !picked.has(c.id), checked: masked.has(c.id), "aria-label": t("maskHint", { label: c.label }), onCheckedChange: (v) => setMasked((s) => {
+                                                                        const n = new Set(s);
+                                                                        if (v === true)
+                                                                            n.add(c.id);
+                                                                        else
+                                                                            n.delete(c.id);
+                                                                        return n;
+                                                                    }), label: _jsx("span", { className: "text-xs text-fg-muted", children: t("mask") }) })] })) : null] }, c.id))), visibleCols.length === 0 ? _jsx("li", { className: "px-3 py-4 text-center text-sm text-fg-subtle", children: t("noColumns", { q }) }) : null] }) })] }), touched && chosen.length === 0 ? _jsx("p", { className: "mt-1.5 text-xs text-danger", children: t("noColumnsSelected") }) : null] }), formats.length > 1 ? (_jsxs("fieldset", { className: "m-0 min-w-0 border-0 p-0", "data-slot": "export-format", children: [_jsx("legend", { className: "mb-2 text-[13px] font-medium text-fg", children: t("format") }), _jsx(RadioGroup, { value: fmt, onValueChange: setFmt, variant: "card", size: "sm", "aria-label": t("format"), className: cn("grid gap-2", formats.length === 3 ? "sm:grid-cols-3" : "sm:grid-cols-2"), items: formatItems })] })) : null, exposed.length ? (_jsx("div", { className: "flex flex-col gap-3", "data-slot": "export-privacy", children: _jsx(Alert, { tone: "warning", title: t("privacyTitle"), children: t("privacyBody", { columns: f.list(exposed.map((c) => c.label)) }) }) })) : null, needsReason ? (_jsx(Field, { label: t("reason"), hint: t("reasonHint"), required: true, error: touched && !reason.trim() ? t("reasonMissing") : undefined, children: _jsx(Textarea, { rows: 2, value: reason, onChange: (e) => setReason(e.target.value), placeholder: t("reasonPlaceholder") }) })) : null, _jsx("span", { className: "sr-only", "aria-live": "polite", children: announce })] }), _jsxs(Footer, { children: [_jsx("span", { className: "me-auto hidden min-w-0 truncate font-mono text-xs text-fg-subtle sm:block", children: filename }), _jsx(Button, { variant: "ghost", onClick: onClose, disabled: busy, children: t("cancel") }), _jsxs(Button, { variant: "primary", onClick: () => void run(), loading: busy, loadingText: t("exporting"), disabled: nothing, title: nothing ? t("nothing") : undefined, children: [_jsx(Download, {}), " ", t("export"), rowCount != null ? _jsxs("span", { className: "font-normal opacity-75 tabular", children: ["\u00B7 ", f.number(rowCount)] }) : null] })] })] }));
+}
+/** Background export progress: queued → running (progress bar) → done (focusable download link) / failed (retry). */
+export function ExportJobStatus({ job, filename, onRetry, labels, className, t: tProp, downloadRef, }) {
+    const own = useLabels("export", exportLabels, labels);
+    const t = tProp ?? own;
+    const title = job.status === "queued" ? t("queued") : job.status === "running" ? t("running") : job.status === "done" ? t("done") : t("failed");
+    return (_jsxs("div", { "data-slot": "export-job-status", "data-status": job.status, className: cn("flex flex-col gap-3 rounded-ui-lg surface-2 p-4", className), children: [_jsxs("div", { className: "flex items-center justify-between gap-3", children: [_jsx("p", { className: "text-sm font-medium text-fg", children: title }), _jsx("span", { className: "font-mono text-xs text-fg-subtle", children: filename })] }), job.status === "queued" || job.status === "running" ? (_jsx(Progress, { value: job.status === "queued" ? null : (job.progress ?? null), "aria-label": title })) : null, job.status === "done" && job.url ? (_jsx(Button, { asChild: true, variant: "primary", className: "self-start", children: _jsxs("a", { ref: downloadRef, href: job.url, download: filename, children: [_jsx(Download, {}), " ", t("download", { filename })] }) })) : null, job.status === "failed" ? (_jsxs("div", { className: "flex flex-wrap items-center gap-3", children: [job.error ? _jsx("p", { className: "text-sm text-danger", children: job.error }) : null, onRetry ? (_jsxs(Button, { size: "sm", variant: "secondary", onClick: onRetry, children: [_jsx(RotateCw, {}), " ", t("retry")] })) : null] })) : null] }));
+}
+/** One click: current view, default columns, default format. */
+export function QuickExportButton({ onExport, labels, children, ...props }) {
+    const t = useLabels("export", exportLabels, labels);
+    const [busy, setBusy] = React.useState(false);
+    return (_jsxs(Button, { ...props, loading: busy, onClick: async () => {
+            setBusy(true);
+            try {
+                const r = await onExport();
+                downloadBlob(r.blob, r.filename);
+            }
+            finally {
+                setBusy(false);
+            }
+        }, children: [_jsx(Download, {}), " ", children ?? t("quick")] }));
+}

package/dist/business/import-core.d.ts

@@ -0,0 +1,104 @@
+export type ImportFieldType = "text" | "number" | "money" | "date" | "boolean" | "enum" | "email" | "phone" | "id" | "iban";
+export interface ImportField {
+    id: string;
+    label: string;
+    /** Other header names that map here ("E-posta", "Mail"). */
+    aliases?: string[];
+    required?: boolean;
+    type: ImportFieldType;
+    options?: {
+        value: string;
+        label: string;
+        aliases?: string[];
+    }[];
+    /** Extra check after type parsing. Return an error message or `null`. */
+    validate?: (value: string, row: Record<string, string>) => string | null;
+    /** Final value written to the import (e.g. phone → E.164 with the locale pack). */
+    normalize?: (value: string) => unknown;
+    /** Example value shown in the mapping step. */
+    example?: string;
+}
+export type CsvEncoding = "utf-8" | "windows-1254" | "windows-1252" | (string & {});
+export interface CsvSniff {
+    encoding: CsvEncoding;
+    delimiter: "," | ";" | "\t";
+    hasBom: boolean;
+}
+export interface ImportSheet {
+    name: string;
+    rows: string[][];
+}
+/**
+ * Guesses encoding and delimiter from the first bytes. Invalid UTF-8 with Turkish code points
+ * → Windows-1254 (Excel on Turkish Windows), else Windows-1252.
+ */
+export declare function sniffCsv(bytes: Uint8Array): CsvSniff;
+/** Bytes → text in an encoding (drops a UTF-8 BOM). */
+export declare function decodeText(bytes: Uint8Array, encoding: CsvEncoding): string;
+/** The delimiter that splits the first lines most consistently. */
+export declare function sniffDelimiter(text: string): "," | ";" | "\t";
+/** True when decoded text has replacement characters or typical mojibake ("ç", "ı"). */
+export declare function looksGarbled(text: string): boolean;
+/** CSV text → rows (lazy `papaparse`). */
+export declare function parseCsv(text: string, delimiter?: string): Promise<string[][]>;
+/** An XLSX file → sheets of string rows (lazy `read-excel-file`). */
+export declare function readXlsx(file: Blob): Promise<ImportSheet[]>;
+/**
+ * Maps file headers to fields: exact folded match on id, label or aliases first, then
+ * containment. Locale folding makes "E-posta" ≈ "eposta" ≈ "EPOSTA". Each field is used once.
+ */
+export declare function autoMap(headers: string[], fields: ImportField[], locale?: string): Record<number, string | null>;
+export interface ParsedCell {
+    value: unknown;
+    error?: string;
+    warning?: string;
+}
+export declare const importCellMessages: {
+    number: string;
+    date: string;
+    boolean: string;
+    enum: string;
+    email: string;
+    phone: string;
+    iban: string;
+    required: string;
+    duplicate: string;
+};
+export type ImportCellMessages = typeof importCellMessages;
+/** "2026-11-10", "10.11.2026", "10/11/2026" (month first for en-US), Excel serials → "YYYY-MM-DD". */
+export declare function parseDateCell(v: string, locale?: string): string | null;
+/** One cell → typed value or a message. Number and date formats follow the file's locale. */
+export declare function parseCell(v: string, field: ImportField, locale?: string, messages?: ImportCellMessages): ParsedCell;
+export interface ImportRowResult {
+    /** 1-based row number in the file (header excluded). */
+    row: number;
+    raw: Record<string, string>;
+    values: Record<string, unknown>;
+    errors: Record<string, string>;
+    warnings: Record<string, string>;
+}
+export interface ValidateImportOptions {
+    locale?: string;
+    /** Field ids that identify a record; repeated combinations are flagged as warnings. */
+    dedupeKeys?: string[];
+    messages?: ImportCellMessages;
+}
+/** Mapped raw rows → typed values, errors and warnings per field. */
+export declare function validateImport(rows: string[][], mapping: Record<number, string | null>, fields: ImportField[], options?: ValidateImportOptions): ImportRowResult[];
+/** Re-validates one row after an inline fix. */
+export declare function validateImportRow(raw: Record<string, string>, row: number, fields: Map<string, ImportField> | ImportField[], o?: {
+    locale?: string;
+    messages?: ImportCellMessages;
+    dedupeKeys?: string[];
+    seen?: Map<string, number>;
+}): ImportRowResult;
+export interface MappingTemplate {
+    id: string;
+    name: string;
+    /** Folded header → field id. */
+    mapping: Record<string, string>;
+}
+/** Applies a saved template to the current headers. */
+export declare function applyTemplate(headers: string[], template: MappingTemplate, locale?: string): Record<number, string | null>;
+/** The current mapping as a template body. */
+export declare function mappingToTemplate(headers: string[], mapping: Record<number, string | null>, locale?: string): Record<string, string>;