@nivaro/react 0.1.260 → 0.1.262

package/dist/index.d.ts

@@ -251,14 +251,24 @@ export declare interface ApiRequestLogFilters {
  * same-origin fetch, which is what the admin SPA needs — it is served BY the
  * API in production and proxied to it in dev, and has no provider at its root.
  */
-export declare function ApiUpdateBanner({ appName, fetchVersion }: {
+export declare function ApiUpdateBanner({ appName, fetchVersion, releaseNotesUrl }: {
     appName?: string;
     fetchVersion?: () => Promise<ApiVersionInfo | null>;
+    /**
+     * "What changed" link (#62): given the update notice (served version +
+     * the version this tab loaded against), return the release-notes URL —
+     * the admin passes `/changelog?since=<from>&to=<version>`. Null hides it.
+     * Rendered as a plain anchor on purpose: following it is a full navigation,
+     * which lands the reader on the NEW build's notes.
+     */
+    releaseNotesUrl?: (info: ApiVersionInfo) => string | null;
 }): JSX.Element | null;
 
 export declare interface ApiVersionInfo {
     version: string;
     environment?: string;
+    /** The version this tab loaded against — set on an update notice only. */
+    from?: string | null;
 }
 
 export declare function applyValidationRule(rule: FormValidationRule_2, value: unknown, label: string, record?: Record<string, unknown>): string | null;
@@ -1755,6 +1765,12 @@ declare interface GridSpreadConfig {
     /** Fill only empty/zero targets (default true); false = overwrite all. */
     only_empty?: boolean;
     format?: 'currency' | 'number';
+    /** Shapes offered beside the button (default all: even, front-loaded,
+     *  back-loaded, and "like the previous row" when one exists). */
+    presets?: SpreadPreset[];
+    /** Also offer a grid-level spread over every row's empty targets
+     *  (default true). */
+    across_rows?: boolean;
 }
 
 /**
@@ -1873,6 +1889,40 @@ export declare interface ImportDefinition {
     receipt?: string | null;
 }
 
+declare interface ImportDryRun {
+    created: number;
+    updated: number;
+    unchanged: number;
+    skipped: Record<string, number>;
+    failed: number;
+    log: string;
+    samples?: {
+        creates: Array<{
+            key: string;
+            values: Record<string, unknown>;
+        }>;
+        updates: Array<{
+            key: string;
+            id: unknown;
+            changes: Array<{
+                field: string;
+                from: unknown;
+                to: unknown;
+            }>;
+        }>;
+        skipped_rows: Array<{
+            row: number;
+            key: string | null;
+            reason: string;
+        }>;
+        would_create_lookups: Array<{
+            column: string;
+            collection: string;
+            values: string[];
+        }>;
+    };
+}
+
 export declare function ImportFromFileButton({ collection, templateFilter, getLabel, onParsed, compact }: {
     collection: string;
     templateFilter?: (t: ImportTemplateSummary) => boolean;
@@ -1930,6 +1980,8 @@ export declare interface ImportPreview {
     missing_columns: string[];
     /** Pre-flight report — errors here block queueing server-side too. */
     validation?: ImportValidationReport;
+    /** Service-mode definitions only: what a run would do, nothing written. */
+    dry_run?: ImportDryRun | null;
 }
 
 /** Emitted by the worker on the `import:progress` socket event. */
@@ -2019,13 +2071,6 @@ declare interface ImportValidationReport {
     truncated: boolean;
 }
 
-/**
- * Inbound integrations — every caller that is not a person's browser session,
- * as cards, plus the request log scoped to the picked one. This is the
- * dedicated "external API logs" view: partner file pushes, legacy GraphQL
- * writes, named API keys — who called, how often, what failed, and the exact
- * response body the caller got back.
- */
 export declare function InboundCallersView({ hours: initialHours }: {
     hours?: number;
 }): JSX.Element;
@@ -2120,7 +2165,7 @@ export declare function InlineTableField({ relatedCollection, manyField, parentI
     };
     prefillParentId?: string;
     parentFieldKey?: string;
-}): JSX.Element;
+}): React_2.JSX.Element;
 
 declare interface InputBinding {
     key: string;
@@ -2821,7 +2866,7 @@ export declare function NotificationAnalyticsView({ className }: {
  * click-through routing via the shared notification-target resolver. Needs
  * `<NivaroProvider>`.
  */
-export declare function NotificationBell({ routes, onNavigate, app, subscribe, buttonClassName, panelClassName, beforeList, extraBadge, mailLogUrl, renderTrigger, allPath, onActionError, panelPlacement }: NotificationBellProps): JSX.Element;
+export declare function NotificationBell({ routes, onNavigate, app, subscribe, buttonClassName, panelClassName, beforeList, extraBadge, mailLogUrl, renderTrigger, allPath, subscriptionsPath, onActionError, panelPlacement }: NotificationBellProps): JSX.Element;
 
 export declare interface NotificationBellProps {
     /** Where each notification kind lands in the host app. */
@@ -2857,6 +2902,8 @@ export declare interface NotificationBellProps {
     }) => ReactNode;
     /** Path of the full notifications page — renders a "See all" footer link. */
     allPath?: string | null;
+    /** Path of the subscriptions page — a watch's "Why me?" offers a Manage link. */
+    subscriptionsPath?: string | null;
     /** Called with an error message when an inline action fails. */
     onActionError?: (message: string) => void;
     /** Where the panel opens relative to the trigger. 'below' (default) keeps
@@ -2866,13 +2913,15 @@ export declare interface NotificationBellProps {
     panelPlacement?: 'below' | 'right';
 }
 
-export declare function NotificationCenterView({ routes, onNavigate, app, mailLogUrl, onNotice, onError, className }: NotificationCenterViewProps): JSX.Element;
+export declare function NotificationCenterView({ routes, onNavigate, app, mailLogUrl, subscriptionsPath, onNotice, onError, className }: NotificationCenterViewProps): JSX.Element;
 
 export declare interface NotificationCenterViewProps {
     routes: NotificationRouteMap;
     onNavigate: (path: string) => void;
     app?: 'portal' | 'admin';
     mailLogUrl?: (mailLogId: number) => string | null;
+    /** Host route of the subscriptions page (a watch's "Why me?" links there). */
+    subscriptionsPath?: string | null;
     /** Toast hooks — hosts wire their own toaster. */
     onNotice?: (message: string) => void;
     onError?: (message: string) => void;
@@ -3832,6 +3881,12 @@ export declare interface RealtimeAdapter {
 
 export declare const RealtimeContext: Context<RealtimeAdapter | null>;
 
+export declare function RecentRecordsRail({ limit, title, className }: {
+    limit?: number;
+    title?: string;
+    className?: string;
+}): JSX.Element;
+
 export declare function RecordChatActions({ collection, itemDraft, compact }: {
     collection: string;
     itemDraft: Record<string, unknown>;
@@ -4580,6 +4635,8 @@ export declare type SlotRendererProps = {
 
 export declare function splitMessageTokens(text: string, entityPattern: string): MessageToken[];
 
+declare type SpreadPreset = 'even' | 'front' | 'back' | 'shape';
+
 /**
  * Idempotent; safe from an effect that runs more than once, and safe to call
  * from several components — only the first call arms the timer.