@formancy/react 0.11.0 → 0.13.0

package/dist/index.d.mts

@@ -27,8 +27,8 @@ export declare function useFormText(): FormText$1;
 //#endregion
 //#region src/use-field.d.ts
 interface FieldBinding extends FieldSnapshot {
-  setValue(value: unknown): void;
-  touch(): void;
+  setValue(this: void, value: unknown): void;
+  touch(this: void): void;
   /** Spread onto the input/select/textarea element. */
   controlProps: ControlProps;
   /** Spread onto the label element. */
@@ -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
@@ -395,7 +402,7 @@ interface UploadOptions {
   /** Aborted when the person cancels this file. Hand it to `fetch` and the transfer stops. */
   signal: AbortSignal;
   /** Bytes sent so far, of how many. `fetch` cannot report an upload's progress; XHR can. */
-  onProgress(sent: number, total: number): void;
+  onProgress(this: void, sent: number, total: number): void;
 }
 /**
  * Uploads one file and reports what was stored.

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;EACT;;EAEA,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;EACA,YAAY,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;wBCdP,aAAa,OAAO,oCAAiB,IAAA;;;UC7CpC;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,cAAc;;;;;;;;;;;;KAaf,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

@@ -337,7 +337,7 @@ function CodeNode({ schema, node, locale }) {
 	const label = resolveText(schema, node.label, locale);
 	const labelId = useId();
 	const value = useField(node.path).value;
-	const text = typeof value === "string" ? value : value === null || value === void 0 ? "" : String(value);
+	const text = typeof value === "string" ? value : typeof value === "number" || typeof value === "boolean" ? String(value) : "";
 	return /* @__PURE__ */ jsxs("div", {
 		"data-formancy-part": "code",
 		"data-state": text === "" ? "empty" : "ready",
@@ -378,11 +378,6 @@ function CodeDrawing({ value }) {
 		children: modules
 	});
 }
-function placedPaths(nodes, into = []) {
-	for (const node of nodes) if (node.kind === "field") into.push(node.path);
-	else placedPaths(layoutChildren(node), into);
-	return into;
-}
 //#endregion
 //#region src/focus-row.ts
 function focusRow(repeater, target, add) {
@@ -427,12 +422,12 @@ function useReview(goTo) {
 	const goToField = useGoToField();
 	return {
 		reviewing,
-		check() {
+		check: () => {
 			if (submit().ok) return setReviewing(true);
 			const firstInvalid = engine.firstInvalid();
 			if (firstInvalid !== null) goTo?.(engine.pageOf(parsePath(firstInvalid)));
 		},
-		change(answer) {
+		change: (answer) => {
 			setReviewing(false);
 			goToField(answer.field);
 		}
@@ -498,48 +493,115 @@ function Review({ onChange, children }) {
 	});
 }
 //#endregion
-//#region src/rich-text.tsx
-function RichText({ source }) {
-	const blocks = parseRichText(source);
-	if (blocks.length === 0) return null;
+//#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": "richtext",
-		children: blocks.map((block, index) => /* @__PURE__ */ jsx(Block, { block }, index))
+		"data-formancy-part": "field-addition",
+		children: content
 	});
 }
-function Block({ block }) {
-	if (block.kind === "paragraph") return /* @__PURE__ */ jsx("p", { children: /* @__PURE__ */ jsx(Inlines, { nodes: block.children }) });
-	const items = block.items.map((item, index) => /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsx(Inlines, { nodes: item }) }, index));
-	return block.ordered ? /* @__PURE__ */ jsx("ol", { children: items }) : /* @__PURE__ */ jsx("ul", { children: items });
+//#endregion
+//#region src/fields/internals.tsx
+function ErrorText({ field }) {
+	const text = useFormText();
+	return /* @__PURE__ */ jsx("p", {
+		"data-formancy-part": "error",
+		...field.errorProps,
+		children: field.errors.map((code, index) => /* @__PURE__ */ jsxs(Fragment, { children: [index > 0 ? " " : null, /* @__PURE__ */ jsx("span", {
+			"data-formancy-code": code,
+			children: errorSentence(text, field.def, code, field.messages)
+		})] }, code))
+	});
 }
-function Inlines({ nodes }) {
-	return /* @__PURE__ */ jsx(Fragment$1, { children: nodes.map((node, index) => /* @__PURE__ */ jsx(Fragment, { children: /* @__PURE__ */ jsx(Inline, { node }) }, index)) });
+function FieldShell({ path, field, label, children }) {
+	return /* @__PURE__ */ jsxs("div", {
+		"data-formancy-part": "field",
+		"data-formancy-field-path": path,
+		"data-state": field.touched && field.errors.length > 0 ? "invalid" : "valid",
+		children: [
+			/* @__PURE__ */ jsx("label", {
+				"data-formancy-part": "label",
+				...field.labelProps,
+				children: label
+			}),
+			/* @__PURE__ */ jsx(Description, { field }),
+			children,
+			field.touched && field.errors.length > 0 ? /* @__PURE__ */ jsx(ErrorText, { field }) : null,
+			/* @__PURE__ */ jsx(FieldAdditionSlot, { path })
+		]
+	});
 }
-function Inline({ node }) {
-	switch (node.kind) {
-		case "text": return /* @__PURE__ */ jsx(Fragment$1, { children: node.text });
-		case "strong": return /* @__PURE__ */ jsx("strong", { children: /* @__PURE__ */ jsx(Inlines, { nodes: node.children }) });
-		case "emphasis": return /* @__PURE__ */ jsx("em", { children: /* @__PURE__ */ jsx(Inlines, { nodes: node.children }) });
-		case "link": return /* @__PURE__ */ jsx("a", {
-			href: node.href,
-			rel: "noreferrer noopener nofollow ugc",
-			children: /* @__PURE__ */ jsx(Inlines, { nodes: node.children })
-		});
-	}
+function statusState({ sourced, said, open, matches }) {
+	if (sourced.remote === null) return open && matches === 0 ? "empty" : void 0;
+	if (sourced.remote.busy) return "busy";
+	if (sourced.remote.failed) return "failed";
+	if (said !== "") return "hint";
+	return open && matches === 0 ? "empty" : void 0;
 }
-//#endregion
-//#region src/rich-text-editor.ts
-const RichTextEditorContext = createContext(void 0);
-const RichTextEditorProvider = RichTextEditorContext.Provider;
-function useRichTextEditorFactory() {
-	return useContext(RichTextEditorContext);
+function RequiredHint({ field }) {
+	const text = useFormText();
+	if (!field.required) return null;
+	return /* @__PURE__ */ jsx("span", {
+		"data-formancy-part": "required-hint",
+		id: field.props.hint.id,
+		children: text("form.required")
+	});
+}
+function Description({ field }) {
+	if (field.description === void 0) return null;
+	return /* @__PURE__ */ jsx("p", {
+		"data-formancy-part": "description",
+		id: field.props.description.id,
+		children: field.description
+	});
+}
+function usePlaceholder(field) {
+	return useFormEngine().text(field.def.placeholder);
+}
+function optionDomId(field, value) {
+	return `${field.ids.control}:option:${value}`;
+}
+function useResolvedOptions(field) {
+	const engine = useFormEngine();
+	return inOptionOrder((field.def.options ?? []).map((option) => ({
+		value: option.value,
+		label: engine.text(option.label) ?? option.value,
+		...option.image !== void 0 && isImageSource(option.image.src) ? { image: {
+			src: option.image.src,
+			alt: engine.text(option.image.alt) ?? ""
+		} } : {}
+	})), field.optionOrder);
+}
+function OptionPicture({ option }) {
+	if (option.image === void 0) return null;
+	return /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx("img", {
+		"data-formancy-part": "option-image",
+		src: option.image.src,
+		alt: option.image.alt,
+		loading: "lazy",
+		decoding: "async"
+	}), " "] });
 }
 //#endregion
-//#region src/scanning.ts
-const ScannerContext = createContext(void 0);
-const ScannerProvider = ScannerContext.Provider;
-function useScanner() {
-	return useContext(ScannerContext);
+//#region src/fields/computed-answer.tsx
+function ComputedAnswerField({ path, label }) {
+	const field = useField(path);
+	const engine = useFormEngine();
+	const text = useFormText();
+	return /* @__PURE__ */ jsx(FieldShell, {
+		path,
+		field,
+		label,
+		children: /* @__PURE__ */ jsx("input", {
+			type: "text",
+			readOnly: true,
+			...field.controlProps,
+			value: answerInWords(engine.schema(), field.def, field.value, text, engine.locale())
+		})
+	});
 }
 //#endregion
 //#region src/options-source.ts
@@ -703,112 +765,6 @@ function storedValues(value) {
 	return value.filter((item) => typeof item === "string" && item !== "");
 }
 //#endregion
-//#region src/uploads.ts
-const UploaderContext = createContext(void 0);
-const UploaderProvider = UploaderContext.Provider;
-function useUploader() {
-	return useContext(UploaderContext);
-}
-//#endregion
-//#region src/fields/internals.tsx
-function ErrorText({ field }) {
-	const text = useFormText();
-	return /* @__PURE__ */ jsx("p", {
-		"data-formancy-part": "error",
-		...field.errorProps,
-		children: field.errors.map((code, index) => /* @__PURE__ */ jsxs(Fragment, { children: [index > 0 ? " " : null, /* @__PURE__ */ jsx("span", {
-			"data-formancy-code": code,
-			children: errorSentence(text, field.def, code, field.messages)
-		})] }, code))
-	});
-}
-function FieldShell({ path, field, label, children }) {
-	return /* @__PURE__ */ jsxs("div", {
-		"data-formancy-part": "field",
-		"data-formancy-field-path": path,
-		"data-state": field.touched && field.errors.length > 0 ? "invalid" : "valid",
-		children: [
-			/* @__PURE__ */ jsx("label", {
-				"data-formancy-part": "label",
-				...field.labelProps,
-				children: label
-			}),
-			/* @__PURE__ */ jsx(Description, { field }),
-			children,
-			field.touched && field.errors.length > 0 ? /* @__PURE__ */ jsx(ErrorText, { field }) : null
-		]
-	});
-}
-function statusState({ sourced, said, open, matches }) {
-	if (sourced.remote === null) return open && matches === 0 ? "empty" : void 0;
-	if (sourced.remote.busy) return "busy";
-	if (sourced.remote.failed) return "failed";
-	if (said !== "") return "hint";
-	return open && matches === 0 ? "empty" : void 0;
-}
-function RequiredHint({ field }) {
-	const text = useFormText();
-	if (!field.required) return null;
-	return /* @__PURE__ */ jsx("span", {
-		"data-formancy-part": "required-hint",
-		id: field.props.hint.id,
-		children: text("form.required")
-	});
-}
-function Description({ field }) {
-	if (field.description === void 0) return null;
-	return /* @__PURE__ */ jsx("p", {
-		"data-formancy-part": "description",
-		id: field.props.description.id,
-		children: field.description
-	});
-}
-function usePlaceholder(field) {
-	return useFormEngine().text(field.def.placeholder);
-}
-function optionDomId(field, value) {
-	return `${field.ids.control}:option:${value}`;
-}
-function useResolvedOptions(field) {
-	const engine = useFormEngine();
-	return inOptionOrder((field.def.options ?? []).map((option) => ({
-		value: option.value,
-		label: engine.text(option.label) ?? option.value,
-		...option.image !== void 0 && isImageSource(option.image.src) ? { image: {
-			src: option.image.src,
-			alt: engine.text(option.image.alt) ?? ""
-		} } : {}
-	})), field.optionOrder);
-}
-function OptionPicture({ option }) {
-	if (option.image === void 0) return null;
-	return /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx("img", {
-		"data-formancy-part": "option-image",
-		src: option.image.src,
-		alt: option.image.alt,
-		loading: "lazy",
-		decoding: "async"
-	}), " "] });
-}
-//#endregion
-//#region src/fields/computed-answer.tsx
-function ComputedAnswerField({ path, label }) {
-	const field = useField(path);
-	const engine = useFormEngine();
-	const text = useFormText();
-	return /* @__PURE__ */ jsx(FieldShell, {
-		path,
-		field,
-		label,
-		children: /* @__PURE__ */ jsx("input", {
-			type: "text",
-			readOnly: true,
-			...field.controlProps,
-			value: answerInWords(engine.schema(), field.def, field.value, text, engine.locale())
-		})
-	});
-}
-//#endregion
 //#region src/fields/typeahead-field.tsx
 function TypeaheadSelectField({ path, label, field }) {
 	const text = useFormText();
@@ -837,6 +793,10 @@ function TypeaheadSelectField({ path, label, field }) {
 	const activeIndex = matches.findIndex((option) => option.value === activeValue);
 	const activeId = expanded && activeIndex !== -1 ? optionDomId(field, matches[activeIndex].value) : void 0;
 	const listboxId = `${field.ids.control}:listbox`;
+	const listbox = useRef(null);
+	useEffect(() => {
+		if (expanded && activeIndex !== -1) listbox.current?.children[activeIndex]?.scrollIntoView?.({ block: "nearest" });
+	}, [expanded, activeIndex]);
 	const choose = (value) => {
 		field.setValue(value);
 		setQuery(null);
@@ -920,6 +880,7 @@ function TypeaheadSelectField({ path, label, field }) {
 				onKeyDown,
 				onBlur
 			}), /* @__PURE__ */ jsx("ul", {
+				ref: listbox,
 				id: listboxId,
 				role: "listbox",
 				"aria-label": text("options.suggestions", { label }),
@@ -1067,11 +1028,19 @@ function RadioGroupField({ path, label }) {
 					})]
 				}, option.value);
 			}),
-			showError ? /* @__PURE__ */ jsx(ErrorText, { field }) : null
+			showError ? /* @__PURE__ */ jsx(ErrorText, { field }) : null,
+			/* @__PURE__ */ jsx(FieldAdditionSlot, { path })
 		]
 	});
 }
 //#endregion
+//#region src/uploads.ts
+const UploaderContext = createContext(void 0);
+const UploaderProvider = UploaderContext.Provider;
+function useUploader() {
+	return useContext(UploaderContext);
+}
+//#endregion
 //#region src/fields/file-field.tsx
 function FileField({ path, label }) {
 	const field = useField(path);
@@ -1315,6 +1284,43 @@ function FileThumbnail({ source }) {
 	});
 }
 //#endregion
+//#region src/rich-text.tsx
+function RichText({ source }) {
+	const blocks = parseRichText(source);
+	if (blocks.length === 0) return null;
+	return /* @__PURE__ */ jsx("div", {
+		"data-formancy-part": "richtext",
+		children: blocks.map((block, index) => /* @__PURE__ */ jsx(Block, { block }, index))
+	});
+}
+function Block({ block }) {
+	if (block.kind === "paragraph") return /* @__PURE__ */ jsx("p", { children: /* @__PURE__ */ jsx(Inlines, { nodes: block.children }) });
+	const items = block.items.map((item, index) => /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsx(Inlines, { nodes: item }) }, index));
+	return block.ordered ? /* @__PURE__ */ jsx("ol", { children: items }) : /* @__PURE__ */ jsx("ul", { children: items });
+}
+function Inlines({ nodes }) {
+	return /* @__PURE__ */ jsx(Fragment$1, { children: nodes.map((node, index) => /* @__PURE__ */ jsx(Fragment, { children: /* @__PURE__ */ jsx(Inline, { node }) }, index)) });
+}
+function Inline({ node }) {
+	switch (node.kind) {
+		case "text": return /* @__PURE__ */ jsx(Fragment$1, { children: node.text });
+		case "strong": return /* @__PURE__ */ jsx("strong", { children: /* @__PURE__ */ jsx(Inlines, { nodes: node.children }) });
+		case "emphasis": return /* @__PURE__ */ jsx("em", { children: /* @__PURE__ */ jsx(Inlines, { nodes: node.children }) });
+		case "link": return /* @__PURE__ */ jsx("a", {
+			href: node.href,
+			rel: "noreferrer noopener nofollow ugc",
+			children: /* @__PURE__ */ jsx(Inlines, { nodes: node.children })
+		});
+	}
+}
+//#endregion
+//#region src/rich-text-editor.ts
+const RichTextEditorContext = createContext(void 0);
+const RichTextEditorProvider = RichTextEditorContext.Provider;
+function useRichTextEditorFactory() {
+	return useContext(RichTextEditorContext);
+}
+//#endregion
 //#region src/fields/rich-text-field.tsx
 function RichTextToolbar({ disabled, label, onCommand }) {
 	const buttons = useRef([]);
@@ -1729,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 })
 		]
 	});
 }
@@ -1841,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 })
 		]
 	});
 }
@@ -1905,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 })
 		]
 	});
 }
@@ -2227,6 +2236,13 @@ function CharacterCount({ field }) {
 	})] });
 }
 //#endregion
+//#region src/scanning.ts
+const ScannerContext = createContext(void 0);
+const ScannerProvider = ScannerContext.Provider;
+function useScanner() {
+	return useContext(ScannerContext);
+}
+//#endregion
 //#region src/fields/text-fields.tsx
 function TextField({ path, label }) {
 	const field = useField(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();
@@ -2431,34 +2451,31 @@ function FieldList({ labels, registry, page, layout }) {
 	const repeaterWires = engine.repeaterPaths();
 	const schema = engine.schema();
 	const arrangement = schema.layouts?.find((candidate) => candidate.name === layout);
-	if (layout !== void 0 && arrangement !== void 0) {
-		new Set(placedPaths(arrangement.nodes));
-		return /* @__PURE__ */ jsx(LayoutTree, {
-			schema,
-			nodes: arrangement.nodes,
-			locale: engine.locale(),
-			shows: page === void 0 ? void 0 : (path) => placedPage(engine, path) === page,
-			renderField: (path) => {
-				if (repeaterWires.includes(path)) return /* @__PURE__ */ jsx(RepeaterSection, {
-					wire: path,
-					labels,
-					registry
-				}, path);
-				const group = placedGroup(engine, path);
-				if (group !== void 0) return /* @__PURE__ */ jsx(GroupSection, {
-					path,
-					group,
-					labels,
-					registry
-				}, path);
-				return /* @__PURE__ */ jsx(FieldSlot, {
-					path,
-					fallbackLabel: labels?.[path],
-					registry
-				}, path);
-			}
-		});
-	}
+	if (layout !== void 0 && arrangement !== void 0) return /* @__PURE__ */ jsx(LayoutTree, {
+		schema,
+		nodes: arrangement.nodes,
+		locale: engine.locale(),
+		shows: page === void 0 ? void 0 : (path) => placedPage(engine, path) === page,
+		renderField: (path) => {
+			if (repeaterWires.includes(path)) return /* @__PURE__ */ jsx(RepeaterSection, {
+				wire: path,
+				labels,
+				registry
+			}, path);
+			const group = placedGroup(engine, path);
+			if (group !== void 0) return /* @__PURE__ */ jsx(GroupSection, {
+				path,
+				group,
+				labels,
+				registry
+			}, path);
+			return /* @__PURE__ */ jsx(FieldSlot, {
+				path,
+				fallbackLabel: labels?.[path],
+				registry
+			}, path);
+		}
+	});
 	const inPage = (wire) => page === void 0 || engine.pageOf(parsePath(wire)) === page;
 	const staticWires = engine.fieldPaths().filter((wire) => !repeaterWires.some((repeater) => wire.startsWith(`${repeater}[`)));
 	return /* @__PURE__ */ jsxs(Fragment$1, { children: [staticWires.filter(inPage).map((wire) => /* @__PURE__ */ jsx(FieldSlot, {