@nivaro/react 0.1.268 → 0.1.270

package/dist/index.d.ts

@@ -421,6 +421,20 @@ declare interface BulkTarget {
     id: string | number;
 }
 
+/**
+ * "Updated 3m ago · Refresh" for a cached figure.
+ *
+ * A cache the viewer cannot see is a number they cannot trust: without this
+ * a report served from Redis is indistinguishable from one just computed.
+ * Renders nothing for an uncached query — there is nothing to disclose.
+ */
+export declare function CacheStamp({ envelope, onRefresh, refreshing, className }: {
+    envelope: CustomQueryEnvelope | undefined;
+    onRefresh?: () => void;
+    refreshing?: boolean;
+    className?: string;
+}): JSX.Element | null;
+
 export declare function canOpenCatalogItem(collection: string | null | undefined): boolean;
 
 export declare function canOpenChatRoom(): boolean;
@@ -1005,6 +1019,21 @@ export declare function CustomActionButtons({ collection, itemId, draft }: {
     draft: Record<string, unknown>;
 }): JSX.Element | null;
 
+/**
+ * The envelope `POST /custom-queries/:slug/execute` returns. Older servers
+ * answer with `data`/`cached` only, so every cache field is optional and the
+ * stamp simply renders nothing when they are absent.
+ */
+declare interface CustomQueryEnvelope {
+    data: Array<Record<string, unknown>>;
+    cached?: boolean;
+    cached_at?: string | null;
+    age_seconds?: number | null;
+    expires_in_seconds?: number | null;
+    cache_ttl?: number | null;
+    executed_at?: string | null;
+}
+
 /** `nivaro_users.preferences.custom_status` — free text + emoji beside the
  *  presence state, self-clearing at `expires_at`. */
 export declare type CustomStatus = {
@@ -4282,6 +4311,14 @@ declare interface ReviewListConfig {
     aggregate_sum?: string | null;
     aggregate_sum_format?: ReviewListColumnFormat | null;
     group_meta?: Array<string | ReviewListColumnSpec>;
+    /** Order groups by a field instead of by key — the most pressing first
+     *  (`{field: 'due_date', direction: 'asc'}` puts the soonest due on top).
+     *  A group sorts on its EARLIEST value, since one late line makes the
+     *  whole invoice late. Groups missing the field keep the key order, last. */
+    group_sort?: {
+        field: string;
+        direction?: 'asc' | 'desc';
+    };
     line_columns?: Array<string | ReviewListColumnSpec>;
     status: {
         field: string;