@nivaro/react 0.2.17 → 0.2.18

package/dist/index.d.ts

@@ -5028,6 +5028,16 @@ declare interface QuerySheetDef {
     title?: string;
     width?: number | string;
     config?: QueryWidgetConfig;
+    /** Figures above the tabs from a query of their own (same param tokens as a tab). */
+    header?: {
+        query_slug: string;
+        params?: Record<string, unknown>;
+        stats: QueryWidgetStat[];
+        /** "As of" line under the tiles: label + the latest value of field. */
+        as_of?: SheetHeaderAsOf;
+    };
+    /** Zero-based tab to open first (clamped into range). */
+    initial_tab?: number;
     /** A tab is a nested query view OR a MatrixEditor (`matrix`): its scope is
      *  seeded from the clicked row — `scope: {project: '$row.id'}` — and those
      *  fields render as fixed context, not pickers. */
@@ -5051,7 +5061,7 @@ export declare function QueryStatStrip({ stats, rows, effectiveParams, loading }
     loading: boolean;
 }): JSX.Element | null;
 
-export declare function QueryTable({ rows, config, onRowClick, pivotYear, rowActions, emptyLabel }: {
+export declare function QueryTable({ rows, config, onRowClick, pivotYear, rowActions, emptyLabel, emptyText }: {
     rows: Array<Record<string, unknown>>;
     config?: QueryTableConfig;
     /** Makes rows clickable (hover highlight); receives the (post-grouping) row. */
@@ -5060,6 +5070,8 @@ export declare function QueryTable({ rows, config, onRowClick, pivotYear, rowAct
     pivotYear?: number;
     /** Names the empty state ("No deployments yet") instead of a bare "No data". */
     emptyLabel?: string;
+    /** The whole empty-state sentence, rendered as written (beats emptyLabel). */
+    emptyText?: string;
     /** Trailing action buttons per row (and on the totals row, receiving null). */
     rowActions?: Array<{
         label: string;
@@ -5219,6 +5231,8 @@ declare interface QueryWidgetConfig {
     row_click?: QueryRowClick;
     filters?: QueryWidgetFilter[];
     stats?: QueryWidgetStat[];
+    /** Sentence shown, as written, when the query returns no rows. */
+    empty_label?: string;
     /** Trailing action buttons per row (and totals row) opening nested sheets. */
     row_actions?: Array<{
         label: string;
@@ -6339,6 +6353,20 @@ export declare function setNumberFormat(opts: {
 
 export declare function setTimeDisplay(mode: string | null | undefined): void;
 
+/**
+ * The pure part of opening a query sheet: which tabs it has, which tab opens
+ * first, and the optional header strip (a query of its own, rendered above
+ * the tabs as stat tiles). `resolveConfig` is the caller's token resolver —
+ * '$row.' / '$param.' / '$filters.' — applied to the header exactly as to a
+ * tab, so the two cannot drift.
+ */
+/** A quiet "as of" line under the header tiles: `label` followed by the
+ *  latest `field` value among the header rows (omitted when no row has one). */
+declare interface SheetHeaderAsOf {
+    field: string;
+    label: string;
+}
+
 declare interface SheetItem {
     collection: string;
     item_id: string;