@nivaro/react 0.1.182 → 0.1.183

package/dist/index.d.ts

@@ -341,6 +341,33 @@ declare interface CellFilterLite {
     id_value?: number | null;
 }
 
+/** Shape of the 422 CHANGE_REASON_REQUIRED challenge from the items service. */
+export declare interface ChangeReasonChallenge {
+    fields_changed: string[];
+    reasons: string[];
+    allow_free_text: boolean;
+}
+
+/**
+ * Extract a change-reason challenge from a failed save, or null when the
+ * error is anything else. Works on SDK errors (parsed body on `.response`)
+ * and axios-style errors (`.response.data`).
+ */
+export declare function changeReasonChallenge(err: unknown): ChangeReasonChallenge | null;
+
+/**
+ * Justification prompt shown when a save touches a change-reason-flagged
+ * field. Preset reasons render as a pick list; free text is allowed unless the
+ * collection's config disables it. Submitting retries the save with
+ * `_change_reason` on the payload.
+ */
+export declare function ChangeReasonDialog({ challenge, fieldLabel, onSubmit, onCancel }: {
+    challenge: ChangeReasonChallenge | null;
+    fieldLabel?: (field: string) => string;
+    onSubmit: (reason: string) => void;
+    onCancel: () => void;
+}): JSX.Element | null;
+
 declare interface ChannelMember {
     user: string;
     first_name: string | null;

package/dist/index.js

@@ -72811,6 +72811,7 @@ export {
   zq as BooleanField,
   eF as BroadcastView,
   _g as CellCopyLayer,
+  _m as ChangeReasonDialog,
   US as ChatChannelBrowser,
   IS as ChatChannelSettings,
   xF as ChatPanel,
@@ -72926,6 +72927,7 @@ export {
   sw as canOpenDm,
   lF as canPreviewFile,
   VF as captureErrorClip,
+  xc as changeReasonChallenge,
   rw as chatAvatarColor,
   aw as chatInitials,
   Lu as choiceLabel,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nivaro/react",
-  "version": "0.1.182",
+  "version": "0.1.183",
   "description": "React hooks and components for Nivaro CMS forms",
   "type": "module",
   "main": "./dist/index.js",