@formancy/react 0.4.0 → 0.5.0

package/dist/index.mjs

@@ -1,7 +1,8 @@
 import { Fragment, createContext, useCallback, useContext, useEffect, useId, useLayoutEffect, useMemo, useRef, useState, useSyncExternalStore } from "react";
-import { cancelUploads, fieldUploads, formatPath, parsePath, thumbnailSize } from "@formancy/core";
+import { cancelUploads, fieldUploads, formatPath, parsePath, placedGroup, placedPage, thumbnailSize } from "@formancy/core";
+import { createFormText } from "@formancy/core/words";
+import { LAYOUT_LEAF_KINDS, acceptRemoteOptions, answerFromText, applyRichCommand, capRemoteOptions, datagridColumns, editMasked, formatMasked, isImageSource, layoutChildren, layoutNodeShows, maskIsNumeric, maskPlaceholder, narrowOptionsByLabel, parseRichText, resolveText, resolvedLocale } from "@formancy/spec";
 import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
-import { LAYOUT_LEAF_KINDS, acceptRemoteOptions, answerFromText, applyRichCommand, capRemoteOptions, datagridColumns, editMasked, formatMasked, isImageSource, layoutChildren, layoutNodeShows, maskIsNumeric, maskPlaceholder, narrowOptionsByLabel, parseRichText, resolveText } from "@formancy/spec";
 import { flushSync } from "react-dom";
 import { encode } from "uqr";
 //#region src/context.tsx
@@ -12,11 +13,23 @@ import { encode } from "uqr";
 * use prop getters.
 */
 const FormancyContext = createContext(null);
-function FormancyProvider({ engine, children }) {
+/**
+* The form's own words, in the language its questions are read in (0171). Beside the engine
+* rather than on it, because the engine has no buttons — the server runs the same one.
+*/
+const FormancyTextContext = createContext(null);
+function FormancyProvider({ engine, words, children }) {
 	useEffect(() => () => cancelUploads(engine), [engine]);
+	const text = useMemo(() => createFormText({
+		locale: resolvedLocale(engine.schema(), engine.locale()),
+		...words === void 0 ? {} : { words }
+	}), [engine, words]);
 	return /* @__PURE__ */ jsx(FormancyContext.Provider, {
 		value: engine,
-		children
+		children: /* @__PURE__ */ jsx(FormancyTextContext.Provider, {
+			value: text,
+			children
+		})
 	});
 }
 function useFormEngine() {
@@ -24,6 +37,21 @@ function useFormEngine() {
 	if (!engine) throw new Error("formancy hooks need a <FormancyProvider engine={...}> above them in the tree");
 	return engine;
 }
+let english;
+/**
+* The form's words, in the language the reader chose for it.
+*
+* English outside a `FormancyProvider`, which has no engine to take a language from — a
+* resume notice a host draws beside the form rather than inside its provider. Never the
+* browser's language: the form's is the one the reader chose, and the browser's is the
+* one their machine came with.
+*/
+function useFormText() {
+	const text = useContext(FormancyTextContext);
+	if (text !== null) return text;
+	english ??= createFormText({ locale: "" });
+	return english;
+}
 //#endregion
 //#region src/use-field.ts
 /**
@@ -267,6 +295,7 @@ function LayoutNodeView({ schema, node, locale, renderField, at, shows }) {
 */
 function Tabs({ schema, node, locale, renderField, at, here, shows }) {
 	const base = useId();
+	const text = useFormText();
 	const shown = node.children.flatMap((child, index) => shows === void 0 || layoutNodeShows(child, shows) ? [{
 		child,
 		index
@@ -325,7 +354,7 @@ function Tabs({ schema, node, locale, renderField, at, here, shows }) {
 				tabIndex: index === open ? 0 : -1,
 				"data-formancy-part": "tab",
 				onClick: () => setOpen(index),
-				children: names[index] ?? `Tab ${String(index + 1)}`
+				children: names[index] ?? text("tabs.unnamed", { position: index + 1 })
 			}, position))
 		}), shown.map(({ child, index: position }, index) => /* @__PURE__ */ jsx("div", {
 			ref: (element) => {
@@ -520,6 +549,7 @@ const MIN_QUERY = 0;
 const MAX_ROWS = 50;
 function useSourcedOptions(field, query, enabled = true) {
 	const engine = useFormEngine();
+	const text = useFormText();
 	const sources = useOptionsSources();
 	const name = field.def.optionsSource;
 	const source = name === void 0 ? void 0 : sources?.[name];
@@ -645,8 +675,9 @@ function useSourcedOptions(field, query, enabled = true) {
 		remote: {
 			unavailable: source === void 0,
 			busy,
+			failed,
 			needs: minQueryLength,
-			status: statusFor({
+			status: statusFor(text, {
 				failed,
 				busy,
 				needs: minQueryLength,
@@ -663,11 +694,14 @@ function useSourcedOptions(field, query, enabled = true) {
 * feedback, and a region that spoke on every successful keystroke would talk over
 * them. A failure is a sentence somebody can act on rather than a code.
 */
-function statusFor({ failed, busy, needs, query, capped }) {
-	if (failed) return "The options could not be loaded. Type to try again.";
-	if (query.trim().length < needs) return `Type at least ${String(needs)} characters to search.`;
-	if (busy) return "Searching…";
-	if (capped !== null) return `Showing the first ${String(capped.shown)} of ${String(capped.total)} — keep typing to narrow.`;
+function statusFor(text, { failed, busy, needs, query, capped }) {
+	if (failed) return text("options.failed");
+	if (query.trim().length < needs) return text("options.tooShort", { count: needs });
+	if (busy) return text("options.searching");
+	if (capped !== null) return text("options.capped", {
+		shown: capped.shown,
+		total: capped.total
+	});
 	return "";
 }
 //#endregion
@@ -753,7 +787,7 @@ function FieldShell({ path, field, label, children }) {
 function statusState({ sourced, open, matches }) {
 	if (sourced.remote === null) return open && matches === 0 ? "empty" : void 0;
 	if (sourced.remote.busy) return "busy";
-	if (sourced.remote.status.startsWith("The options could not")) return "failed";
+	if (sourced.remote.failed) return "failed";
 	if (sourced.remote.status !== "") return "hint";
 	return open && matches === 0 ? "empty" : void 0;
 }
@@ -769,11 +803,12 @@ function statusState({ sourced, open, matches }) {
 * a red asterisk is a requirement some people cannot perceive.
 */
 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: "required"
+		children: text("form.required")
 	});
 }
 /** One option's element id, in the shape the radio group already uses, so a
@@ -822,6 +857,7 @@ function OptionPicture({ option }) {
 * These were one 2,154-line file — the largest in the repository.
 */
 function TypeaheadSelectField({ path, label, field }) {
+	const text = useFormText();
 	/**
 	* What is in the box while somebody types, or null when the box is simply
 	* showing the answer.
@@ -933,7 +969,7 @@ function TypeaheadSelectField({ path, label, field }) {
 			}), /* @__PURE__ */ jsx("ul", {
 				id: listboxId,
 				role: "listbox",
-				"aria-label": `${label} suggestions`,
+				"aria-label": text("options.suggestions", { label }),
 				"data-formancy-part": "typeahead-listbox",
 				hidden: !expanded,
 				children: matches.map((option) => /* @__PURE__ */ jsx("li", {
@@ -959,7 +995,7 @@ function TypeaheadSelectField({ path, label, field }) {
 				open,
 				matches: matches.length
 			}) },
-			children: sourced.remote !== null && sourced.remote.status !== "" ? sourced.remote.status : open && matches.length === 0 && sourced.remote?.busy !== true ? "No options match" : ""
+			children: sourced.remote !== null && sourced.remote.status !== "" ? sourced.remote.status : open && matches.length === 0 && sourced.remote?.busy !== true ? text("options.noMatch") : ""
 		})]
 	});
 }
@@ -989,6 +1025,7 @@ function CheckboxField({ path, label }) {
 }
 function SelectField({ path, label }) {
 	const field = useField(path);
+	const text = useFormText();
 	const sourced = useSourcedOptions({
 		...field,
 		path
@@ -1000,7 +1037,7 @@ function SelectField({ path, label }) {
 		label,
 		children: /* @__PURE__ */ jsx("p", {
 			"data-formancy-part": "options-unavailable",
-			children: `This field's answers come from "${field.def.optionsSource ?? ""}", which this application has not provided.`
+			children: text("options.unavailable", { source: field.def.optionsSource ?? "" })
 		})
 	});
 	if (field.def.widget === "typeahead") return /* @__PURE__ */ jsx(TypeaheadSelectField, {
@@ -1096,6 +1133,7 @@ function RadioGroupField({ path, label }) {
 */
 function FileField({ path, label }) {
 	const field = useField(path);
+	const text = useFormText();
 	const upload = useUploader();
 	const queue = useUploadQueue(path, upload);
 	const pending = useSyncExternalStore(queue.subscribe, queue.pending, queue.pending);
@@ -1122,7 +1160,7 @@ function FileField({ path, label }) {
 		children: [
 			upload === void 0 ? /* @__PURE__ */ jsx("p", {
 				"data-formancy-part": "file-unavailable",
-				children: "This form cannot accept files here, because no upload destination has been configured."
+				children: text("file.unavailable")
 			}) : /* @__PURE__ */ jsx("div", {
 				"data-formancy-part": "file-dropzone",
 				...over ? { "data-state": "over" } : {},
@@ -1166,16 +1204,24 @@ function FileField({ path, label }) {
 								"data-formancy-part": "file-up",
 								disabled: field.disabled,
 								onClick: () => field.setValue(moved(files, index, index - 1)),
-								children: `Move ${file.name}, ${String(index + 1)} of ${String(files.length)}, up`
+								children: text("file.up", {
+									name: file.name,
+									position: index + 1,
+									count: files.length
+								})
 							}) : null,
 							index < files.length - 1 ? /* @__PURE__ */ jsx("button", {
 								type: "button",
 								"data-formancy-part": "file-down",
 								disabled: field.disabled,
 								onClick: () => field.setValue(moved(files, index, index + 1)),
-								children: `Move ${file.name}, ${String(index + 1)} of ${String(files.length)}, down`
+								children: text("file.down", {
+									name: file.name,
+									position: index + 1,
+									count: files.length
+								})
 							}) : null,
-							/* @__PURE__ */ jsxs("button", {
+							/* @__PURE__ */ jsx("button", {
 								type: "button",
 								disabled: field.disabled,
 								onClick: () => {
@@ -1185,14 +1231,15 @@ function FileField({ path, label }) {
 									}]);
 									field.setValue(files.filter((other) => other.id !== file.id));
 								},
-								children: ["Remove ", file.name]
+								children: text("file.remove", { name: file.name })
 							})
 						]
 					}, file.id)),
 					pending.map((entry) => /* @__PURE__ */ jsx(PendingRow, {
 						entry,
 						queue,
-						disabled: field.disabled
+						disabled: field.disabled,
+						text
 					}, entry.key)),
 					removed.map(({ at, file }) => /* @__PURE__ */ jsxs("li", {
 						"data-formancy-part": "file-item",
@@ -1200,7 +1247,7 @@ function FileField({ path, label }) {
 						children: [/* @__PURE__ */ jsx("span", {
 							"data-formancy-part": "file-name",
 							children: file.name
-						}), /* @__PURE__ */ jsxs("button", {
+						}), /* @__PURE__ */ jsx("button", {
 							type: "button",
 							disabled: field.disabled,
 							onClick: () => {
@@ -1209,7 +1256,7 @@ function FileField({ path, label }) {
 								next.splice(Math.min(at, next.length), 0, file);
 								field.setValue(next);
 							},
-							children: ["Undo removing ", file.name]
+							children: text("file.undo", { name: file.name })
 						})]
 					}, file.id))
 				]
@@ -1217,7 +1264,7 @@ function FileField({ path, label }) {
 			/* @__PURE__ */ jsx("p", {
 				role: "status",
 				"data-formancy-part": "file-status",
-				children: statusOf(pending)
+				children: statusOf(pending, text)
 			})
 		]
 	});
@@ -1229,7 +1276,7 @@ function moved(files, from, to) {
 	return next;
 }
 /** A file not yet in the answer: waiting, being sent, or refused. */
-function PendingRow({ entry, queue, disabled }) {
+function PendingRow({ entry, queue, disabled, text }) {
 	const failed = entry.state === "failed";
 	return /* @__PURE__ */ jsxs("li", {
 		"data-formancy-part": "file-item",
@@ -1241,46 +1288,51 @@ function PendingRow({ entry, queue, disabled }) {
 			}),
 			entry.state === "waiting" ? /* @__PURE__ */ jsx("span", {
 				"data-formancy-part": "file-waiting",
-				children: "Waiting"
+				children: text("file.waiting")
 			}) : null,
 			entry.state === "uploading" ? /* @__PURE__ */ jsx("progress", {
 				"data-formancy-part": "file-progress",
-				"aria-label": `Uploading ${entry.name}`,
+				"aria-label": text("file.uploading", { name: entry.name }),
 				...entry.total === void 0 ? {} : {
 					value: entry.sent,
 					max: entry.total
 				}
 			}) : null,
-			failed ? /* @__PURE__ */ jsxs("span", {
+			failed ? /* @__PURE__ */ jsx("span", {
 				"data-formancy-part": "file-error",
-				children: ["Not attached: ", entry.reason]
+				children: text("file.notAttached", { reason: entry.reason ?? "" })
 			}) : null,
-			failed ? /* @__PURE__ */ jsxs("button", {
+			failed ? /* @__PURE__ */ jsx("button", {
 				type: "button",
 				disabled,
 				onClick: () => queue.retry(entry.key),
-				children: [
-					"Try ",
-					entry.name,
-					" again"
-				]
+				children: text("file.retry", { name: entry.name })
 			}) : null,
 			/* @__PURE__ */ jsx("button", {
 				type: "button",
 				disabled,
 				onClick: () => queue.cancel(entry.key),
-				children: failed ? `Dismiss ${entry.name}` : `Cancel uploading ${entry.name}`
+				children: failed ? text("file.dismiss", { name: entry.name }) : text("file.cancel", { name: entry.name })
 			})
 		]
 	});
 }
 /** What the status region says: the file being sent, or the files refused, by name. */
-function statusOf(pending) {
+function statusOf(pending, text) {
 	const sending = pending.find((entry) => entry.state === "uploading");
-	if (sending !== void 0) return `Uploading ${sending.name}…`;
+	if (sending !== void 0) return text("file.status.uploading", { name: sending.name });
 	const failed = pending.filter((entry) => entry.state === "failed");
-	if (failed.length === 1) return `${failed[0].name} was not attached: ${failed[0].reason ?? ""}`;
-	if (failed.length > 1) return `${String(failed.length)} files were not attached: ${failed.map((entry) => entry.name).join(", ")}.`;
+	if (failed.length === 1) return text("file.status.failed", {
+		name: failed[0].name,
+		reason: failed[0].reason ?? ""
+	});
+	if (failed.length > 1) {
+		const names = failed.map((entry) => entry.name);
+		return text("file.status.failedSeveral", {
+			count: failed.length,
+			names
+		});
+	}
 	return "";
 }
 /**
@@ -1384,30 +1436,26 @@ function FileThumbnail({ source }) {
 function RichTextToolbar({ disabled, label, onCommand }) {
 	const buttons = useRef([]);
 	const [active, setActive] = useState(0);
+	const text = useFormText();
 	const commands = [
 		{
 			command: "strong",
-			name: "Bold",
 			glyph: "B"
 		},
 		{
 			command: "emphasis",
-			name: "Italic",
 			glyph: "I"
 		},
 		{
 			command: "link",
-			name: "Link",
 			glyph: "↗"
 		},
 		{
 			command: "bulletList",
-			name: "Bulleted list",
 			glyph: "•"
 		},
 		{
 			command: "orderedList",
-			name: "Numbered list",
 			glyph: "1."
 		}
 	];
@@ -1418,7 +1466,7 @@ function RichTextToolbar({ disabled, label, onCommand }) {
 	};
 	return /* @__PURE__ */ jsx("div", {
 		role: "toolbar",
-		"aria-label": typeof label === "string" ? `Formatting for ${label}` : "Formatting",
+		"aria-label": text("richtext.toolbar", { label }),
 		"data-formancy-part": "richtext-toolbar",
 		onKeyDown: (event) => {
 			if (event.key === "ArrowRight") {
@@ -1446,7 +1494,7 @@ function RichTextToolbar({ disabled, label, onCommand }) {
 			onFocus: () => setActive(index),
 			onClick: () => {
 				if (entry.command === "link") {
-					const href = window.prompt("Address for the link");
+					const href = window.prompt(text("richtext.linkAddress"));
 					if (href === null || href === "") return;
 					onCommand("link", href);
 					return;
@@ -1458,7 +1506,7 @@ function RichTextToolbar({ disabled, label, onCommand }) {
 				children: entry.glyph
 			}), /* @__PURE__ */ jsx("span", {
 				"data-formancy-part": "visually-hidden",
-				children: entry.name
+				children: text(`richtext.${entry.command}`)
 			})]
 		}, entry.command))
 	});
@@ -1644,6 +1692,7 @@ function SelectBoxesSwitch(props) {
 */
 function TagPickerField({ path, label }) {
 	const field = useField(path);
+	const text = useFormText();
 	const options = useResolvedOptions(field);
 	const chosen = Array.isArray(field.value) ? field.value.map(String) : [];
 	const [query, setQuery] = useState("");
@@ -1670,13 +1719,13 @@ function TagPickerField({ path, label }) {
 			"data-formancy-part": "tagpicker",
 			children: [chosen.length === 0 ? null : /* @__PURE__ */ jsx("ul", {
 				"data-formancy-part": "tagpicker-chips",
-				"aria-label": `${label}: chosen`,
+				"aria-label": text("tagpicker.chosen", { label }),
 				children: chosen.map((value) => /* @__PURE__ */ jsxs("li", {
 					"data-formancy-part": "tagpicker-chip",
 					children: [labelFor(value), /* @__PURE__ */ jsx("button", {
 						type: "button",
 						"data-formancy-part": "tagpicker-remove",
-						"aria-label": `Remove ${labelFor(value)}`,
+						"aria-label": text("tagpicker.remove", { option: labelFor(value) }),
 						onClick: () => remove(value),
 						children: "×"
 					})]
@@ -1717,7 +1766,7 @@ function TagPickerField({ path, label }) {
 				}), /* @__PURE__ */ jsx("ul", {
 					id: listboxId,
 					role: "listbox",
-					"aria-label": `${label} suggestions`,
+					"aria-label": text("options.suggestions", { label }),
 					"data-formancy-part": "tagpicker-listbox",
 					hidden: !expanded,
 					children: matches.map((option) => /* @__PURE__ */ jsx("li", {
@@ -1803,6 +1852,7 @@ function SelectBoxesField({ path, label }) {
 */
 function RankingField({ path, label }) {
 	const field = useField(path);
+	const text = useFormText();
 	const options = useResolvedOptions(field);
 	const showError = field.touched && field.errors.length > 0;
 	const order = Array.isArray(field.value) ? field.value.map(String) : [];
@@ -1849,7 +1899,7 @@ function RankingField({ path, label }) {
 			/* @__PURE__ */ jsx(RequiredHint, { field }),
 			ranked.length === 0 ? null : /* @__PURE__ */ jsx("ol", {
 				"data-formancy-part": "ranking-order",
-				"aria-label": `${label}: your order`,
+				"aria-label": text("ranking.order", { label }),
 				children: ranked.map((option, index) => /* @__PURE__ */ jsxs("li", {
 					"data-formancy-part": "ranking-item",
 					children: [
@@ -1861,7 +1911,7 @@ function RankingField({ path, label }) {
 							type: "button",
 							id: buttonId("up", option.value),
 							"data-formancy-part": "ranking-up",
-							"aria-label": `Move ${option.label} up`,
+							"aria-label": text("ranking.up", { option: option.label }),
 							"aria-disabled": index === 0 ? true : void 0,
 							onClick: () => move(option.value, -1),
 							onBlur: () => field.touch(),
@@ -1871,7 +1921,7 @@ function RankingField({ path, label }) {
 							type: "button",
 							id: buttonId("down", option.value),
 							"data-formancy-part": "ranking-down",
-							"aria-label": `Move ${option.label} down`,
+							"aria-label": text("ranking.down", { option: option.label }),
 							"aria-disabled": index === ranked.length - 1 ? true : void 0,
 							onClick: () => move(option.value, 1),
 							onBlur: () => field.touch(),
@@ -1881,7 +1931,7 @@ function RankingField({ path, label }) {
 							type: "button",
 							id: buttonId("remove", option.value),
 							"data-formancy-part": "ranking-remove",
-							"aria-label": `Take ${option.label} out of the order`,
+							"aria-label": text("ranking.remove", { option: option.label }),
 							onClick: () => reorder(order.filter((value) => value !== option.value), buttonId("rank", option.value)),
 							onBlur: () => field.touch(),
 							children: "×"
@@ -1891,14 +1941,14 @@ function RankingField({ path, label }) {
 			}),
 			unranked.length === 0 ? null : /* @__PURE__ */ jsx("ul", {
 				"data-formancy-part": "ranking-pool",
-				"aria-label": `${label}: not ranked yet`,
+				"aria-label": text("ranking.pool", { label }),
 				children: unranked.map((option) => /* @__PURE__ */ jsx("li", {
 					"data-formancy-part": "ranking-candidate",
 					children: /* @__PURE__ */ jsx("button", {
 						type: "button",
 						id: buttonId("rank", option.value),
 						"data-formancy-part": "ranking-add",
-						"aria-label": `Rank ${option.label}`,
+						"aria-label": text("ranking.rank", { option: option.label }),
 						onClick: () => rank(option.value),
 						onBlur: () => field.touch(),
 						children: option.label
@@ -2166,6 +2216,7 @@ function NumberFallback({ path, label }) {
 */
 function SignatureField({ path, label }) {
 	const field = useField(path);
+	const text = useFormText();
 	const answer = typeof field.value === "object" && field.value !== null ? field.value : {};
 	const drawn = answer.drawn ?? [];
 	const [width, height] = field.def?.box ?? [600, 200];
@@ -2259,7 +2310,7 @@ function SignatureField({ path, label }) {
 					"data-formancy-part": "signature-typed",
 					type: "text",
 					value: answer.typed ?? "",
-					"aria-label": "Type your name",
+					"aria-label": text("signature.typed"),
 					onChange: (event) => {
 						const typed = event.target.value;
 						field.setValue(typed === "" ? null : { typed });
@@ -2274,7 +2325,7 @@ function SignatureField({ path, label }) {
 						before.current = [];
 						field.setValue(null);
 					},
-					children: "Clear"
+					children: text("signature.clear")
 				})
 			]
 		})
@@ -2297,9 +2348,10 @@ function SignatureField({ path, label }) {
 * heading element either: the spec does not say what level it would be, and
 * guessing produces a document outline that skips levels.
 */
-function StaticField({ label }) {
+function StaticField({ path, label }) {
 	return /* @__PURE__ */ jsx("p", {
 		"data-formancy-part": "static",
+		"data-formancy-field-path": path,
 		children: label
 	});
 }
@@ -2429,8 +2481,12 @@ function DateTimeField({ path, label }) {
 function TextField({ path, label }) {
 	const field = useField(path);
 	const scan = useScanner();
+	const words = useFormText();
 	const [scanning, setScanning] = useState(false);
-	/** A device failure, held here rather than in the field's errors. See below. */
+	/**
+	* A device failure, held here rather than in the field's errors. See below. What went
+	* wrong rather than a sentence about it, so the sentence is the form's language's.
+	*/
 	const [trouble, setTrouble] = useState(void 0);
 	/**
 	* The ONE place a text field's answer is written, typed or scanned.
@@ -2455,13 +2511,13 @@ function TextField({ path, label }) {
 			});
 			if (text === null) return;
 			if (typeof text !== "string") {
-				setTrouble("Scanning did not work: the scanner did not return text. Type the value instead.");
+				setTrouble({});
 				return;
 			}
 			commit(mask === void 0 ? text : answerFromText(mask, text));
 			field.touch();
 		} catch (error) {
-			setTrouble(`Scanning did not work: ${error instanceof Error ? error.message : String(error)}. Type the value instead.`);
+			setTrouble({ reason: error instanceof Error ? error.message : String(error) });
 		} finally {
 			setScanning(false);
 		}
@@ -2500,14 +2556,18 @@ function TextField({ path, label }) {
 			onClick: () => {
 				read();
 			},
-			children: ["Scan ", /* @__PURE__ */ jsx("span", {
-				"data-formancy-part": "visually-hidden",
-				children: label
-			})]
+			children: [
+				words("scanner.scan"),
+				" ",
+				/* @__PURE__ */ jsx("span", {
+					"data-formancy-part": "visually-hidden",
+					children: label
+				})
+			]
 		}), /* @__PURE__ */ jsx("p", {
 			role: "status",
 			"data-formancy-part": "scanner-status",
-			children: scanning ? "Scanning…" : trouble ?? ""
+			children: scanning ? words("scanner.scanning") : trouble === void 0 ? "" : trouble.reason === void 0 ? words("scanner.noText") : words("scanner.failed", { reason: trouble.reason })
 		})] }) : null]
 	});
 }
@@ -2553,6 +2613,7 @@ function FormancyForm(props) {
 }
 function SubmitButton({ submitLabel, onSubmit, onFailedNavigate }) {
 	const engine = useFormEngine();
+	const text = useFormText();
 	const submit = useSubmit();
 	return /* @__PURE__ */ jsx("button", {
 		type: "button",
@@ -2572,7 +2633,7 @@ function SubmitButton({ submitLabel, onSubmit, onFailedNavigate }) {
 				errors: outcome.errors
 			});
 		},
-		children: submitLabel ?? "Submit"
+		children: submitLabel ?? text("form.submit")
 	});
 }
 function FlatForm(props) {
@@ -2580,6 +2641,7 @@ function FlatForm(props) {
 }
 function PagedForm(props) {
 	const engine = useFormEngine();
+	const text = useFormText();
 	const wizard = useWizard();
 	const pages = engine.pages().map((page, index) => ({
 		...page,
@@ -2588,7 +2650,7 @@ function PagedForm(props) {
 	return /* @__PURE__ */ jsxs(Fragment$1, { children: [
 		/* @__PURE__ */ jsx("nav", {
 			"data-formancy-part": "stepper",
-			"aria-label": "Progress",
+			"aria-label": text("form.progress"),
 			children: /* @__PURE__ */ jsx("ol", { children: pages.map((page) => /* @__PURE__ */ jsx("li", {
 				"aria-current": page.index === wizard.page ? "step" : void 0,
 				children: engine.text(page.def.label) ?? page.key
@@ -2603,11 +2665,11 @@ function PagedForm(props) {
 			children: [wizard.canGoBack ? /* @__PURE__ */ jsx("button", {
 				type: "button",
 				onClick: () => wizard.back(),
-				children: "Back"
+				children: text("form.back")
 			}) : null, wizard.canGoNext ? /* @__PURE__ */ jsx("button", {
 				type: "button",
 				onClick: () => void wizard.next(),
-				children: "Next"
+				children: text("form.next")
 			}) : /* @__PURE__ */ jsx(SubmitButton, {
 				...props,
 				onFailedNavigate: (page) => wizard.goTo(page)
@@ -2626,13 +2688,20 @@ function FieldList({ labels, registry, page, layout }) {
 			schema,
 			nodes: arrangement.nodes,
 			locale: engine.locale(),
-			shows: page === void 0 ? void 0 : (path) => engine.pageOf(parsePath(path)) === page,
+			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],
@@ -2664,13 +2733,49 @@ function FieldSlot({ path, fallbackLabel, registry }) {
 		label
 	});
 }
+/**
+* A group an arrangement places whole: its fields, under its label, the way a labelled
+* section is drawn — a real group when it has a name, a box when it has none. What it holds
+* and in which order is `@formancy/core`'s, shared with the Angular renderer (0151).
+*/
+function GroupSection({ path, group, labels, registry }) {
+	const engine = useFormEngine();
+	const headingId = useId();
+	const label = resolveText(engine.schema(), group.def.label, engine.locale());
+	return /* @__PURE__ */ jsxs("div", {
+		"data-formancy-part": "group",
+		"data-formancy-field-path": path,
+		...label === void 0 ? {} : {
+			role: "group",
+			"aria-labelledby": headingId
+		},
+		children: [
+			label === void 0 ? null : /* @__PURE__ */ jsx("p", {
+				id: headingId,
+				"data-formancy-part": "group-heading",
+				children: label
+			}),
+			group.fields.map((wire) => /* @__PURE__ */ jsx(FieldSlot, {
+				path: wire,
+				fallbackLabel: labels?.[wire],
+				registry
+			}, wire)),
+			group.repeaters.map((wire) => /* @__PURE__ */ jsx(RepeaterSection, {
+				wire,
+				labels,
+				registry
+			}, wire))
+		]
+	});
+}
 function RepeaterSection({ wire, labels, registry }) {
 	const engine = useFormEngine();
+	const text = useFormText();
 	const repeater = useRepeater(wire);
 	const def = engine.repeaters().find((candidate) => candidate.wire === wire)?.def;
 	const label = engine.text(def?.label) ?? labels?.[wire] ?? wire;
-	const addLabel = def?.addLabel ?? `Add ${label}`;
-	const removeLabel = def?.removeLabel ?? `Remove ${label}`;
+	const addLabel = def?.addLabel ?? text("repeater.add", { label });
+	const removeLabel = def?.removeLabel ?? text("repeater.remove", { label });
 	const fallbackFor = (instanceWire) => {
 		const template = instanceWire.replace(/\[\d+\]/, "[]");
 		return labels?.[template] ?? labels?.[instanceWire];
@@ -2724,7 +2829,11 @@ function RepeaterSection({ wire, labels, registry }) {
 			onClick: () => repeater.removeRow(index),
 			children: /* @__PURE__ */ jsx("span", {
 				"data-formancy-part": "row-action-text",
-				children: `${removeLabel} ${index + 1} of ${repeater.rowCount}`
+				children: text("repeater.removeRow", {
+					remove: removeLabel,
+					position: index + 1,
+					count: repeater.rowCount
+				})
 			})
 		}),
 		index > 0 ? /* @__PURE__ */ jsx("button", {
@@ -2733,7 +2842,11 @@ function RepeaterSection({ wire, labels, registry }) {
 			onClick: () => repeater.moveRow(index, index - 1),
 			children: /* @__PURE__ */ jsx("span", {
 				"data-formancy-part": "row-action-text",
-				children: `Move ${label} ${index + 1} of ${repeater.rowCount} up`
+				children: text("repeater.moveUp", {
+					label,
+					position: index + 1,
+					count: repeater.rowCount
+				})
 			})
 		}) : null,
 		index < repeater.rowCount - 1 ? /* @__PURE__ */ jsx("button", {
@@ -2742,7 +2855,11 @@ function RepeaterSection({ wire, labels, registry }) {
 			onClick: () => repeater.moveRow(index, index + 1),
 			children: /* @__PURE__ */ jsx("span", {
 				"data-formancy-part": "row-action-text",
-				children: `Move ${label} ${index + 1} of ${repeater.rowCount} down`
+				children: text("repeater.moveDown", {
+					label,
+					position: index + 1,
+					count: repeater.rowCount
+				})
 			})
 		}) : null
 	] });
@@ -2777,6 +2894,7 @@ function RepeaterSection({ wire, labels, registry }) {
 	}, rowId));
 	return /* @__PURE__ */ jsxs("fieldset", {
 		"data-formancy-part": "repeater",
+		"data-formancy-field-path": wire,
 		children: [
 			/* @__PURE__ */ jsx("legend", {
 				"data-formancy-part": "repeater-legend",
@@ -2844,6 +2962,7 @@ const DEFAULT_COMPONENTS = {
 */
 function ErrorSummary({ labels }) {
 	const engine = useFormEngine();
+	const text = useFormText();
 	const subscribe = useCallback((onChange) => engine.subscribe(onChange), [engine]);
 	const getErrors = useCallback(() => engine.visibleErrors(), [engine]);
 	const errors = useSyncExternalStore(subscribe, getErrors, getErrors);
@@ -2861,7 +2980,7 @@ function ErrorSummary({ labels }) {
 		ref: region,
 		children: [/* @__PURE__ */ jsx("h2", {
 			"data-formancy-part": "error-summary-heading",
-			children: errors.length === 1 ? "There is 1 problem to fix" : `There are ${errors.length} problems to fix`
+			children: text("errors.heading", { count: errors.length })
 		}), /* @__PURE__ */ jsx("ul", { children: errors.map(({ path, codes }) => {
 			const controlId = engine.getFieldSnapshot(parsePath(path)).ids.control;
 			return /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsx("a", {
@@ -2870,7 +2989,10 @@ function ErrorSummary({ labels }) {
 					event.preventDefault();
 					focusControl(document.getElementById(controlId));
 				},
-				children: `${labelFor(path)}: ${codes.join(", ")}`
+				children: text("errors.entry", {
+					label: labelFor(path),
+					codes: codes.join(", ")
+				})
 			}) }, path);
 		}) })]
 	});
@@ -2879,6 +3001,7 @@ function ErrorSummary({ labels }) {
 //#region src/resume-notice.tsx
 function ResumeNotice({ migration, labels }) {
 	const region = useRef(null);
+	const text = useFormText();
 	useEffect(() => {
 		if (migration !== void 0) region.current?.focus();
 	}, [migration]);
@@ -2886,25 +3009,27 @@ function ResumeNotice({ migration, labels }) {
 	const setAside = migration.changes.map((change) => change.path).filter((path) => path !== void 0);
 	return /* @__PURE__ */ jsxs("div", {
 		role: "region",
-		"aria-label": "This form changed while you were away",
+		"aria-label": text("resume.heading"),
 		"data-formancy-part": "resume-notice",
 		"data-state": migration.severity,
 		tabIndex: -1,
 		ref: region,
 		children: [/* @__PURE__ */ jsx("h2", {
 			"data-formancy-part": "resume-notice-heading",
-			children: "This form changed while you were away"
+			children: text("resume.heading")
 		}), migration.severity === "breaking" ? /* @__PURE__ */ jsxs("p", { children: [
-			"It changed too much for your answers to be moved across, so this is being shown as you left it and ",
-			/* @__PURE__ */ jsx("strong", { children: "cannot be submitted" }),
-			". Starting again will give you the current form."
-		] }) : /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx("p", { children: setAside.length === 1 ? "One question is no longer on this form. Your answer to it is still kept with the rest and will be sent with them — it is just not shown here any more." : `${String(setAside.length)} questions are no longer on this form. Your answers to them are still kept with the rest and will be sent with them — they are just not shown here any more.` }), setAside.length === 0 ? null : /* @__PURE__ */ jsx("ul", {
+			text("resume.breaking.kept"),
+			" ",
+			/* @__PURE__ */ jsx("strong", { children: text("resume.breaking.cannotSubmit") }),
+			" ",
+			text("resume.breaking.restart")
+		] }) : /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx("p", { children: text("resume.setAside", { count: setAside.length }) }), setAside.length === 0 ? null : /* @__PURE__ */ jsx("ul", {
 			"data-formancy-part": "resume-notice-list",
 			children: setAside.map((path) => /* @__PURE__ */ jsx("li", { children: labels?.[path] ?? path }, path))
 		})] })]
 	});
 }
 //#endregion
-export { ErrorSummary, FormancyForm, FormancyProvider, OptionsSourcesProvider, ResumeNotice, RichText, RichTextEditorProvider, ScannerProvider, UploaderProvider, useField, useFormEngine, useOptionsSources, useRepeater, useRichTextEditorFactory, useScanner, useSubmit, useUploader, useWizard };
+export { ErrorSummary, FormancyForm, FormancyProvider, OptionsSourcesProvider, ResumeNotice, RichText, RichTextEditorProvider, ScannerProvider, UploaderProvider, useField, useFormEngine, useFormText, useOptionsSources, useRepeater, useRichTextEditorFactory, useScanner, useSubmit, useUploader, useWizard };
 
 //# sourceMappingURL=index.mjs.map