@nivaro/react 0.1.233 → 0.1.234

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 {
@@ -2404,6 +2407,23 @@ declare interface MatrixEditorConfig {
             label?: string;
             format?: 'currency' | 'number';
         }>;
+        /** 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';
+        }>;
+        /** 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 +2958,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 +3016,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. */
@@ -3166,7 +3198,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 +3469,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. */