@nivaro/react 0.1.198 → 0.1.199

package/dist/index.d.ts

@@ -1753,7 +1753,7 @@ declare interface ImportValidationReport {
     truncated: boolean;
 }
 
-export declare function InlineTableField({ relatedCollection, manyField, parentId, parentCollection, layoutId, showRowRevisions, rowComments, allowRevisionRestore, saveMode, showLineNumbers, enableReorder, parentCascades, rowRules, columnPresets, defaultPreset, drawerRelations, parentContextFields, uniqueBy, sortField, sortDir, sectionGroupBy, freezeFirstColumn, rowFilter, rowDefaults, allocateDrawer, autoAllocate, rowBulkActions, uploadTemplate, submissionErrors, prefillParentId, parentFieldKey, readOnly, emptyLabel }: {
+export declare function InlineTableField({ relatedCollection, manyField, parentId, parentCollection, layoutId, showRowRevisions, rowComments, allowRevisionRestore, saveMode, showLineNumbers, enableReorder, parentCascades, rowRules, columnPresets, defaultPreset, drawerRelations, parentContextFields, uniqueBy, sortField, sortDir, sectionGroupBy, freezeFirstColumn, rowFilter, rowDefaults, allocateDrawer, autoAllocate, rowBulkActions, uploadTemplate, rowMatchPanel, submissionErrors, prefillParentId, parentFieldKey, readOnly, emptyLabel }: {
     relatedCollection: string;
     manyField: string;
     parentId: string;
@@ -1802,6 +1802,9 @@ export declare function InlineTableField({ relatedCollection, manyField, parentI
     /** Import template NAME — renders that template's upload button in this
      *  grid's toolbar (existing records; wired to ItemEditForm's reimport flow). */
     uploadTemplate?: string;
+    /** "Which related record is this row matched to, and if not, why" — see
+     *  RowMatchPanel (options.row_match_panel). Rendered in the row editor. */
+    rowMatchPanel?: RowMatchPanelConfig;
     /** Flag rows a failed ERP push rejected (options.submission_errors) — the
      *  latest failed nivaro_erp_submissions row for the PARENT record is parsed
      *  for "LineNumber N: reason" entries and matching rows tint red with the
@@ -3593,6 +3596,57 @@ export declare function rowHighlightClass(color?: string | null): string | undef
 
 export declare function rowHighlightTextClass(color?: string | null): string;
 
+/**
+ * "Which related record is this row matched to, and if none, why not?"
+ *
+ * Config-driven (`options.row_match_panel` on an inline-table field): the
+ * O2M alias on the child that points at the matched records (a workflow
+ * line's `po_line_items`), the columns to show for a match, and — for the
+ * unmatched case — how to find the nearest candidate among a filtered set
+ * (the record's linked purchase orders) and which keys the match rule
+ * compares. `useRowMatches` resolves this ONCE for every saved row of a
+ * grid (two batched reads); the row shows a small dot, the row editor the
+ * full panel with the reason a match fails.
+ */
+declare interface RowMatchPanelConfig {
+    /** O2M alias on the child collection (e.g. workflow_line_items.po_line_items). */
+    relation: string;
+    /** Panel heading. Default "Match". */
+    title?: string;
+    /** Shown per matched record. `path` is a column or dotted M2O path on the
+     *  target; `formula` is `{{col}}` arithmetic over the target row. */
+    columns: Array<{
+        path?: string;
+        formula?: string;
+        label: string;
+        format?: 'currency' | 'number' | 'text';
+    }>;
+    /** How to explain a miss, and which keys a match is judged on. */
+    candidates?: {
+        /** Filter over the target collection; `$parent.<field>` tokens resolve
+         *  from the parent record (M2M aliases give id arrays). Unresolved token
+         *  = the parent has nothing to match against yet. */
+        filter: Record<string, unknown>;
+        /** The match rule: each key pairs a row field with a candidate field. */
+        keys: Array<{
+            row: string;
+            candidate: string;
+            label: string;
+            format?: 'currency' | 'number' | 'text';
+            /** Dotted path on the candidate for a human label (line_type.type). */
+            candidate_display?: string;
+        }>;
+        /** Row field of the key that locates the nearest candidate (default: first key). */
+        primary?: string;
+        /** Label for the candidate's parent ("PO"), used in reasons; `parent_path`
+         *  is the dotted path to its human id (purchase_order.number). */
+        parent_label?: string;
+        parent_path?: string;
+    };
+    no_parent_message?: string;
+    empty_message?: string;
+}
+
 declare interface RowRule {
     trigger_field?: string | null;
     trigger_op?: string;