@nivaro/react 0.1.233 → 0.1.235

package/dist/index.d.ts

@@ -2317,10 +2317,13 @@ export declare function matchScopeDimension(scopes: UserScopesInfo | null, probe
     collection?: string;
 }): UserScopesInfo['dimensions'][number] | null;
 
-export declare function MatrixEditor({ config, initialScope }: {
+export declare function MatrixEditor({ config, initialScope, lockScope }: {
     config: MatrixEditorConfig;
     /** Pre-seed scope pickers (drill-down hosts scope the matrix to a record). */
     initialScope?: Record<string, unknown>;
+    /** Scope fields supplied by initialScope render as fixed context, not pickers
+     *  (a sheet already scoped to one project). */
+    lockScope?: boolean;
 }): JSX.Element;
 
 declare interface MatrixEditorConfig {
@@ -2335,6 +2338,8 @@ declare interface MatrixEditorConfig {
     option_filter?: Record<string, unknown>;
     key_field: string;
     value_field: string;
+    /** Colour role for the saved-value column (default 'info'). */
+    value_color?: string;
     value_label?: string;
     value_format?: 'currency' | 'number';
     /** Scope pickers. `filter` narrows a picker's options; '$scope.<field>'
@@ -2399,11 +2404,35 @@ declare interface MatrixEditorConfig {
         params?: Record<string, unknown>;
         match_option_field: string;
         match_group_field?: string;
+        /** `color` = a QueryTable colour role (accent | ink | muted | positive |
+         *  negative | warning | info) or hex for the column's figures. */
         columns: Array<{
             field: string;
             label?: string;
             format?: 'currency' | 'number';
+            color?: string;
         }>;
+        /** Computed columns over the row: `{{__current__}}` (saved value),
+         *  `{{__new__}}` (live value incl. the edit) and any metric field —
+         *  e.g. Remaining = `{{__new__}} - {{current_spend}} - {{committed_costs}}`.
+         *  Aggregated levels sum the inputs first, then apply the formula. */
+        derived?: Array<{
+            label: string;
+            formula: string;
+            format?: 'currency' | 'number';
+            /** Colour role; `color_negative` takes over below zero (default
+             *  positive / negative — a Remaining figure). */
+            color?: string;
+            color_negative?: string;
+        }>;
+        /** Metric rows that match no rendered cell still count: shown read-only as
+         *  an "Other …" row per group (options outside the project's list) and an
+         *  "Other …" group (groups outside the project's list), so the totals
+         *  reconcile with the project-level figures. */
+        unmatched?: {
+            option_label?: string;
+            group_label?: string;
+        } | false;
     };
 }
 
@@ -2938,9 +2967,16 @@ declare interface QuerySheetDef {
     title?: string;
     width?: number | string;
     config?: QueryWidgetConfig;
+    /** 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. */
     tabs?: Array<{
         label: string;
-        config: QueryWidgetConfig;
+        config?: QueryWidgetConfig;
+        matrix?: {
+            config: MatrixEditorConfig;
+            scope: Record<string, string>;
+        };
     }>;
 }
 
@@ -2989,9 +3025,14 @@ declare interface QueryTableColumn {
      *  alternating groups get a faint band so wide grids stay scannable. */
     group?: string;
     /** Cell text color (any CSS color) — EFP forecast/actual column tinting.
-     *  color_dark overrides in dark mode (defaults to color). */
+     *  color_dark overrides in dark mode (defaults to color). Either may be a
+     *  role name — accent | ink | muted | positive | negative | warning | info —
+     *  instead of a hex; roles follow the host theme (see COLOR_ROLES). */
     color?: string;
     color_dark?: string;
+    /** Colour (role or hex) used instead of `color` when the cell's value is
+     *  negative — a Remaining Budget column reads green until it goes red. */
+    color_negative?: string;
     /** Second field rendered as a stacked line under the main value in the SAME
      *  cell (EFP month cells: Fcst over Act — halves the column count). Toggles
      *  hide individual lines; the column collapses when both lines hide. */
@@ -3078,6 +3119,11 @@ declare interface QueryTableConfig {
         /** Render a Months/Quarters toggle above the table (EFP quarterly view).
          *  Quarter columns sum their three months — same drill/total math. */
         quarter_toggle?: boolean;
+        /** Colour role/hex for the generated period + year columns, an optional
+         *  below-zero flip, and a separate colour for the Total column. */
+        color?: string;
+        color_negative?: string;
+        total_color?: string;
     };
 }
 
@@ -3166,7 +3212,8 @@ declare interface QueryWidgetStat {
      *  render with a leading '+'. */
     field_subtract?: string;
     /** EFP stat-card accent: colored top border + value (accent_dark in dark
-     *  mode; accent_negative when a delta goes negative). */
+     *  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;
@@ -3436,6 +3483,14 @@ export declare function RecordGridEditor({ config }: {
 declare interface RecordGridEditorConfig {
     collection: string;
     title?: string;
+    /**
+     * BROWSE-THEN-EDIT: the key columns become header pickers. Until every key
+     * is chosen the grid shows read-only totals rolled up by the unpicked keys
+     * (click a rollup to drill into it); once all keys are chosen the matching
+     * row(s) edit inline and a missing row can be created. Month values render
+     * formatted (thousands separators) until focused.
+     */
+    browse?: boolean;
     /** Scope pickers: every field must be chosen before rows load; values filter
      *  loaded rows and seed created rows. `filter` supports '$scope.<field>'
      *  tokens off the other scope values. */