@formancy/react 0.12.0 → 0.13.0

package/dist/index.d.mts

@@ -170,6 +170,13 @@ interface FormancyFormProps {
    * step offers "Check your answers" in place of sending (0204). Off unless asked for.
    */
   review?: boolean;
+  /**
+   * The host's own content under a field, by the field's path (a row's field by its own, as its
+   * wrapper's `data-formancy-field-path` says), or nothing: in the field's wrapper, after its
+   * label, description, control and error, as `data-formancy-part="field-addition"` (0233). A
+   * constant: a new function on every render redraws every field's addition.
+   */
+  fieldAddition?: (path: string) => ReactNode;
   onSubmit?: (outcome: SubmitOutcome) => void;
 }
 //#endregion

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/context.tsx","../src/use-field.ts","../src/use-repeater.ts","../src/use-wizard.ts","../src/use-submit.ts","../src/go-to-field.ts","../src/fields/internals.tsx","../src/form.tsx","../src/error-summary.tsx","../src/rich-text.tsx","../src/options-source.ts","../src/scanning.ts","../src/uploads.ts","../src/rich-text-editor.ts","../src/resume-notice.tsx"],"mappings":";;;;;wBAsBgB,mBACd,QACA,OACA;EAEA,QAAQ;;;;;;;EAOR,QAAQ;EACR,WAAW;oBACZ,IAAA;wBAsBe,iBAAiB;;;;;;;;;wBAkBjB,eAAe;;;UCvEd,qBAAqB;EACpC,SAAS,YAAY;EACrB,MAAM;;EAEN,cAAc;;EAEd;IAAc;IAAY;;;EAE1B;IAAc;;;;;;;;;;;;;wBAaA,SAAS,eAAe,OAAO;;;UCrB9B;EACf;;EAEA;;EAEA;;EAEA;EACA;EACA,UAAU;;EAEV,QAAQ,cAAc;;;;;;;wBAQR,YAAY,eAAe,OAAO;;;UCrBjC;EACf;EACA;;;EAGA;EACA;;EAEA,QAAQ;EACR;;EAEA,KAAK;;;;;;;wBAQS,aAAa;;;;;;;;;;;wBCTb;EAAqB;EAAa,QAAQ;;;;;;;;;;;wBCD1C,iBAAiB;;;;;;;;;;;;;;;;UCWhB;EACf;EACA;;KAGU,iBAAiB,cAAc;UAE1B;EACf,SAAS,QAAQ,OAAO,WAAW;EACnC,SAAS,eAAe;;UAGT;EACf;EACA,QAAQ;;EAER;;UAGe;;;;;;;EAOf,SAAS;EACT,WAAW;;;;;;;EAOX;EACA;;;;;EAKA;EACA,YAAY,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;wBCxBP,aAAa,OAAO,oCAAiB,IAAA;;;UClCpC;EACf,SAAS;;;;;;;;;;;wBAYK,eAAe,UAAU,oCAAiB,IAAA;;;;;;;;;;;;;;;;;;;;wBCG1C,WAAW;EAAY;IAAmB;;;;;;;;;;UCZzC;;;;;EAKf;;EAEA;;EAEA;;EAEA;;EAEA;;;;;;;;;EASA;;;;;;;;EAQA;;EAEA,QAAQ;;;;;;;;;;;UAYO;;;;;;;;;;;;;EAaf,QAAQ,SAAS,iBAAiB,QAAQ;;EAE1C;;;;;;EAMA;;EAEA;;;;;;;;;;;;;KAcU,iBAAiB,SAAS,eAAe;qBAIxC,wCAAsB,SAAA,SAAA,eAAA;;;;;;;;;wBAUnB,qBAAqB;;;;;;;;;;;;UC9FpB;;EAEf;;EAEA;;;;;;;;;;;;;;;;;;;KAoBU,WAAW,SAAS,gBAAgB;qBAInC,iCAAe,SAAA;;;;;;;;wBASZ,cAAc;;;;;;;;;;;UC/Bb;;;;;EAKf;;EAEA,QAAQ;;EAER,WAAW,YAAY,cAAc;;;;;;;;;;;;KAa3B,YAAY,MAAM,MAAM,SAAS,kBAAkB,QAAQ;qBAI1D,kCAAgB,SAAA;;;;;;;;;wBAUb,eAAe;;;;;;;;;;;;;;;;;;;;;UChCd;;EAEf;;EAEA,WAAW;;;;;;;;;;;;;EAaX,MAAM,SAAS,aAAa;;EAE5B,WAAW,SAAS;EACpB;;UAGe;;WAEN,SAAS;;WAET;;WAEA,WAAW;WACX;;;;;;;;;;WAUA,YAAY,SAAS;;KAGpB,yBAAyB,OAAO,wBAAwB;qBAIvD,wCAAsB,SAAA;;;;;;;;;wBAUnB,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UC9C3B;WACN;WACA,SAAS;aAAyB;aAAuB;;;UAGnD;;WAEN,YAAY;;WAEZ,SAAS,SAAS;;wBAGb,eAAe,WAAW,UAAU,oBAAoB"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/context.tsx","../src/use-field.ts","../src/use-repeater.ts","../src/use-wizard.ts","../src/use-submit.ts","../src/go-to-field.ts","../src/fields/internals.tsx","../src/form.tsx","../src/error-summary.tsx","../src/rich-text.tsx","../src/options-source.ts","../src/scanning.ts","../src/uploads.ts","../src/rich-text-editor.ts","../src/resume-notice.tsx"],"mappings":";;;;;wBAsBgB,mBACd,QACA,OACA;EAEA,QAAQ;;;;;;;EAOR,QAAQ;EACR,WAAW;oBACZ,IAAA;wBAsBe,iBAAiB;;;;;;;;;wBAkBjB,eAAe;;;UCvEd,qBAAqB;EACpC,SAAS,YAAY;EACrB,MAAM;;EAEN,cAAc;;EAEd;IAAc;IAAY;;;EAE1B;IAAc;;;;;;;;;;;;;wBAaA,SAAS,eAAe,OAAO;;;UCrB9B;EACf;;EAEA;;EAEA;;EAEA;EACA;EACA,UAAU;;EAEV,QAAQ,cAAc;;;;;;;wBAQR,YAAY,eAAe,OAAO;;;UCrBjC;EACf;EACA;;;EAGA;EACA;;EAEA,QAAQ;EACR;;EAEA,KAAK;;;;;;;wBAQS,aAAa;;;;;;;;;;;wBCTb;EAAqB;EAAa,QAAQ;;;;;;;;;;;wBCD1C,iBAAiB;;;;;;;;;;;;;;;;UCYhB;EACf;EACA;;KAGU,iBAAiB,cAAc;UAE1B;EACf,SAAS,QAAQ,OAAO,WAAW;EACnC,SAAS,eAAe;;UAGT;EACf;EACA,QAAQ;;EAER;;UAGe;;;;;;;EAOf,SAAS;EACT,WAAW;;;;;;;EAOX;EACA;;;;;EAKA;;;;;;;EAOA,iBAAiB,iBAAiB;EAClC,YAAY,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;wBC/BP,aAAa,OAAO,oCAAiB,IAAA;;;UCnCpC;EACf,SAAS;;;;;;;;;;;wBAYK,eAAe,UAAU,oCAAiB,IAAA;;;;;;;;;;;;;;;;;;;;wBCG1C,WAAW;EAAY;IAAmB;;;;;;;;;;UCZzC;;;;;EAKf;;EAEA;;EAEA;;EAEA;;EAEA;;;;;;;;;EASA;;;;;;;;EAQA;;EAEA,QAAQ;;;;;;;;;;;UAYO;;;;;;;;;;;;;EAaf,QAAQ,SAAS,iBAAiB,QAAQ;;EAE1C;;;;;;EAMA;;EAEA;;;;;;;;;;;;;KAcU,iBAAiB,SAAS,eAAe;qBAIxC,wCAAsB,SAAA,SAAA,eAAA;;;;;;;;;wBAUnB,qBAAqB;;;;;;;;;;;;UC9FpB;;EAEf;;EAEA;;;;;;;;;;;;;;;;;;;KAoBU,WAAW,SAAS,gBAAgB;qBAInC,iCAAe,SAAA;;;;;;;;wBASZ,cAAc;;;;;;;;;;;UC/Bb;;;;;EAKf;;EAEA,QAAQ;;EAER,WAAW,YAAY,cAAc;;;;;;;;;;;;KAa3B,YAAY,MAAM,MAAM,SAAS,kBAAkB,QAAQ;qBAI1D,kCAAgB,SAAA;;;;;;;;;wBAUb,eAAe;;;;;;;;;;;;;;;;;;;;;UChCd;;EAEf;;EAEA,WAAW;;;;;;;;;;;;;EAaX,MAAM,SAAS,aAAa;;EAE5B,WAAW,SAAS;EACpB;;UAGe;;WAEN,SAAS;;WAET;;WAEA,WAAW;WACX;;;;;;;;;;WAUA,YAAY,SAAS;;KAGpB,yBAAyB,OAAO,wBAAwB;qBAIvD,wCAAsB,SAAA;;;;;;;;;wBAUnB,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UC9C3B;WACN;WACA,SAAS;aAAyB;aAAuB;;;UAGnD;;WAEN,YAAY;;WAEZ,SAAS,SAAS;;wBAGb,eAAe,WAAW,UAAU,oBAAoB"}

package/dist/index.mjs

@@ -493,6 +493,17 @@ function Review({ onChange, children }) {
 	});
 }
 //#endregion
+//#region src/field-addition.tsx
+const FieldAdditionContext = createContext(void 0);
+function FieldAdditionSlot({ path }) {
+	const content = useContext(FieldAdditionContext)?.(path);
+	if (content === void 0 || content === null || typeof content === "boolean") return null;
+	return /* @__PURE__ */ jsx("div", {
+		"data-formancy-part": "field-addition",
+		children: content
+	});
+}
+//#endregion
 //#region src/fields/internals.tsx
 function ErrorText({ field }) {
 	const text = useFormText();
@@ -518,7 +529,8 @@ function FieldShell({ path, field, label, children }) {
 			}),
 			/* @__PURE__ */ jsx(Description, { field }),
 			children,
-			field.touched && field.errors.length > 0 ? /* @__PURE__ */ jsx(ErrorText, { field }) : null
+			field.touched && field.errors.length > 0 ? /* @__PURE__ */ jsx(ErrorText, { field }) : null,
+			/* @__PURE__ */ jsx(FieldAdditionSlot, { path })
 		]
 	});
 }
@@ -1016,7 +1028,8 @@ function RadioGroupField({ path, label }) {
 					})]
 				}, option.value);
 			}),
-			showError ? /* @__PURE__ */ jsx(ErrorText, { field }) : null
+			showError ? /* @__PURE__ */ jsx(ErrorText, { field }) : null,
+			/* @__PURE__ */ jsx(FieldAdditionSlot, { path })
 		]
 	});
 }
@@ -1722,7 +1735,8 @@ function SelectBoxesField({ path, label }) {
 				},
 				children: text("options.retry")
 			}) : null,
-			showError ? /* @__PURE__ */ jsx(ErrorText, { field }) : null
+			showError ? /* @__PURE__ */ jsx(ErrorText, { field }) : null,
+			/* @__PURE__ */ jsx(FieldAdditionSlot, { path })
 		]
 	});
 }
@@ -1834,7 +1848,8 @@ function RankingField({ path, label }) {
 					})
 				}, option.value))
 			}),
-			showError ? /* @__PURE__ */ jsx(ErrorText, { field }) : null
+			showError ? /* @__PURE__ */ jsx(ErrorText, { field }) : null,
+			/* @__PURE__ */ jsx(FieldAdditionSlot, { path })
 		]
 	});
 }
@@ -1898,7 +1913,8 @@ function MatrixField({ path, label }) {
 					})]
 				}, row.value))
 			}),
-			showError ? /* @__PURE__ */ jsx(ErrorText, { field }) : null
+			showError ? /* @__PURE__ */ jsx(ErrorText, { field }) : null,
+			/* @__PURE__ */ jsx(FieldAdditionSlot, { path })
 		]
 	});
 }
@@ -2361,7 +2377,11 @@ const DEFAULT_COMPONENTS = {
 //#endregion
 //#region src/form.tsx
 function FormancyForm(props) {
-	return useFormEngine().wizard() === void 0 ? /* @__PURE__ */ jsx(FlatForm, { ...props }) : /* @__PURE__ */ jsx(PagedForm, { ...props });
+	const engine = useFormEngine();
+	return /* @__PURE__ */ jsx(FieldAdditionContext.Provider, {
+		value: props.fieldAddition,
+		children: engine.wizard() === void 0 ? /* @__PURE__ */ jsx(FlatForm, { ...props }) : /* @__PURE__ */ jsx(PagedForm, { ...props })
+	});
 }
 function FlatForm(props) {
 	const review = useReview();