@nivaro/react 0.2.14 → 0.2.16

package/dist/index.d.ts

@@ -1074,6 +1074,17 @@ declare interface CMSRelation {
     one_allowed_collections?: string | null;
 }
 
+declare interface CoalescingOptions {
+    /**
+     * #1304: record reads (`GET /items/<c>` and `GET /items/<c>/<id>`) fired in
+     * the same tick ride ONE `POST /items/batch-read`. Off by default — a host
+     * opts in. A read the batch could not answer with 200 (or a batch that fails
+     * as a whole) is re-sent on its own, so callers see exactly the response or
+     * error they would have seen without batching. Writes never batch.
+     */
+    batchReads?: boolean;
+}
+
 /** @deprecated Column model changed to plain field keys — kept for source
  *  compatibility with early adopters; maps `path` to a field key. */
 export declare interface CollectionBrowserColumn {
@@ -3956,9 +3967,14 @@ declare type NivaroFormProps = {
     style?: default_2.CSSProperties;
 };
 
-export declare function NivaroProvider({ client, children }: {
+export declare function NivaroProvider({ client, children, batchReads }: {
     client: NivaroClient;
     children: React_2.ReactNode;
+    /**
+     * #1304: record reads fired in the same tick share one
+     * `POST /items/batch-read`. Off by default; a host opts in.
+     */
+    batchReads?: boolean;
 }): React_2.JSX.Element;
 
 /**
@@ -4774,7 +4790,7 @@ declare type PipelineBinding = {
     dimensions?: PipelineOwnerDimension[];
 };
 
-export declare type PipelineEditorSection = 'states' | 'transitions' | 'branches' | 'bindings' | 'matrix' | 'simulator' | 'canvas' | 'flow-map' | 'replay' | 'migration' | 'coverage' | 'ai-review' | 'versions';
+export declare type PipelineEditorSection = 'states' | 'transitions' | 'branches' | 'bindings' | 'matrix' | 'simulator' | 'canvas' | 'flow-map' | 'replay' | 'migration' | 'coverage' | 'lint' | 'skip-report' | 'ai-review' | 'versions' | 'matrix-versions';
 
 export declare function PipelineEditorView({ templateId, onBack, onExport, hidden }: {
     templateId: string;
@@ -5025,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>>;
@@ -5089,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 {
@@ -5236,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;
@@ -5261,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
@@ -6385,6 +6419,10 @@ declare type SkipLookupFilter = {
 
 declare type SkipOp = 'eq' | 'neq' | 'lt' | 'lte' | 'gt' | 'gte' | 'in' | 'notin';
 
+export declare function SkipReportCard({ templateId }: {
+    templateId: string;
+}): JSX.Element;
+
 export declare interface SlaRule {
     id: number;
     workflow_template: string;
@@ -6687,6 +6725,10 @@ export declare function TeamScopeEditor({ teamId, scopes, onSaved }: {
  */
 declare type TeamScopeMap = Record<string, Array<string | number>>;
 
+export declare function TeamSuggestionsPanel({ onApplied }: {
+    onApplied: (teamId: number) => void;
+}): JSX.Element;
+
 export declare function TeamsView({ canManage, compact, initialTeamId }: {
     /** Hide mutation controls for non-admin hosts (the server enforces anyway). */
     canManage?: boolean;
@@ -6697,6 +6739,10 @@ export declare function TeamsView({ canManage, compact, initialTeamId }: {
 
 declare type TeamTier = 'suggested' | 'unscoped' | 'out';
 
+export declare function TemplateLintCard({ templateId }: {
+    templateId: string;
+}): JSX.Element;
+
 export declare function TextareaField({ field, value, onChange, error, disabled, readOnly, inputId, errorId }: FieldComponentProps): JSX.Element;
 
 export declare function TextField({ field, value, onChange, error, disabled, readOnly, inputId, errorId }: FieldComponentProps): JSX.Element;
@@ -7525,7 +7571,7 @@ declare interface WidgetSlotProps {
     onContentChange?: (hasContent: boolean) => void;
 }
 
-export declare function withGetCoalescing(client: NivaroClient): NivaroClient;
+export declare function withGetCoalescing(client: NivaroClient, opts?: CoalescingOptions): NivaroClient;
 
 export declare function WorkflowPanel({ collection, item }: {
     collection: string;