@nivaro/react 0.2.15 → 0.2.16

package/dist/index.d.ts

@@ -5041,6 +5041,9 @@ declare interface QuerySheetDef {
     }>;
 }
 
+/** How a stat tile renders its value. Default is currency (the historic shape). */
+declare type QueryStatFormat = 'currency' | 'number' | 'percent' | 'date' | 'text';
+
 export declare function QueryStatStrip({ stats, rows, effectiveParams, loading }: {
     stats: QueryWidgetStat[];
     rows: Array<Record<string, unknown>>;
@@ -5105,6 +5108,11 @@ declare interface QueryTableColumn {
     sparkline_fields?: string[];
     /** Percent-of-total (#249): append this row's share of the column sum. */
     percent_of_total?: boolean;
+    /** What a cell with NO value shows ('—' by default). '' leaves it blank —
+     *  with zero_dash on, a dash then means zero and a blank means no figure. */
+    empty_label?: string;
+    /** Cap a long text column (px); the full text shows on hover. */
+    max_width?: number;
 }
 
 declare interface QueryTableConfig {
@@ -5252,7 +5260,7 @@ declare interface QueryWidgetStat {
     label: string;
     /** Sum this field over the main query's rows. */
     field?: string;
-    format?: 'currency' | 'number';
+    format?: QueryStatFormat;
     /** Hover breakdown: each entry summed over the same rows. */
     details?: Array<{
         label: string;
@@ -5277,12 +5285,22 @@ declare interface QueryWidgetStat {
     /** Delta stat: value = sum(field) − sum(field_subtract); positive values
      *  render with a leading '+'. */
     field_subtract?: string;
+    /** `{{field}}` arithmetic over the summed fields — a weighted ratio of totals
+     *  such as `{{spent}} / {{budget}} * 100`. */
+    formula?: string;
+    /** Shown when the value is null ('—' by default), e.g. 'never imported'. */
+    empty_label?: string;
     /** Stat-card accent: colored top border + value (accent_dark in dark
      *  mode; accent_negative when a delta goes negative). Each may be a role name
      *  — accent | positive | negative | info … — see QueryTable COLOR_ROLES. */
     accent?: string;
     accent_dark?: string;
     accent_negative?: string;
+    /** What one table row is ('projects'). When set and only some rows carry a
+     *  figure for this tile, a quiet "3 of 912 projects" line says how much of
+     *  the table the number covers; when NO row does, the tile shows its
+     *  empty_label instead of a summed zero. */
+    coverage?: string;
 }
 
 /** The full query-widget surface (filters, stats, table, row actions, drill