@nivaro/react 0.1.198 → 0.1.200

package/dist/index.d.ts

@@ -1226,7 +1226,7 @@ export declare interface FieldInterfaceProps {
     itemId: string | null;
 }
 
-export declare function FieldRenderer({ field, value, onChange, relations, collection, itemId, cascadeFilter, requiredParentLabel, onCountChange, displayOnly, prefillParentId }: {
+export declare function FieldRenderer({ field, value, onChange, relations, collection, itemId, cascadeFilter, requiredParentLabel, narrowedBy, onCountChange, displayOnly, prefillParentId }: {
     field: CMSField;
     value: unknown;
     onChange: (v: unknown) => void;
@@ -1235,6 +1235,12 @@ export declare function FieldRenderer({ field, value, onChange, relations, colle
     itemId: string;
     cascadeFilter?: Record<string, unknown>;
     requiredParentLabel?: string | null;
+    /** Cascade parents currently narrowing an M2O picker (see RelationCombobox). */
+    narrowedBy?: {
+        labels: string[];
+        keys: string[];
+        onClear?: (key: string) => void;
+    };
     onCountChange?: (count: number) => void;
     displayOnly?: boolean;
     prefillParentId?: string;
@@ -1753,7 +1759,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 +1808,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
@@ -3323,13 +3332,21 @@ export declare function RelatedRecordsPanel({ collection, itemId, title, default
     defaultExpanded?: boolean;
 }): JSX.Element;
 
-export declare function RelationCombobox({ collection, value, onChange, disabled, placeholder, extraFilter, autoSelectSingle, optionSort, requiredParent, facets, fieldKey }: {
+export declare function RelationCombobox({ collection, value, onChange, disabled, placeholder, extraFilter, autoSelectSingle, optionSort, requiredParent, facets, fieldKey, narrowedBy }: {
     collection: string;
     value: unknown;
     onChange: (v: unknown) => void;
     disabled?: boolean;
     placeholder?: string;
     extraFilter?: Record<string, unknown>;
+    /** The parent fields whose current values narrow this picker (cascade
+     *  filters). When the narrowed list is EMPTY the panel says which parents
+     *  did it and offers to clear one — instead of a blank "No results". */
+    narrowedBy?: {
+        labels: string[];
+        keys: string[];
+        onClear?: (key: string) => void;
+    };
     /** When the filtered option set has EXACTLY one option and the field is
      *  empty, pick it automatically (options.auto_select_single). Two or more
      *  options — or zero — leave the field blank; an existing value is never
@@ -3593,6 +3610,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;