@nivaro/react 0.1.222 → 0.1.224

package/dist/index.d.ts

@@ -333,6 +333,21 @@ export { CascadeFilterRule }
 declare type CascadeRule = {
     parent_field: string;
     child_field: string;
+    on_unavailable?: CascadeSwapConfig;
+};
+
+/** A parent→child picker cascade. `on_unavailable` opts a rule into the
+ *  swap: when the USER changes the parent this session and a row's current
+ *  value is no longer offered under the new parent, the row is re-pointed to
+ *  the target row that keeps the `keep` columns of the old value and takes
+ *  the `replace` columns from the parent's defaults (same entry shape as
+ *  pinned_options — `when` gates read parent fields only). The swap runs the
+ *  grid's row rules with the child field as the changed field, so every
+ *  downstream derivation (category type, oracle category, task…) follows. */
+declare type CascadeSwapConfig = {
+    keep?: string[];
+    replace: Record<string, PinnedCfg[]>;
+    label?: string;
 };
 
 /** context = the hosting form's current values (parent draft) — lets the
@@ -2655,6 +2670,18 @@ declare interface PendingTask {
     priority?: string;
 }
 
+declare type PinnedCfg = {
+    when?: {
+        field: string;
+        op?: string;
+        value?: string | string[];
+    };
+    parent_field: string;
+    parent_collection: string;
+    source_field: string;
+    tag?: string;
+};
+
 declare interface PinnedMessage {
     pin_id: number;
     id: number;