@nivaro/react 0.1.259 → 0.1.261

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;
@@ -894,6 +904,36 @@ export declare function CommentPanel({ collection, item, title, defaultExpanded,
     onQueueComment?: (text: string) => void;
 }): React_2.JSX.Element;
 
+/**
+ * Comparison series for an inline grid (`options.compare_series`).
+ *
+ * A second, read-only line of figures under the grid's own cells — "what
+ * actually happened" beside "what was planned" — fetched from an endpoint the
+ * layout names. The grid stays domain-blind: the endpoint says which row key
+ * and columns it speaks about, which columns are closed (final), the verdict
+ * it wants shown, and what each figure is made of. Any month × key planning
+ * grid whose "what really happened" lives elsewhere fits the contract — the
+ * nouns (what a detail row IS, what the grid's own figures are called) come
+ * from the endpoint too, so this file never names a domain.
+ *
+ * Contract (endpoint response, under `data`):
+ *   label            'Actual' — the series name
+ *   plan_label       'Plan' — what the grid's own figures are called (default 'Plan')
+ *   unit             { one, many } — the noun for a detail row (default entry/entries)
+ *   key_field        the grid column that identifies a row (e.g. 'year')
+ *   columns          the grid columns the series speaks about
+ *   rows[]           { key, values: {column: number}, details?: {column: DetailRow[]} }
+ *   closed_through   'YYYY-MM' | null — month columns at or before it are final
+ *   closed_rule      one sentence explaining how a month closes
+ *   status           { key, label, tone, reason } | null — the verdict + why
+ *   figures[]        { label, value, format } — strip chips beside the grid's own
+ */
+declare interface CompareSeriesConfig {
+    /** `/my-extension/actuals/{{$parent.id}}` — `{{$parent.<field>}}` tokens read the parent draft. */
+    endpoint: string;
+    label?: string;
+}
+
 export declare type ComponentOverrides = {
     text?: default_2.ComponentType<FieldComponentProps>;
     textarea?: default_2.ComponentType<FieldComponentProps>;
@@ -1725,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;
 }
 
 /**
@@ -1843,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;
@@ -1900,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. */
@@ -1989,18 +2071,11 @@ 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;
 
-export declare function InlineTableField({ relatedCollection, manyField, parentId, parentCollection, layoutId, showRowRevisions, rowComments, allowRevisionRestore, saveMode, showLineNumbers, enableReorder, parentCascades, rowRules, columnPresets, defaultPreset, drawerRelations, parentContextFields, uniqueBy, sortField, sortDir, sectionGroupBy, freezeFirstColumn, rowFilter, rowDefaults, allocateDrawer, autoAllocate, rowBulkActions, uploadTemplate, rowMatchPanel, lineSla, rowLints, stats, sumCap, spreadRemaining, submissionErrors, prefillParentId, parentFieldKey, readOnly, emptyLabel, editorMode }: {
+export declare function InlineTableField({ relatedCollection, manyField, parentId, parentCollection, layoutId, showRowRevisions, rowComments, allowRevisionRestore, saveMode, showLineNumbers, enableReorder, parentCascades, rowRules, columnPresets, defaultPreset, drawerRelations, parentContextFields, uniqueBy, sortField, sortDir, sectionGroupBy, freezeFirstColumn, rowFilter, rowDefaults, allocateDrawer, autoAllocate, rowBulkActions, uploadTemplate, rowMatchPanel, lineSla, rowLints, stats, compareSeries, sumCap, spreadRemaining, submissionErrors, prefillParentId, parentFieldKey, readOnly, emptyLabel, editorMode }: {
     relatedCollection: string;
     manyField: string;
     parentId: string;
@@ -2069,6 +2144,11 @@ export declare function InlineTableField({ relatedCollection, manyField, parentI
      *  edits and the row being typed into included) and `{{$count}}`. A
      *  negative result reads red when `negative` is 'danger'. */
     stats?: GridStatConfig[] | null;
+    /** options.compare_series — a second, read-only line of figures under the
+     *  cells ("what actually happened" beside the plan) fetched from an endpoint
+     *  the layout names; closed columns shade, a verdict chip leads the strip,
+     *  each figure opens the rows behind it. See CompareSeries.tsx. */
+    compareSeries?: CompareSeriesConfig | null;
     /** options.sum_cap — refuse to save/stage a row when `field` summed over the
      *  grid (this row's draft included) would exceed `cap` (same tokens as
      *  stats). The client twin of the server's sum_cap validation rule. */
@@ -2085,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;
@@ -2786,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. */
@@ -2822,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
@@ -2831,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;
@@ -3797,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>;
@@ -4545,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.