@modern-admin/react 0.1.0

package/dist/components/wizard-form.d.ts

@@ -0,0 +1,43 @@
+import * as React from 'react';
+import { type Control, type UseFormTrigger } from 'react-hook-form';
+import type { PropertyJSON } from '../types.js';
+export interface WizardStep {
+    /** Short label shown in the step indicator circles */
+    label: string;
+    /** Optional longer description rendered below the step indicator */
+    description?: string;
+    /**
+     * Property paths (from the resource) to show in this step.
+     * If omitted on exactly one step, that step receives all properties not
+     * claimed by the other steps (catch-all).
+     */
+    properties?: string[];
+}
+export interface WizardFormLabels {
+    back?: string;
+    next?: string;
+    submit?: string;
+    cancel?: string;
+    /** Template: 'Step {current} of {total}' — shown only on mobile */
+    stepOf?: string;
+}
+type FormValues = Record<string, unknown>;
+export interface WizardFormProps {
+    steps: WizardStep[];
+    /** All editable properties of the resource. */
+    properties: PropertyJSON[];
+    resourceId: string;
+    control: Control<FormValues>;
+    trigger: UseFormTrigger<FormValues>;
+    onSubmit: () => void;
+    onCancel: () => void;
+    isSubmitting?: boolean;
+    submitError?: string | null;
+    labels?: WizardFormLabels;
+}
+export declare function WizardForm({ steps, properties, resourceId, control, trigger, onSubmit, onCancel, isSubmitting, submitError, labels, }: WizardFormProps): React.ReactElement;
+export declare namespace WizardForm {
+    var displayName: string;
+}
+export {};
+//# sourceMappingURL=wizard-form.d.ts.map

package/dist/components/wizard-form.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wizard-form.d.ts","sourceRoot":"","sources":["../../src/components/wizard-form.tsx"],"names":[],"mappings":"AASA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAY,KAAK,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAa7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAI/C,MAAM,WAAW,UAAU;IACzB,sDAAsD;IACtD,KAAK,EAAE,MAAM,CAAA;IACb,oEAAoE;IACpE,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAEzC,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,UAAU,EAAE,CAAA;IACnB,+CAA+C;IAC/C,UAAU,EAAE,YAAY,EAAE,CAAA;IAC1B,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC,CAAA;IAC5B,OAAO,EAAE,cAAc,CAAC,UAAU,CAAC,CAAA;IACnC,QAAQ,EAAE,MAAM,IAAI,CAAA;IACpB,QAAQ,EAAE,MAAM,IAAI,CAAA;IACpB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,MAAM,CAAC,EAAE,gBAAgB,CAAA;CAC1B;AAID,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,UAAU,EACV,UAAU,EACV,OAAO,EACP,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,YAAoB,EACpB,WAAW,EACX,MAAW,GACZ,EAAE,eAAe,GAAG,KAAK,CAAC,YAAY,CAyMtC;yBApNe,UAAU"}

package/dist/components/wizard-form.jsx

@@ -0,0 +1,136 @@
+// WizardForm — multi-step create form. Each step shows a subset of the
+// resource's editable properties. Clicking "Next" validates only the current
+// step's fields before advancing; "Back" never re-validates. "Create" on the
+// final step triggers the caller-supplied submit handler.
+//
+// The component is i18n-unaware: all visible strings are passed via the
+// `labels` prop with English defaults. The ResourceWizardCreatePage calls
+// t() and wires the results in.
+import * as React from 'react';
+import { useWatch } from 'react-hook-form';
+import { Button, Field, FieldError, FieldLabel, FormField, InfoTooltip, cn, } from '@modern-admin/ui';
+import { Check, ChevronLeft, ChevronRight, Plus, X } from 'lucide-react';
+import { PropertyEditor } from '../property-renderer.js';
+import { evaluateShowWhen } from '../show-when.js';
+// ── WizardForm ────────────────────────────────────────────────────────────────
+export function WizardForm({ steps, properties, resourceId, control, trigger, onSubmit, onCancel, isSubmitting = false, submitError, labels = {}, }) {
+    const backLabel = labels.back ?? 'Back';
+    const nextLabel = labels.next ?? 'Next';
+    const submitLabel = labels.submit ?? 'Create';
+    const cancelLabel = labels.cancel ?? 'Cancel';
+    const stepOfTemplate = labels.stepOf ?? 'Step {current} of {total}';
+    const [currentStep, setCurrentStep] = React.useState(0);
+    // ── Distribute properties across steps ───────────────────────────────────
+    const stepProperties = React.useMemo(() => {
+        const claimedPaths = new Set(steps.flatMap((s) => s.properties ?? []));
+        const unclaimed = properties.filter((p) => !claimedPaths.has(p.path));
+        return steps.map((step) => {
+            if (step.properties) {
+                return step.properties
+                    .map((path) => properties.find((p) => p.path === path))
+                    .filter((p) => p != null);
+            }
+            return unclaimed;
+        });
+    }, [steps, properties]);
+    const totalSteps = steps.length;
+    const isFirst = currentStep === 0;
+    const isLast = currentStep === totalSteps - 1;
+    const handleNext = async () => {
+        const paths = (stepProperties[currentStep] ?? []).map((p) => p.path);
+        // When the step has no properties, advance without validation.
+        const valid = paths.length === 0 ||
+            (await trigger(paths));
+        if (valid)
+            setCurrentStep((s) => Math.min(s + 1, totalSteps - 1));
+    };
+    const currentStepDef = steps[currentStep];
+    const currentProperties = stepProperties[currentStep] ?? [];
+    const stepOfLabel = stepOfTemplate
+        .replace('{current}', String(currentStep + 1))
+        .replace('{total}', String(totalSteps));
+    return (<div>
+      {/* ── Step indicator ──────────────────────────────────────────── */}
+      <div className="px-6 pt-6 pb-5">
+        <div className="flex w-full max-w-xl items-start mx-auto">
+          {steps.map((step, index) => (<React.Fragment key={index}>
+              {/* Step node */}
+              <div className="flex shrink-0 flex-col items-center">
+                <div className={cn('flex h-8 w-8 items-center justify-center rounded-full border-2 text-sm font-semibold transition-colors', index < currentStep &&
+                'border-primary bg-primary text-primary-foreground', index === currentStep &&
+                'border-primary bg-background text-primary', index > currentStep &&
+                'border-border bg-background text-muted-foreground')}>
+                  {index < currentStep ? (<Check className="size-3.5"/>) : (index + 1)}
+                </div>
+                <span className={cn('mt-1.5 hidden max-w-[6rem] text-center text-xs leading-tight sm:block', index === currentStep
+                ? 'font-medium text-foreground'
+                : index < currentStep
+                    ? 'text-primary'
+                    : 'text-muted-foreground')}>
+                  {step.label}
+                </span>
+              </div>
+              {/* Connector line between nodes */}
+              {index < steps.length - 1 && (<div className={cn('mx-2 mt-3.5 h-0.5 flex-1 transition-colors', index < currentStep ? 'bg-primary' : 'bg-border')}/>)}
+            </React.Fragment>))}
+        </div>
+        {/* Mobile: compact "Step N of M · Label" summary */}
+        <p className="mt-2 text-center text-xs text-muted-foreground sm:hidden">
+          {stepOfLabel}
+          {currentStepDef.label ? ` · ${currentStepDef.label}` : ''}
+        </p>
+      </div>
+
+      {/* ── Step description ────────────────────────────────────────── */}
+      {currentStepDef.description && (<p className="px-6 pb-2 text-sm text-muted-foreground">
+          {currentStepDef.description}
+        </p>)}
+
+      {/* ── Fields ──────────────────────────────────────────────────── */}
+      <div className="gap-4 px-6 pb-4 [column-fill:_balance] md:columns-2">
+        {currentProperties.map((property) => (<WizardConditionalField key={property.path} control={control} property={property}>
+            <FormField control={control} name={property.path} render={({ field, fieldState }) => (<Field data-invalid={fieldState.error ? true : undefined} className="mb-8 break-inside-avoid">
+                  <FieldLabel htmlFor={field.name}>
+                    {property.label}
+                    {property.description ? (<InfoTooltip content={property.description} ariaLabel={property.description}/>) : null}
+                    {property.isRequired && (<span className="ml-1 text-destructive">*</span>)}
+                  </FieldLabel>
+                  <PropertyEditor property={property} value={field.value} onChange={field.onChange} disabled={isSubmitting} resourceId={resourceId}/>
+                  {fieldState.error?.message && (<FieldError>{fieldState.error.message}</FieldError>)}
+                </Field>)}/>
+          </WizardConditionalField>))}
+      </div>
+
+      {/* ── Navigation footer ───────────────────────────────────────── */}
+      <div className="flex items-center justify-between border-t border-border px-6 py-4">
+        <div>
+          {submitError && (<span className="text-sm text-destructive">{submitError}</span>)}
+        </div>
+        <div className="flex gap-2">
+          {isFirst ? (<Button type="button" variant="ghost" onClick={onCancel} disabled={isSubmitting}>
+              <X className="size-4"/>
+              {cancelLabel}
+            </Button>) : (<Button type="button" variant="outline" onClick={() => setCurrentStep((s) => s - 1)} disabled={isSubmitting}>
+              <ChevronLeft className="size-4"/>
+              {backLabel}
+            </Button>)}
+          {isLast ? (<Button type="button" onClick={onSubmit} disabled={isSubmitting}>
+              <Plus className="size-4"/>
+              {submitLabel}
+            </Button>) : (<Button type="button" onClick={() => void handleNext()} disabled={isSubmitting}>
+              {nextLabel}
+              <ChevronRight className="size-4"/>
+            </Button>)}
+        </div>
+      </div>
+    </div>);
+}
+WizardForm.displayName = 'WizardForm';
+function WizardConditionalField({ control, property, children, }) {
+    const rule = property.showWhen;
+    const watched = useWatch({ control, name: rule?.field ?? property.path });
+    if (!rule)
+        return <>{children}</>;
+    return evaluateShowWhen(rule, { [rule.field]: watched }) ? <>{children}</> : null;
+}
+//# sourceMappingURL=wizard-form.jsx.map

package/dist/components/wizard-form.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"wizard-form.jsx","sourceRoot":"","sources":["../../src/components/wizard-form.tsx"],"names":[],"mappings":"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"}

package/dist/dashboard/time-series.d.ts

@@ -0,0 +1,20 @@
+import type { TimeSeriesSeries, TimeSeriesStep } from '../client.js';
+/** Generate a continuous sequence of `YYYY-MM-DD` bucket keys spanning [from, to]. */
+export declare function generateBuckets(fromIso: string, toIso: string, step: TimeSeriesStep): string[];
+/**
+ * Zero-fill every series so each one has a value for every bucket in the
+ * resolved date range. Missing buckets become `value: 0` rather than gaps,
+ * which Recharts renders as flat segments instead of breaks.
+ */
+export declare function fillTimeSeries(series: TimeSeriesSeries[], fromIso: string, toIso: string, step: TimeSeriesStep): TimeSeriesSeries[];
+/**
+ * X-axis tick formatter — short label format depending on bucket size.
+ * day/week → DD.MM, month → MM.YYYY, year → YYYY.
+ */
+export declare function makeTickFormatter(step: TimeSeriesStep, locale?: string): (iso: string) => string;
+/**
+ * Tooltip label formatter — long, human-friendly form. For week buckets
+ * we render `Mon DD – Sun DD` (the bucket plus 6 days).
+ */
+export declare function makeLabelFormatter(step: TimeSeriesStep, locale?: string): (iso: string) => string;
+//# sourceMappingURL=time-series.d.ts.map

package/dist/dashboard/time-series.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-series.d.ts","sourceRoot":"","sources":["../../src/dashboard/time-series.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAEV,gBAAgB,EAChB,cAAc,EACf,MAAM,cAAc,CAAA;AAErB,sFAAsF;AACtF,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,cAAc,GACnB,MAAM,EAAE,CAUV;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,gBAAgB,EAAE,EAC1B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,cAAc,GACnB,gBAAgB,EAAE,CAUpB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,cAAc,EACpB,MAAM,SAAU,GACf,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAUzB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,cAAc,EACpB,MAAM,SAAU,GACf,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAoBzB"}

package/dist/dashboard/time-series.js

@@ -0,0 +1,108 @@
+// Time-series UI helpers — bucket fill, tick formatting, label formatting.
+// All zero-fill happens here on the client side (req: "Заполнение нулями
+// должно быть только в ui, вне зависимости от адаптеров"). Adapters return
+// only buckets that have data; the UI fabricates the rest at value 0 so
+// charts don't have visual gaps.
+/** Generate a continuous sequence of `YYYY-MM-DD` bucket keys spanning [from, to]. */
+export function generateBuckets(fromIso, toIso, step) {
+    if (step === 'all')
+        return [fromIso.slice(0, 10)];
+    const out = [];
+    const cur = startOf(new Date(fromIso), step);
+    const end = startOf(new Date(toIso), step);
+    while (cur.getTime() <= end.getTime()) {
+        out.push(ymd(cur));
+        advance(cur, step);
+    }
+    return out;
+}
+/**
+ * Zero-fill every series so each one has a value for every bucket in the
+ * resolved date range. Missing buckets become `value: 0` rather than gaps,
+ * which Recharts renders as flat segments instead of breaks.
+ */
+export function fillTimeSeries(series, fromIso, toIso, step) {
+    const buckets = generateBuckets(fromIso, toIso, step);
+    return series.map((s) => {
+        const map = new Map(s.points.map((p) => [p.date, p.value]));
+        const points = buckets.map((date) => ({
+            date,
+            value: map.get(date) ?? 0,
+        }));
+        return { key: s.key, points };
+    });
+}
+/**
+ * X-axis tick formatter — short label format depending on bucket size.
+ * day/week → DD.MM, month → MM.YYYY, year → YYYY.
+ */
+export function makeTickFormatter(step, locale = 'en-US') {
+    const dayMonth = new Intl.DateTimeFormat(locale, { day: '2-digit', month: '2-digit' });
+    const monthYear = new Intl.DateTimeFormat(locale, { month: '2-digit', year: 'numeric' });
+    const year = new Intl.DateTimeFormat(locale, { year: 'numeric' });
+    return (iso) => {
+        const d = new Date(iso);
+        if (step === 'year')
+            return year.format(d);
+        if (step === 'month')
+            return monthYear.format(d);
+        return dayMonth.format(d);
+    };
+}
+/**
+ * Tooltip label formatter — long, human-friendly form. For week buckets
+ * we render `Mon DD – Sun DD` (the bucket plus 6 days).
+ */
+export function makeLabelFormatter(step, locale = 'en-US') {
+    const fullDay = new Intl.DateTimeFormat(locale, {
+        day: '2-digit',
+        month: 'long',
+        year: 'numeric',
+    });
+    const monthYear = new Intl.DateTimeFormat(locale, { month: 'long', year: 'numeric' });
+    const year = new Intl.DateTimeFormat(locale, { year: 'numeric' });
+    const shortDay = new Intl.DateTimeFormat(locale, { day: '2-digit', month: 'short' });
+    return (iso) => {
+        const d = new Date(iso);
+        if (step === 'year')
+            return year.format(d);
+        if (step === 'month')
+            return monthYear.format(d);
+        if (step === 'week') {
+            const end = new Date(d);
+            end.setDate(end.getDate() + 6);
+            return `${shortDay.format(d)} – ${shortDay.format(end)}`;
+        }
+        return fullDay.format(d);
+    };
+}
+// ─── Internals ────────────────────────────────────────────────────────────
+function ymd(d) {
+    return d.toISOString().slice(0, 10);
+}
+function startOf(d, step) {
+    const out = new Date(Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate()));
+    if (step === 'week') {
+        // Monday-anchored week.
+        const dow = (out.getUTCDay() + 6) % 7;
+        out.setUTCDate(out.getUTCDate() - dow);
+    }
+    else if (step === 'month') {
+        out.setUTCDate(1);
+    }
+    else if (step === 'year') {
+        out.setUTCMonth(0, 1);
+    }
+    return out;
+}
+function advance(d, step) {
+    if (step === 'day')
+        d.setUTCDate(d.getUTCDate() + 1);
+    else if (step === 'week')
+        d.setUTCDate(d.getUTCDate() + 7);
+    else if (step === 'month')
+        d.setUTCMonth(d.getUTCMonth() + 1);
+    else if (step === 'year')
+        d.setUTCFullYear(d.getUTCFullYear() + 1);
+}
+//# sourceMappingURL=time-series.js.map

package/dist/dashboard/time-series.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-series.js","sourceRoot":"","sources":["../../src/dashboard/time-series.ts"],"names":[],"mappings":"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"}

package/dist/dialogs.d.ts

@@ -0,0 +1,35 @@
+import * as React from 'react';
+export interface ConfirmOptions {
+    title?: string;
+    description?: string;
+    confirmLabel?: string;
+    cancelLabel?: string;
+    /** Style the confirm button as destructive (red). Useful for delete dialogs. */
+    destructive?: boolean;
+}
+export interface AlertOptions {
+    title?: string;
+    description?: string;
+    okLabel?: string;
+}
+export interface OpenOptions<T> {
+    render: (api: {
+        close: (value?: T) => void;
+    }) => React.ReactNode;
+    /** Optional max-width override; defaults to `sm:max-w-lg`. */
+    className?: string;
+    /** Disable closing on overlay click + Esc. */
+    modal?: boolean;
+}
+export interface DialogsApi {
+    confirm(opts?: ConfirmOptions): Promise<boolean>;
+    alert(opts?: AlertOptions): Promise<void>;
+    open<T = unknown>(opts: OpenOptions<T>): Promise<T | undefined>;
+}
+export interface DialogsProviderProps {
+    children: React.ReactNode;
+}
+export declare function DialogsProvider({ children }: DialogsProviderProps): React.ReactElement;
+/** Imperative dialog API. Falls back to a no-op when no provider is mounted. */
+export declare function useDialogs(): DialogsApi;
+//# sourceMappingURL=dialogs.d.ts.map

package/dist/dialogs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialogs.d.ts","sourceRoot":"","sources":["../src/dialogs.tsx"],"names":[],"mappings":"AAgBA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAe9B,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,gFAAgF;IAChF,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,MAAM,EAAE,CAAC,GAAG,EAAE;QAAE,KAAK,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,IAAI,CAAA;KAAE,KAAK,KAAK,CAAC,SAAS,CAAA;IAChE,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,8CAA8C;IAC9C,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAChD,KAAK,CAAC,IAAI,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACzC,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAA;CAChE;AA+BD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAC1B;AAED,wBAAgB,eAAe,CAAC,EAAE,QAAQ,EAAE,EAAE,oBAAoB,GAAG,KAAK,CAAC,YAAY,CAuJtF;AAED,gFAAgF;AAChF,wBAAgB,UAAU,IAAI,UAAU,CAiBvC"}

package/dist/dialogs.jsx

@@ -0,0 +1,152 @@
+// Imperative modal dialogs.
+//
+// `<DialogsProvider>` owns a small stack of active dialogs and renders them
+// through shadcn's purpose-built primitives: `<AlertDialog>` for confirm/alert
+// (focus trap + Esc-to-cancel + accessible role), and `<Dialog>` for arbitrary
+// content opened via `open()`. `useDialogs()` exposes a promise-flavoured API
+// (`confirm`, `alert`, `open`) so callers can `await` user choices instead of
+// weaving open/close state through their components. All built-in dialogs go
+// through `useI18n()` for labels — captions stay localized without callers
+// writing translations on the call site.
+//
+// Custom dialogs use `open({ render })`, where `render` receives a `close`
+// callback. The promise resolves with whatever value the caller passes to
+// `close`, defaulting to `undefined` when the user dismisses the dialog
+// (Esc / overlay click).
+import * as React from 'react';
+import { AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogTitle, Dialog, DialogContent, } from '@modern-admin/ui';
+import { useI18n } from './i18n.js';
+const DialogsContext = React.createContext(null);
+let nextId = 1;
+export function DialogsProvider({ children }) {
+    const [entries, setEntries] = React.useState([]);
+    const { t } = useI18n();
+    const removeEntry = React.useCallback((id) => {
+        setEntries((prev) => prev.filter((e) => e.id !== id));
+    }, []);
+    const closeEntry = React.useCallback((id, value) => {
+        setEntries((prev) => {
+            const target = prev.find((e) => e.id === id);
+            if (target)
+                target.resolve(value);
+            // Mark closed so Radix can play the leave animation, then remove.
+            return prev.map((e) => (e.id === id ? { ...e, open: false } : e));
+        });
+        // Cleanup after the close animation ~200ms.
+        window.setTimeout(() => removeEntry(id), 250);
+    }, [removeEntry]);
+    const api = React.useMemo(() => {
+        const push = (build) => new Promise((resolve) => {
+            const id = nextId++;
+            const entry = build(id, resolve);
+            setEntries((prev) => [...prev, entry]);
+        });
+        return {
+            confirm: (opts = {}) => push((id, resolve) => ({
+                kind: 'confirm',
+                id,
+                open: true,
+                opts,
+                resolve: (value) => resolve(value),
+            })).then((v) => v === true),
+            alert: (opts = {}) => push((id, resolve) => ({
+                kind: 'alert',
+                id,
+                open: true,
+                opts,
+                resolve: () => resolve(undefined),
+            })).then(() => undefined),
+            open: (opts) => push((id, resolve) => ({
+                kind: 'custom',
+                id,
+                open: true,
+                className: opts.className,
+                modal: opts.modal,
+                render: ({ close }) => opts.render({ close: (value) => close(value) }),
+                resolve: (value) => resolve(value),
+            })),
+        };
+    }, []);
+    return (<DialogsContext.Provider value={api}>
+      {children}
+      {entries.map((entry) => {
+            if (entry.kind === 'confirm') {
+                const title = entry.opts.title ?? t('common:confirmDelete');
+                const confirmLabel = entry.opts.confirmLabel ?? t(entry.opts.destructive ? 'common:delete' : 'common:save');
+                const cancelLabel = entry.opts.cancelLabel ?? t('common:cancel');
+                return (<AlertDialog key={entry.id} open={entry.open} onOpenChange={(next) => {
+                        if (!next)
+                            closeEntry(entry.id, false);
+                    }}>
+              <AlertDialogContent>
+                <AlertDialogHeader>
+                  <AlertDialogTitle>{title}</AlertDialogTitle>
+                  {entry.opts.description && (<AlertDialogDescription>{entry.opts.description}</AlertDialogDescription>)}
+                </AlertDialogHeader>
+                <AlertDialogFooter>
+                  <AlertDialogCancel onClick={() => closeEntry(entry.id, false)}>
+                    {cancelLabel}
+                  </AlertDialogCancel>
+                  <AlertDialogAction variant={entry.opts.destructive ? 'destructive' : 'default'} onClick={() => closeEntry(entry.id, true)}>
+                    {confirmLabel}
+                  </AlertDialogAction>
+                </AlertDialogFooter>
+              </AlertDialogContent>
+            </AlertDialog>);
+            }
+            if (entry.kind === 'alert') {
+                return (<AlertDialog key={entry.id} open={entry.open} onOpenChange={(next) => {
+                        if (!next)
+                            closeEntry(entry.id, undefined);
+                    }}>
+              <AlertDialogContent>
+                <AlertDialogHeader>
+                  <AlertDialogTitle>{entry.opts.title ?? ''}</AlertDialogTitle>
+                  {entry.opts.description && (<AlertDialogDescription>{entry.opts.description}</AlertDialogDescription>)}
+                </AlertDialogHeader>
+                <AlertDialogFooter>
+                  <AlertDialogAction onClick={() => closeEntry(entry.id, undefined)}>
+                    {entry.opts.okLabel ?? t('common:ok')}
+                  </AlertDialogAction>
+                </AlertDialogFooter>
+              </AlertDialogContent>
+            </AlertDialog>);
+            }
+            // custom
+            return (<Dialog key={entry.id} open={entry.open} onOpenChange={(next) => {
+                    if (!next)
+                        closeEntry(entry.id, undefined);
+                }}>
+            <DialogContent className={entry.className} onInteractOutside={(e) => {
+                    if (entry.modal)
+                        e.preventDefault();
+                }} onEscapeKeyDown={(e) => {
+                    if (entry.modal)
+                        e.preventDefault();
+                }}>
+              {entry.render({ close: (value) => closeEntry(entry.id, value) })}
+            </DialogContent>
+          </Dialog>);
+        })}
+    </DialogsContext.Provider>);
+}
+/** Imperative dialog API. Falls back to a no-op when no provider is mounted. */
+export function useDialogs() {
+    const ctx = React.useContext(DialogsContext);
+    if (ctx)
+        return ctx;
+    // No provider — fall back to native confirm/alert so basic flows still work
+    // when a host app forgets to mount <DialogsProvider>.
+    return {
+        confirm: async (opts) => typeof window === 'undefined'
+            ? false
+            : window.confirm([opts?.title, opts?.description].filter(Boolean).join('\n\n') || ''),
+        alert: async (opts) => {
+            if (typeof window !== 'undefined') {
+                window.alert([opts?.title, opts?.description].filter(Boolean).join('\n\n') || '');
+            }
+        },
+        open: async () => undefined,
+    };
+}
+//# sourceMappingURL=dialogs.jsx.map

package/dist/dialogs.jsx.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialogs.jsx","sourceRoot":"","sources":["../src/dialogs.tsx"],"names":[],"mappings":"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"}

package/dist/export.d.ts

@@ -0,0 +1,39 @@
+import type { AdminClient } from './client.js';
+import type { ListQuery, PropertyJSON, RecordJSON } from './types.js';
+export type ExportFormat = 'csv' | 'json';
+export interface FetchAllOptions {
+    /** Page size used for each list request. */
+    batchSize?: number;
+    /** Optional progress callback: `(loaded, total)`. */
+    onProgress?(loaded: number, total: number): void;
+    /** AbortSignal — drop pagination loop on cancel. */
+    signal?: AbortSignal;
+}
+/**
+ * Page through `client.list()` until exhausted, returning every record that
+ * matches the same filters/sorting as the current list view. `query.page`
+ * and `query.perPage` are overwritten — pass the user's filters/sorting only.
+ */
+export declare function fetchAllRecords(client: AdminClient, resourceId: string, query: ListQuery | undefined, opts?: FetchAllOptions): Promise<RecordJSON[]>;
+/** Escape a single CSV field per RFC 4180 (wrap in quotes when needed). */
+export declare function csvEscape(value: unknown): string;
+export interface SerializeOptions {
+    /** Properties to export in this order. Defaults to union of keys in `records`. */
+    properties?: PropertyJSON[];
+    /** When provided, the active list query is embedded as a comment at the top
+     *  of the exported file so the export is self-documenting:
+     *  – CSV: `# Query: {...}` line before the header row
+     *  – JSON: `// Query: {...}` line before the JSON array  */
+    query?: ListQuery;
+}
+/** Build a CSV document for the given records. UTF-8 BOM for Excel friendliness. */
+export declare function recordsToCsv(records: RecordJSON[], opts?: SerializeOptions): string;
+/** Build a pretty-printed JSON document for the given records.
+ *  When `opts.query` is set, a `// Query: ...` comment is prepended so the
+ *  export is self-documenting (JSONC — understood by VS Code, TypeScript, etc.) */
+export declare function recordsToJson(records: RecordJSON[], opts?: SerializeOptions): string;
+/** Trigger a browser download for the given text payload. */
+export declare function downloadText(filename: string, mime: string, body: string): void;
+/** Build a stable filename like `users-20260506-143015.csv`. */
+export declare function exportFilename(resourceId: string, format: ExportFormat, now?: Date): string;
+//# sourceMappingURL=export.d.ts.map

package/dist/export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../src/export.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAErE,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,MAAM,CAAA;AAEzC,MAAM,WAAW,eAAe;IAC9B,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,qDAAqD;IACrD,UAAU,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IAChD,oDAAoD;IACpD,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,WAAW,EACnB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,SAAS,GAAG,SAAS,EAC5B,IAAI,GAAE,eAAoB,GACzB,OAAO,CAAC,UAAU,EAAE,CAAC,CAgBvB;AAED,2EAA2E;AAC3E,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAYhD;AAED,MAAM,WAAW,gBAAgB;IAC/B,kFAAkF;IAClF,UAAU,CAAC,EAAE,YAAY,EAAE,CAAA;IAC3B;;;gEAG4D;IAC5D,KAAK,CAAC,EAAE,SAAS,CAAA;CAClB;AAED,oFAAoF;AACpF,wBAAgB,YAAY,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,IAAI,GAAE,gBAAqB,GAAG,MAAM,CAYvF;AAED;;mFAEmF;AACnF,wBAAgB,aAAa,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,IAAI,GAAE,gBAAqB,GAAG,MAAM,CAUxF;AAeD,6DAA6D;AAC7D,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAY/E;AAED,gEAAgE;AAChE,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,GAAE,IAAiB,GAAG,MAAM,CAMvG"}