@formancy/react 0.2.0 → 0.4.0

package/dist/index.mjs

@@ -1,7 +1,7 @@
-import { Fragment, createContext, useCallback, useContext, useEffect, useId, useMemo, useRef, useState, useSyncExternalStore } from "react";
+import { Fragment, createContext, useCallback, useContext, useEffect, useId, useLayoutEffect, useMemo, useRef, useState, useSyncExternalStore } from "react";
+import { cancelUploads, fieldUploads, formatPath, parsePath, thumbnailSize } from "@formancy/core";
 import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
-import { formatPath, parsePath } from "@formancy/core";
-import { LAYOUT_LEAF_KINDS, acceptRemoteOptions, applyRichCommand, capRemoteOptions, datagridColumns, layoutChildren, narrowOptionsByLabel, parseRichText, resolveText } from "@formancy/spec";
+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
@@ -13,6 +13,7 @@ import { encode } from "uqr";
 */
 const FormancyContext = createContext(null);
 function FormancyProvider({ engine, children }) {
+	useEffect(() => () => cancelUploads(engine), [engine]);
 	return /* @__PURE__ */ jsx(FormancyContext.Provider, {
 		value: engine,
 		children
@@ -105,15 +106,17 @@ function useWizard() {
 	const wizard = useFormEngine().wizard();
 	if (wizard === void 0) throw new Error("useWizard needs a schema with pages; this form has none");
 	const subscribe = useCallback((onChange) => wizard.subscribe(onChange), [wizard]);
-	const getPage = useCallback(() => wizard.page(), [wizard]);
-	const page = useSyncExternalStore(subscribe, getPage, getPage);
+	const getRevision = useCallback(() => wizard.revision(), [wizard]);
+	const revision = useSyncExternalStore(subscribe, getRevision, getRevision);
 	return useMemo(() => ({
-		page,
+		page: wizard.page(),
 		pageCount: wizard.pageCount,
+		canGoNext: wizard.canGoNext(),
+		canGoBack: wizard.canGoBack(),
 		next: () => wizard.next(),
 		back: () => wizard.back(),
 		goTo: (pageIndex) => wizard.goTo(pageIndex)
-	}), [page, wizard]);
+	}), [revision, wizard]);
 }
 //#endregion
 //#region src/focus-control.ts
@@ -122,6 +125,7 @@ function focusControl(control) {
 	if (control === null) return;
 	control.dispatchEvent(new Event("formancy-reveal", { bubbles: true }));
 	control.focus();
+	if (document.activeElement !== control) control.querySelector("input, select, textarea, button")?.focus();
 }
 //#endregion
 //#region src/use-submit.ts
@@ -151,14 +155,16 @@ function useSubmit() {
 }
 //#endregion
 //#region src/layout.tsx
-function LayoutTree({ schema, nodes, locale, renderField, at = [] }) {
+function LayoutTree({ schema, nodes, locale, renderField, at = [], shows }) {
 	return /* @__PURE__ */ jsx(Fragment$1, { children: nodes.map((node, index) => {
+		if (shows !== void 0 && !layoutNodeShows(node, shows)) return null;
 		const view = /* @__PURE__ */ jsx(LayoutNodeView, {
 			schema,
 			node,
 			locale,
 			renderField,
-			at: [...at, index]
+			at: [...at, index],
+			shows
 		}, index);
 		if (node.span === void 0) return view;
 		return /* @__PURE__ */ jsx("div", {
@@ -169,7 +175,7 @@ function LayoutTree({ schema, nodes, locale, renderField, at = [] }) {
 		}, index);
 	}) });
 }
-function LayoutNodeView({ schema, node, locale, renderField, at }) {
+function LayoutNodeView({ schema, node, locale, renderField, at, shows }) {
 	const headingId = useId();
 	if (node.kind === "field") return renderField(node.path);
 	if (node.kind === "qrcode") return /* @__PURE__ */ jsx(CodeNode, {
@@ -184,7 +190,8 @@ function LayoutNodeView({ schema, node, locale, renderField, at }) {
 		nodes: layoutChildren(node),
 		locale,
 		renderField,
-		at
+		at,
+		shows
 	});
 	if (node.kind === "row") return /* @__PURE__ */ jsx("div", {
 		"data-formancy-part": "layout-row",
@@ -203,7 +210,8 @@ function LayoutNodeView({ schema, node, locale, renderField, at }) {
 		locale,
 		renderField,
 		at,
-		here
+		here,
+		shows
 	});
 	if (node.kind === "table") return /* @__PURE__ */ jsxs("div", {
 		"data-formancy-part": "layout-table",
@@ -257,15 +265,20 @@ function LayoutNodeView({ schema, node, locale, renderField, at }) {
 * at all — the reader is told the form has an error and sent nowhere. So the
 * strip handles an explicit reveal request before the control receives focus.
 */
-function Tabs({ schema, node, locale, renderField, at, here }) {
+function Tabs({ schema, node, locale, renderField, at, here, shows }) {
 	const base = useId();
-	const [open, setOpen] = useState(0);
+	const shown = node.children.flatMap((child, index) => shows === void 0 || layoutNodeShows(child, shows) ? [{
+		child,
+		index
+	}] : []);
+	const [chosen, setOpen] = useState(0);
+	const open = Math.min(chosen, shown.length - 1);
 	const strip = useRef(null);
 	const panels = useRef([]);
 	const tabs = useRef([]);
 	/** Set only by a key press, so focus is never taken from elsewhere. */
 	const moveFocus = useRef(false);
-	const names = node.children.map((child) => child.kind === "field" ? void 0 : resolveText(schema, child.label, locale));
+	const names = shown.map(({ child }) => child.kind === "field" ? void 0 : resolveText(schema, child.label, locale));
 	useEffect(() => {
 		if (!moveFocus.current) return;
 		moveFocus.current = false;
@@ -281,9 +294,9 @@ function Tabs({ schema, node, locale, renderField, at, here }) {
 		return () => {
 			for (const off of listeners) off?.();
 		};
-	}, [node.children.length]);
+	}, [shown.length]);
 	const onKeyDown = (event) => {
-		const last = node.children.length - 1;
+		const last = shown.length - 1;
 		const next = event.key === "ArrowRight" ? Math.min(open + 1, last) : event.key === "ArrowLeft" ? Math.max(open - 1, 0) : event.key === "Home" ? 0 : event.key === "End" ? last : void 0;
 		if (next === void 0) return;
 		event.preventDefault();
@@ -300,7 +313,7 @@ function Tabs({ schema, node, locale, renderField, at, here }) {
 			...stripName === void 0 ? {} : { "aria-label": stripName },
 			"data-formancy-part": "tablist",
 			onKeyDown,
-			children: node.children.map((child, index) => /* @__PURE__ */ jsx("button", {
+			children: shown.map(({ index: position }, index) => /* @__PURE__ */ jsx("button", {
 				ref: (element) => {
 					tabs.current[index] = element;
 				},
@@ -313,8 +326,8 @@ function Tabs({ schema, node, locale, renderField, at, here }) {
 				"data-formancy-part": "tab",
 				onClick: () => setOpen(index),
 				children: names[index] ?? `Tab ${String(index + 1)}`
-			}, index))
-		}), node.children.map((child, index) => /* @__PURE__ */ jsx("div", {
+			}, position))
+		}), shown.map(({ child, index: position }, index) => /* @__PURE__ */ jsx("div", {
 			ref: (element) => {
 				panels.current[index] = element;
 			},
@@ -328,9 +341,10 @@ function Tabs({ schema, node, locale, renderField, at, here }) {
 				nodes: LAYOUT_LEAF_KINDS.has(child.kind) ? [child] : layoutChildren(child),
 				locale,
 				renderField,
-				at: [...at, index]
+				at: [...at, position],
+				shows
 			})
-		}, index))]
+		}, position))]
 	});
 }
 /**
@@ -672,268 +686,7 @@ function useUploader() {
 	return useContext(UploaderContext);
 }
 //#endregion
-//#region src/form.tsx
-/**
-* Renders the whole form from the engine: one slot per field, resolved through
-* the registry. Slots subscribe individually, so a keystroke re-renders one
-* field and a visibility flip mounts or unmounts exactly the fields it hit.
-* A paged schema renders a stepper, one page at a time, navigation, and the
-* submit control on the last page — a failed submit navigates to the first
-* page with a problem instead of leaving the user on a clean review page
-* staring at a rejection.
-*/
-function FormancyForm(props) {
-	return useFormEngine().wizard() === void 0 ? /* @__PURE__ */ jsx(FlatForm, { ...props }) : /* @__PURE__ */ jsx(PagedForm, { ...props });
-}
-function SubmitButton({ submitLabel, onSubmit, onFailedNavigate }) {
-	const engine = useFormEngine();
-	const submit = useSubmit();
-	return /* @__PURE__ */ jsx("button", {
-		type: "button",
-		"data-formancy-part": "submit",
-		onClick: () => {
-			const outcome = submit();
-			if (!outcome.ok && onFailedNavigate !== void 0) {
-				const firstInvalid = engine.firstInvalid();
-				if (firstInvalid !== null) onFailedNavigate(engine.pageOf(parsePath(firstInvalid)));
-			}
-			onSubmit?.(outcome.ok ? {
-				ok: true,
-				errors: outcome.errors,
-				data: engine.value()
-			} : {
-				ok: false,
-				errors: outcome.errors
-			});
-		},
-		children: submitLabel ?? "Submit"
-	});
-}
-function FlatForm(props) {
-	return /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx(FieldList, { ...props }), /* @__PURE__ */ jsx(SubmitButton, { ...props })] });
-}
-function PagedForm(props) {
-	const engine = useFormEngine();
-	const wizard = useWizard();
-	const pages = engine.pages();
-	const lastPage = wizard.pageCount - 1;
-	return /* @__PURE__ */ jsxs(Fragment$1, { children: [
-		/* @__PURE__ */ jsx("nav", {
-			"data-formancy-part": "stepper",
-			"aria-label": "Progress",
-			children: /* @__PURE__ */ jsx("ol", { children: pages.map((page, index) => /* @__PURE__ */ jsx("li", {
-				"aria-current": index === wizard.page ? "step" : void 0,
-				children: engine.text(page.def.label) ?? page.key
-			}, page.key)) })
-		}),
-		/* @__PURE__ */ jsx(FieldList, {
-			...props,
-			page: wizard.page
-		}),
-		/* @__PURE__ */ jsxs("div", {
-			"data-formancy-part": "wizard-nav",
-			children: [wizard.page > 0 ? /* @__PURE__ */ jsx("button", {
-				type: "button",
-				onClick: () => wizard.back(),
-				children: "Back"
-			}) : null, wizard.page < lastPage ? /* @__PURE__ */ jsx("button", {
-				type: "button",
-				onClick: () => void wizard.next(),
-				children: "Next"
-			}) : /* @__PURE__ */ jsx(SubmitButton, {
-				...props,
-				onFailedNavigate: (page) => wizard.goTo(page)
-			})]
-		})
-	] });
-}
-function FieldList({ labels, registry, page, layout }) {
-	const engine = useFormEngine();
-	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: schema.i18n?.defaultLocale ?? "",
-			renderField: (path) => {
-				if (repeaterWires.includes(path)) return /* @__PURE__ */ jsx(RepeaterSection, {
-					wire: path,
-					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, {
-		path: wire,
-		fallbackLabel: labels?.[wire],
-		registry
-	}, wire)), repeaterWires.filter(inPage).map((wire) => /* @__PURE__ */ jsx(RepeaterSection, {
-		wire,
-		labels,
-		registry
-	}, wire))] });
-}
-function FieldSlot({ path, fallbackLabel, registry }) {
-	const field = useField(path);
-	if (!field.visible) return null;
-	const Component = registry?.byPath?.[path] ?? registry?.byType?.[field.type] ?? DEFAULT_COMPONENTS[field.type];
-	if (Component === null) return null;
-	const label = field.label ?? fallbackLabel ?? path;
-	return /* @__PURE__ */ jsx(Component, {
-		path,
-		label
-	});
-}
-function RepeaterSection({ wire, labels, registry }) {
-	const engine = useFormEngine();
-	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 fallbackFor = (instanceWire) => {
-		const template = instanceWire.replace(/\[\d+\]/, "[]");
-		return labels?.[template] ?? labels?.[instanceWire];
-	};
-	const grid = def?.widget === "datagrid";
-	const declaredColumns = def?.columns ?? [];
-	const plan = grid ? datagridColumns(def, declaredColumns) : [];
-	const tracks = declaredColumns.some((column) => column.width !== void 0) ? plan.map(({ column }) => column?.width === void 0 ? "1fr" : `${String(column.width)}fr`).join(" ") : void 0;
-	/** The control in one cell: the leaf the column's child field collects into.
-	*
-	*  One leaf, because a grid's rows are FLAT -- a child holding fields of its own is
-	*  refused when the document is saved
-	*  ([0078](../../../docs/decisions/0078-a-grid-row-is-flat.md)). This walked the whole
-	*  subtree under the child while a group could be a column, and every clause that made
-	*  that walk safe is gone with the arrangement it served.
-	*
-	*  Still a filter over the paths that EXIST rather than the path the column implies, so
-	*  a document nobody validated renders an empty cell instead of asking the engine about
-	*  a field it does not have. */
-	const leavesOf = (index, key) => {
-		const wanted = `${wire}[${String(index)}].${key}`;
-		return engine.fieldPaths().filter((leaf) => leaf === wanted);
-	};
-	/** A column's visible heading: the author's shortening, else the child's own label,
-	*  else the labels prop, else the key.
-	*
-	*  Visible text and NOTHING else -- never an `id` target, never an `aria-label`.
-	*  Measured against the accessible-name implementation this repository installs: a
-	*  column heading contributes nothing to the name of a control in its column, whether
-	*  it is a `<th scope="col">` or a `headers=` target. So the heading cannot replace a
-	*  cell's label, and pointing a control at it would only ADD the heading to the name --
-	*  which is the failure 0066 separates `header` from `label` to prevent. */
-	const headingOf = (entry) => engine.text(entry.column?.header) ?? engine.text(entry.child?.label) ?? fallbackFor(`${wire}[0].${entry.key}`) ?? entry.key;
-	/** A row's own controls, identical in both arrangements down to the names, because
-	*  0068 put the row's position in those names and a grid does not change where a person
-	*  is.
-	*
-	*  The text sits in its own element so a THEME can clip it and draw a mark instead,
-	*  which is what a grid wants -- "Remove recipient 1 of 1" on three wrapped lines took
-	*  more room than the answers beside it, measured in the playground. Clipped and never
-	*  removed: `display: none` and `visibility: hidden` both compute the button's name to
-	*  the empty string, and a button called nothing is worse than a wide one.
-	*
-	*  The renderer draws no mark of its own. An icon is appearance, appearance belongs to
-	*  the consumer ([0004](../../../docs/decisions/0004-headless-core.md)), and a renderer
-	*  that shipped a glyph would be choosing one for every design system at once. */
-	const rowButtons = (index) => /* @__PURE__ */ jsxs(Fragment$1, { children: [
-		/* @__PURE__ */ jsx("button", {
-			type: "button",
-			"data-formancy-part": "row-remove",
-			onClick: () => repeater.removeRow(index),
-			children: /* @__PURE__ */ jsx("span", {
-				"data-formancy-part": "row-action-text",
-				children: `${removeLabel} ${index + 1} of ${repeater.rowCount}`
-			})
-		}),
-		index > 0 ? /* @__PURE__ */ jsx("button", {
-			type: "button",
-			"data-formancy-part": "row-up",
-			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`
-			})
-		}) : null,
-		index < repeater.rowCount - 1 ? /* @__PURE__ */ jsx("button", {
-			type: "button",
-			"data-formancy-part": "row-down",
-			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`
-			})
-		}) : null
-	] });
-	/** One control in a row.
-	*
-	*  Keyed by the POSITIONAL WIRE, so every control in a row is remounted when the row
-	*  moves and focus is lost on a reorder. Keying by the field's key within the row fixes
-	*  that here, and was reverted to keep the two renderers identical: the same change in
-	*  Angular lets it REUSE a component whose path is read once in ngOnInit, so after a
-	*  removal it binds to the old wire and shows the wrong row's answer -- caught by a
-	*  conformance fixture. One renderer keeping focus and the other not is the
-	*  framework-specific divergence this architecture exists to prevent, so both wait for
-	*  reactive path binding in Angular. */
-	const slot = (instanceWire) => /* @__PURE__ */ jsx(FieldSlot, {
-		path: instanceWire,
-		fallbackLabel: fallbackFor(instanceWire),
-		registry
-	}, instanceWire);
-	const rows = repeater.rowIds.map((rowId, index) => grid ? /* @__PURE__ */ jsxs("div", {
-		"data-formancy-part": "datagrid-row",
-		children: [plan.map((entry) => /* @__PURE__ */ jsx("div", {
-			"data-formancy-part": "datagrid-cell",
-			...entry.column?.align === void 0 ? {} : { "data-align": entry.column.align },
-			children: leavesOf(index, entry.key).map(slot)
-		}, entry.key)), /* @__PURE__ */ jsx("div", {
-			"data-formancy-part": "datagrid-actions",
-			children: rowButtons(index)
-		})]
-	}, rowId) : /* @__PURE__ */ jsxs("div", {
-		"data-formancy-part": "row",
-		children: [engine.fieldPaths().filter((candidate) => candidate.startsWith(`${wire}[${String(index)}]`)).map(slot), rowButtons(index)]
-	}, rowId));
-	return /* @__PURE__ */ jsxs("fieldset", {
-		"data-formancy-part": "repeater",
-		children: [
-			/* @__PURE__ */ jsx("legend", {
-				"data-formancy-part": "repeater-legend",
-				children: label
-			}),
-			grid ? /* @__PURE__ */ jsxs("div", {
-				"data-formancy-part": "datagrid",
-				"data-columns": String(plan.length),
-				...tracks === void 0 ? {} : { style: { "--fm-datagrid-columns": tracks } },
-				children: [repeater.rowCount > 0 ? /* @__PURE__ */ jsx("div", {
-					"data-formancy-part": "datagrid-head",
-					children: plan.map((entry) => /* @__PURE__ */ jsx("span", {
-						"data-formancy-part": "datagrid-heading",
-						...entry.column?.align === void 0 ? {} : { "data-align": entry.column.align },
-						children: headingOf(entry)
-					}, entry.key))
-				}) : null, rows]
-			}) : rows,
-			/* @__PURE__ */ jsx("button", {
-				type: "button",
-				onClick: () => repeater.addRow(),
-				children: addLabel
-			})
-		]
-	});
-}
+//#region src/fields/internals.tsx
 /** Shared unstyled shell: real label, control, error text as the describedby
 *  target. Zero CSS; `data-formancy-part` is the styling hook. */
 function FieldShell({ path, field, label, children }) {
@@ -957,110 +710,267 @@ function FieldShell({ path, field, label, children }) {
 	});
 }
 /**
-* A single-line answer, and — with `widget: "scanner"` — a camera route to the same
-* string.
+* `widget: "typeahead"` - the same select, narrowed by typing.
 *
-* The input is the control in both cases, never a second one beside it: typing is
-* the accessibility floor and the fallback at once, so it is what is always there
-* and the scan button is what is sometimes added. With no scanner supplied the
-* markup is the default control exactly, because a Scan button that opens nothing is
-* worse than no button ([0071](../../../docs/decisions/0071-a-scanner-is-supplied-not-built.md)).
+* An ARIA 1.2 editable combobox over a listbox popup: a text box with
+* `role="combobox"` and a `<ul role="listbox">` of `<li role="option">`. DOM focus
+* never leaves the text box, so the arrowed-over option is named by
+* `aria-activedescendant` - which is the only thing that says where somebody is
+* when what they are moving through does not hold focus.
+*
+* **The list element exists while the popup is collapsed.** `aria-expanded` and
+* `aria-controls` are required properties of the role, and an `aria-controls`
+* pointing at an element that is not there is an unresolvable IDREF - so the
+* listbox is rendered and `hidden` rather than mounted when it opens.
+*
+* `aria-autocomplete="list"`, never `"both"`: nothing is ever written into the box
+* on the person's behalf, and `"both"` announces an inline completion that does
+* not exist. No `aria-haspopup`: `listbox` is the role's implicit popup, so the
+* attribute either repeats it or lies.
+*
+* `aria-selected` is on the CHOSEN option and on nothing else. Following the arrow
+* keys with it - the commonest defect in this pattern - tells a screen reader the
+* answer changed every time somebody pressed Down to read the next row.
+*
+* **It cannot store what somebody typed.** `setValue` is reached from exactly two
+* places here, with an option's own value or with `null`, and the text goes nowhere
+* but the filter. That is what makes
+* [0065](../../../docs/decisions/0065-a-widget-is-authored-not-registered.md)
+* structural rather than remembered: there is no path from this input to a stored
+* string a plain select could not have produced. So leaving the field with a query
+* that matches nothing stores nothing, and the box goes back to showing the answer.
+*
+* `null` is the other half of that: a select's empty first option means
+* un-answering is always available, and a widget may not take it away. Clearing the
+* box and leaving clears the answer.
 */
-function TextField({ path, label }) {
-	const field = useField(path);
-	const scan = useScanner();
-	const [scanning, setScanning] = useState(false);
-	/** A device failure, held here rather than in the field's errors. See below. */
-	const [trouble, setTrouble] = useState(void 0);
+/**
+* What the status region is saying, as a word a theme can select on.
+*
+* Not the text: a theme that keyed off English prose would break in every other
+* language the form is offered in.
+*/
+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.status !== "") return "hint";
+	return open && matches === 0 ? "empty" : void 0;
+}
+/**
+* How a grouped field says it is required.
+*
+* A real element rather than an attribute, because the attribute that would
+* mean this — `aria-required` — is not supported on `role="group"`. The
+* engine puts this element's id into the group's `aria-describedby`, so it is
+* announced after the legend; rendering it is all a renderer has to do.
+*
+* Visible as well as announced: WCAG 1.4.1 means a requirement carried only by
+* a red asterisk is a requirement some people cannot perceive.
+*/
+function RequiredHint({ field }) {
+	if (!field.required) return null;
+	return /* @__PURE__ */ jsx("span", {
+		"data-formancy-part": "required-hint",
+		id: field.props.hint.id,
+		children: "required"
+	});
+}
+/** One option's element id, in the shape the radio group already uses, so a
+*  reader of the DOM meets one convention rather than two. */
+function optionDomId(field, value) {
+	return `${field.ids.control}:option:${value}`;
+}
+/**
+* Option labels resolved to strings, since a label may be a message reference.
+* Falling back to the stored value keeps an untranslated option selectable
+* rather than blank. A picture from somewhere the format does not allow is left
+* out, by the same test the Angular binding makes (0126).
+*/
+function useResolvedOptions(field) {
+	const engine = useFormEngine();
+	return (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) ?? ""
+		} } : {}
+	}));
+}
+/**
+* An option's picture, inside its label so that pressing it chooses the option and
+* its text alternative joins the option's name. Lazy, because a long list of
+* pictured options is a page of images the person may never scroll to.
+*/
+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/typeahead-field.tsx
+/**
+* A combobox over the same answer a select holds.
+*
+* One file per control, because a control changes for its own reasons.
+* These were one 2,154-line file — the largest in the repository.
+*/
+function TypeaheadSelectField({ path, label, field }) {
 	/**
-	* The ONE place a text field's answer is written, typed or scanned.
+	* What is in the box while somebody types, or null when the box is simply
+	* showing the answer.
 	*
-	* Structural rather than careful: the parameter is a `string`, so there is no path
-	* from the camera to `setValue` that could store something typing could not. That
-	* is the line a widget may never cross — it changes how a field looks, never what
-	* it collects ([0065](../../../docs/decisions/0065-a-widget-is-authored-not-registered.md)).
+	* Two states rather than one string, because "empty because they cleared it"
+	* and "empty because there is no answer" are different facts, and only the
+	* first clears the answer on the way out.
 	*/
-	const commit = (text) => field.setValue(text.replace(/[\r\n]/g, ""));
-	const read = async () => {
-		if (scan === void 0 || scanning) return;
-		setScanning(true);
-		setTrouble(void 0);
-		try {
-			const text = await scan({
-				label,
-				path
-			});
-			if (text === null) return;
-			if (typeof text !== "string") {
-				setTrouble("Scanning did not work: the scanner did not return text. Type the value instead.");
+	const [query, setQuery] = useState(null);
+	const [open, setOpen] = useState(false);
+	/** The arrowed-over option by VALUE, not by index: the filtered list changes on
+	*  every keystroke and an index would point at a different row after one. */
+	const [activeValue, setActiveValue] = useState(null);
+	const sourced = useSourcedOptions({
+		...field,
+		path
+	}, query ?? "");
+	const options = sourced.options;
+	const chosen = options.find((option) => option.value === field.value);
+	const matches = sourced.remote === null ? narrowOptionsByLabel(options, query ?? "") : options;
+	/** Collapsed whenever there is nothing on the screen, so `aria-expanded` never
+	*  claims a popup a person cannot see. */
+	const expanded = open && matches.length > 0;
+	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 choose = (value) => {
+		field.setValue(value);
+		setQuery(null);
+		setOpen(false);
+		setActiveValue(null);
+	};
+	const moveActive = (delta) => {
+		if (matches.length === 0) return;
+		const from = activeIndex === -1 ? delta > 0 ? -1 : matches.length : activeIndex;
+		const next = Math.min(Math.max(from + delta, 0), matches.length - 1);
+		setActiveValue(matches[next].value);
+	};
+	const onKeyDown = (event) => {
+		if (event.key === "ArrowDown" || event.key === "ArrowUp") {
+			event.preventDefault();
+			if (!open) {
+				setOpen(true);
+				const fallback = event.key === "ArrowDown" ? matches[0] : matches[matches.length - 1];
+				setActiveValue(chosen?.value ?? fallback?.value ?? null);
 				return;
 			}
-			commit(text);
-			field.touch();
-		} catch (error) {
-			setTrouble(`Scanning did not work: ${error instanceof Error ? error.message : String(error)}. Type the value instead.`);
-		} finally {
-			setScanning(false);
+			moveActive(event.key === "ArrowDown" ? 1 : -1);
+			return;
+		}
+		if ((event.key === "Home" || event.key === "End") && expanded) {
+			event.preventDefault();
+			setActiveValue((event.key === "Home" ? matches[0] : matches[matches.length - 1]).value);
+			return;
+		}
+		if (event.key === "Enter") {
+			if (!expanded) return;
+			event.preventDefault();
+			if (activeIndex === -1) {
+				setOpen(false);
+				return;
+			}
+			choose(matches[activeIndex].value);
+			return;
+		}
+		if (event.key === "Escape") {
+			if (!open && query === null) return;
+			event.preventDefault();
+			setOpen(false);
+			setActiveValue(null);
+			setQuery(null);
+		}
+	};
+	const onBlur = () => {
+		setOpen(false);
+		setActiveValue(null);
+		if (query !== null) {
+			if (query.trim() === "") field.setValue(null);
+			setQuery(null);
 		}
+		field.touch();
 	};
 	return /* @__PURE__ */ jsxs(FieldShell, {
 		path,
 		field,
 		label,
-		children: [/* @__PURE__ */ jsx("input", {
-			type: "text",
-			...field.controlProps,
-			value: typeof field.value === "string" ? field.value : "",
-			onChange: (event) => commit(event.target.value),
-			onBlur: () => field.touch()
-		}), field.def.widget === "scanner" && scan !== void 0 ? /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsxs("button", {
-			type: "button",
-			"data-formancy-part": "scanner-button",
-			disabled: field.disabled,
-			"aria-busy": scanning ? true : void 0,
-			onClick: () => {
-				read();
-			},
-			children: ["Scan ", /* @__PURE__ */ jsx("span", {
-				"data-formancy-part": "visually-hidden",
-				children: label
+		children: [/* @__PURE__ */ jsxs("div", {
+			"data-formancy-part": "typeahead-anchor",
+			children: [/* @__PURE__ */ jsx("input", {
+				type: "text",
+				role: "combobox",
+				...field.controlProps,
+				"data-formancy-part": "typeahead",
+				autoComplete: "off",
+				"aria-expanded": expanded,
+				"aria-controls": listboxId,
+				"aria-autocomplete": "list",
+				...sourced.remote?.busy === true ? { "aria-busy": true } : {},
+				...activeId === void 0 ? {} : { "aria-activedescendant": activeId },
+				value: query ?? chosen?.label ?? "",
+				onChange: (event) => {
+					setQuery(event.target.value);
+					setOpen(true);
+					setActiveValue(null);
+				},
+				onClick: () => setOpen(true),
+				onKeyDown,
+				onBlur
+			}), /* @__PURE__ */ jsx("ul", {
+				id: listboxId,
+				role: "listbox",
+				"aria-label": `${label} suggestions`,
+				"data-formancy-part": "typeahead-listbox",
+				hidden: !expanded,
+				children: matches.map((option) => /* @__PURE__ */ jsx("li", {
+					id: optionDomId(field, option.value),
+					role: "option",
+					"data-formancy-part": "typeahead-option",
+					"data-active": option.value === activeValue ? "true" : void 0,
+					...chosen?.value === option.value ? { "aria-selected": true } : {},
+					onMouseDown: (event) => event.preventDefault(),
+					onClick: () => choose(option.value),
+					children: option.label
+				}, option.value))
 			})]
 		}), /* @__PURE__ */ jsx("p", {
 			role: "status",
-			"data-formancy-part": "scanner-status",
-			children: scanning ? "Scanning…" : trouble ?? ""
-		})] }) : null]
-	});
-}
-function TextareaField({ path, label }) {
-	const field = useField(path);
-	return /* @__PURE__ */ jsx(FieldShell, {
-		path,
-		field,
-		label,
-		children: /* @__PURE__ */ jsx("textarea", {
-			...field.controlProps,
-			value: typeof field.value === "string" ? field.value : "",
-			onChange: (event) => field.setValue(event.target.value),
-			onBlur: () => field.touch()
-		})
-	});
-}
-function NumberField({ path, label }) {
-	const field = useField(path);
-	return /* @__PURE__ */ jsx(FieldShell, {
-		path,
-		field,
-		label,
-		children: /* @__PURE__ */ jsx("input", {
-			type: "number",
-			...field.controlProps,
-			value: typeof field.value === "number" ? field.value : "",
-			onChange: (event) => field.setValue(event.target.value === "" ? null : event.target.valueAsNumber),
-			onBlur: () => field.touch()
-		})
+			"data-formancy-part": "typeahead-status",
+			...statusState({
+				sourced,
+				open,
+				matches: matches.length
+			}) === void 0 ? {} : { "data-state": statusState({
+				sourced,
+				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" : ""
+		})]
 	});
 }
+//#endregion
+//#region src/fields/choice-fields.tsx
+/**
+* One answer from a set: a tick, a list, or a group of radios.
+*
+* One file per control, because a control changes for its own reasons.
+* These were one 2,154-line file — the largest in the repository.
+*/
 function CheckboxField({ path, label }) {
 	const field = useField(path);
 	return /* @__PURE__ */ jsx(FieldShell, {
@@ -1077,115 +987,6 @@ function CheckboxField({ path, label }) {
 		})
 	});
 }
-function DateField({ path, label }) {
-	const field = useField(path);
-	return /* @__PURE__ */ jsx(FieldShell, {
-		path,
-		field,
-		label,
-		children: /* @__PURE__ */ jsx("input", {
-			type: "date",
-			...field.controlProps,
-			value: typeof field.value === "string" ? field.value : "",
-			onChange: (event) => field.setValue(event.target.value === "" ? null : event.target.value),
-			onBlur: () => field.touch()
-		})
-	});
-}
-/**
-* A time of day, as `HH:MM`.
-*
-* `<input type="time">` gives the platform's own picker, its own keyboard handling
-* and its own locale display — a 12-hour clock where the reader expects one — while
-* its `value` is always `HH:MM` on a 24-hour clock. That is exactly the split the
-* format wants: the reader sees their convention, the answer records one canonical
-* shape.
-*
-* `step` is not set, so the browser offers no seconds. A time answer has none, and a
-* control offering a precision the format discards is a control that loses what
-* somebody typed.
-*/
-function TimeField({ path, label }) {
-	const field = useField(path);
-	return /* @__PURE__ */ jsx(FieldShell, {
-		path,
-		field,
-		label,
-		children: /* @__PURE__ */ jsx("input", {
-			type: "time",
-			...field.controlProps,
-			...typeof field.def.earliest === "string" ? { min: field.def.earliest } : {},
-			...typeof field.def.latest === "string" ? { max: field.def.latest } : {},
-			value: typeof field.value === "string" ? field.value : "",
-			onChange: (event) => field.setValue(event.target.value === "" ? null : event.target.value),
-			onBlur: () => field.touch()
-		})
-	});
-}
-/**
-* An instant, stored as `YYYY-MM-DDTHH:MM:SSZ`.
-*
-* `<input type="datetime-local">` because there is no zoned datetime input in any
-* browser — so the control shows the reader a local wall clock and this converts.
-* The conversion is the whole reason this component exists rather than reusing
-* `DateField`:
-*
-* - **In:** the control gives `YYYY-MM-DDTHH:MM` in the reader's own zone. `new
-*   Date(local).toISOString()` interprets a zoneless string as local time, which is
-*   what is wanted here and is exactly what `bindTimestamp` refuses for a stored
-*   value — the difference is that the reader's zone is known at the moment they
-*   type, and is not knowable later.
-* - **Out:** the stored instant is rendered back into local time for the control,
-*   sliced to minutes because the input rejects a seconds component it was not asked
-*   for.
-*
-* Seconds are therefore always `00` in an answer a person typed. The format keeps
-* them because a machine-supplied answer has them and a fixed width is what makes
-* ordering work.
-*/
-function DateTimeField({ path, label }) {
-	const field = useField(path);
-	const stored = typeof field.value === "string" ? field.value : "";
-	const asLocal = () => {
-		if (stored === "") return "";
-		const instant = new Date(stored);
-		if (Number.isNaN(instant.getTime())) return "";
-		const pad = (part) => String(part).padStart(2, "0");
-		return `${String(instant.getFullYear())}-${pad(instant.getMonth() + 1)}-${pad(instant.getDate())}T${pad(instant.getHours())}:${pad(instant.getMinutes())}`;
-	};
-	return /* @__PURE__ */ jsx(FieldShell, {
-		path,
-		field,
-		label,
-		children: /* @__PURE__ */ jsx("input", {
-			type: "datetime-local",
-			...field.controlProps,
-			value: asLocal(),
-			onChange: (event) => {
-				const local = event.target.value;
-				if (local === "") {
-					field.setValue(null);
-					return;
-				}
-				const instant = new Date(local);
-				field.setValue(Number.isNaN(instant.getTime()) ? null : `${instant.toISOString().slice(0, 19)}Z`);
-			},
-			onBlur: () => field.touch()
-		})
-	});
-}
-/**
-* Option labels resolved to strings, since a label may be a message reference.
-* Falling back to the stored value keeps an untranslated option selectable
-* rather than blank.
-*/
-function useResolvedOptions(field) {
-	const engine = useFormEngine();
-	return (field.def.options ?? []).map((option) => ({
-		value: option.value,
-		label: engine.text(option.label) ?? option.value
-	}));
-}
 function SelectField({ path, label }) {
 	const field = useField(path);
 	const sourced = useSourcedOptions({
@@ -1227,339 +1028,333 @@ function SelectField({ path, label }) {
 		})]
 	});
 }
+function RadioGroupField({ path, label }) {
+	const field = useField(path);
+	const options = useResolvedOptions(field);
+	const showError = field.touched && field.errors.length > 0;
+	return /* @__PURE__ */ jsxs("fieldset", {
+		"data-formancy-part": "field",
+		"data-formancy-field-path": path,
+		"data-state": showError ? "invalid" : "valid",
+		"aria-describedby": field.controlProps["aria-describedby"],
+		children: [
+			/* @__PURE__ */ jsx("legend", {
+				"data-formancy-part": "label",
+				children: label
+			}),
+			/* @__PURE__ */ jsx(RequiredHint, { field }),
+			options.map((option) => {
+				const optionId = `${field.ids.control}:${option.value}`;
+				return /* @__PURE__ */ jsxs("span", {
+					"data-formancy-part": "radio-option",
+					children: [/* @__PURE__ */ jsx("input", {
+						type: "radio",
+						id: optionId,
+						name: field.controlProps.name,
+						value: option.value,
+						checked: field.value === option.value,
+						onChange: () => field.setValue(option.value),
+						onBlur: () => field.touch()
+					}), /* @__PURE__ */ jsxs("label", {
+						htmlFor: optionId,
+						children: [/* @__PURE__ */ jsx(OptionPicture, { option }), option.label]
+					})]
+				}, option.value);
+			}),
+			showError ? /* @__PURE__ */ jsx("p", {
+				"data-formancy-part": "error",
+				...field.errorProps,
+				children: field.errors.join(", ")
+			}) : null
+		]
+	});
+}
+//#endregion
+//#region src/fields/file-field.tsx
 /**
-* `widget: "typeahead"` - the same select, narrowed by typing.
-*
-* An ARIA 1.2 editable combobox over a listbox popup: a text box with
-* `role="combobox"` and a `<ul role="listbox">` of `<li role="option">`. DOM focus
-* never leaves the text box, so the arrowed-over option is named by
-* `aria-activedescendant` - which is the only thing that says where somebody is
-* when what they are moving through does not hold focus.
-*
-* **The list element exists while the popup is collapsed.** `aria-expanded` and
-* `aria-controls` are required properties of the role, and an `aria-controls`
-* pointing at an element that is not there is an unresolvable IDREF - so the
-* listbox is rendered and `hidden` rather than mounted when it opens.
-*
-* `aria-autocomplete="list"`, never `"both"`: nothing is ever written into the box
-* on the person's behalf, and `"both"` announces an inline completion that does
-* not exist. No `aria-haspopup`: `listbox` is the role's implicit popup, so the
-* attribute either repeats it or lies.
-*
-* `aria-selected` is on the CHOSEN option and on nothing else. Following the arrow
-* keys with it - the commonest defect in this pattern - tells a screen reader the
-* answer changed every time somebody pressed Down to read the next row.
-*
-* **It cannot store what somebody typed.** `setValue` is reached from exactly two
-* places here, with an option's own value or with `null`, and the text goes nowhere
-* but the filter. That is what makes
-* [0065](../../../docs/decisions/0065-a-widget-is-authored-not-registered.md)
-* structural rather than remembered: there is no path from this input to a stored
-* string a plain select could not have produced. So leaving the field with a query
-* that matches nothing stores nothing, and the box goes back to showing the answer.
+* The file control, over an uploader the host supplies.
 *
-* `null` is the other half of that: a select's empty first option means
-* un-answering is always available, and a widget may not take it away. Clearing the
-* box and leaving clears the answer.
+* One file per control, because a control changes for its own reasons.
+* These were one 2,154-line file — the largest in the repository.
 */
 /**
-* What the status region is saying, as a word a theme can select on.
+* Attached files.
 *
-* Not the text: a theme that keyed off English prose would break in every other
-* language the form is offered in.
+* The control picks files; something else uploads them and reports back what
+* was stored. That split is the whole design: this package has no opinion
+* about where bytes go, which is what lets the same field work against local
+* disk, S3 or a customer's own service.
+*
+* Without an uploader the field is read-only and says so, rather than
+* pretending to accept a file it has nowhere to put.
+*
+* **Each file is its own upload** — waiting, sending with how far it has got,
+* cancellable, and refused with a reason and a way to try again. What happens to
+* each is `@formancy/core`'s upload queue, read by both renderers
+* ([0130](../../../../docs/decisions/0130-each-file-is-its-own-upload.md)); this
+* draws it.
 */
-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.status !== "") return "hint";
-	return open && matches === 0 ? "empty" : void 0;
-}
-function TypeaheadSelectField({ path, label, field }) {
+function FileField({ path, label }) {
+	const field = useField(path);
+	const upload = useUploader();
+	const queue = useUploadQueue(path, upload);
+	const pending = useSyncExternalStore(queue.subscribe, queue.pending, queue.pending);
+	const files = Array.isArray(field.value) ? field.value : [];
+	const [over, setOver] = useState(false);
 	/**
-	* What is in the box while somebody types, or null when the box is simply
-	* showing the answer.
+	* Attachments taken out of the answer but not yet forgotten.
 	*
-	* Two states rather than one string, because "empty because they cleared it"
-	* and "empty because there is no answer" are different facts, and only the
-	* first clears the answer on the way out.
+	* Held with the position they came from, so undoing puts a file BACK where it
+	* was rather than on the end — the order matters to somebody who numbered
+	* their attachments in a covering note.
 	*/
-	const [query, setQuery] = useState(null);
-	const [open, setOpen] = useState(false);
-	/** The arrowed-over option by VALUE, not by index: the filtered list changes on
-	*  every keystroke and an index would point at a different row after one. */
-	const [activeValue, setActiveValue] = useState(null);
-	const sourced = useSourcedOptions({
-		...field,
-		path
-	}, query ?? "");
-	const options = sourced.options;
-	const chosen = options.find((option) => option.value === field.value);
-	const matches = sourced.remote === null ? narrowOptionsByLabel(options, query ?? "") : options;
-	/** Collapsed whenever there is nothing on the screen, so `aria-expanded` never
-	*  claims a popup a person cannot see. */
-	const expanded = open && matches.length > 0;
-	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 choose = (value) => {
-		field.setValue(value);
-		setQuery(null);
-		setOpen(false);
-		setActiveValue(null);
-	};
-	const moveActive = (delta) => {
-		if (matches.length === 0) return;
-		const from = activeIndex === -1 ? delta > 0 ? -1 : matches.length : activeIndex;
-		const next = Math.min(Math.max(from + delta, 0), matches.length - 1);
-		setActiveValue(matches[next].value);
-	};
-	const onKeyDown = (event) => {
-		if (event.key === "ArrowDown" || event.key === "ArrowUp") {
-			event.preventDefault();
-			if (!open) {
-				setOpen(true);
-				const fallback = event.key === "ArrowDown" ? matches[0] : matches[matches.length - 1];
-				setActiveValue(chosen?.value ?? fallback?.value ?? null);
-				return;
-			}
-			moveActive(event.key === "ArrowDown" ? 1 : -1);
-			return;
-		}
-		if ((event.key === "Home" || event.key === "End") && expanded) {
-			event.preventDefault();
-			setActiveValue((event.key === "Home" ? matches[0] : matches[matches.length - 1]).value);
-			return;
-		}
-		if (event.key === "Enter") {
-			if (!expanded) return;
-			event.preventDefault();
-			if (activeIndex === -1) {
-				setOpen(false);
-				return;
-			}
-			choose(matches[activeIndex].value);
-			return;
-		}
-		if (event.key === "Escape") {
-			if (!open && query === null) return;
-			event.preventDefault();
-			setOpen(false);
-			setActiveValue(null);
-			setQuery(null);
-		}
-	};
-	const onBlur = () => {
-		setOpen(false);
-		setActiveValue(null);
-		if (query !== null) {
-			if (query.trim() === "") field.setValue(null);
-			setQuery(null);
-		}
-		field.touch();
+	const [removed, setRemoved] = useState([]);
+	const accept = field.def.accept;
+	const multiple = field.def.maxItems === void 0 || field.def.maxItems > 1;
+	const onPick = (picked) => {
+		if (picked === null || picked.length === 0 || upload === void 0) return;
+		queue.add(Array.from(picked));
 	};
 	return /* @__PURE__ */ jsxs(FieldShell, {
 		path,
 		field,
 		label,
-		children: [/* @__PURE__ */ jsxs("div", {
-			"data-formancy-part": "typeahead-anchor",
-			children: [/* @__PURE__ */ jsx("input", {
-				type: "text",
-				role: "combobox",
-				...field.controlProps,
-				"data-formancy-part": "typeahead",
-				autoComplete: "off",
-				"aria-expanded": expanded,
-				"aria-controls": listboxId,
-				"aria-autocomplete": "list",
-				...sourced.remote?.busy === true ? { "aria-busy": true } : {},
-				...activeId === void 0 ? {} : { "aria-activedescendant": activeId },
-				value: query ?? chosen?.label ?? "",
-				onChange: (event) => {
-					setQuery(event.target.value);
-					setOpen(true);
-					setActiveValue(null);
+		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."
+			}) : /* @__PURE__ */ jsx("div", {
+				"data-formancy-part": "file-dropzone",
+				...over ? { "data-state": "over" } : {},
+				onDragOver: (event) => {
+					event.preventDefault();
+					if (field.disabled) return;
+					setOver(true);
 				},
-				onClick: () => setOpen(true),
-				onKeyDown,
-				onBlur
-			}), /* @__PURE__ */ jsx("ul", {
-				id: listboxId,
-				role: "listbox",
-				"aria-label": `${label} suggestions`,
-				"data-formancy-part": "typeahead-listbox",
-				hidden: !expanded,
-				children: matches.map((option) => /* @__PURE__ */ jsx("li", {
-					id: optionDomId(field, option.value),
-					role: "option",
-					"data-formancy-part": "typeahead-option",
-					"data-active": option.value === activeValue ? "true" : void 0,
-					...chosen?.value === option.value ? { "aria-selected": true } : {},
-					onMouseDown: (event) => event.preventDefault(),
-					onClick: () => choose(option.value),
-					children: option.label
-				}, option.value))
-			})]
-		}), /* @__PURE__ */ jsx("p", {
-			role: "status",
-			"data-formancy-part": "typeahead-status",
-			...statusState({
-				sourced,
-				open,
-				matches: matches.length
-			}) === void 0 ? {} : { "data-state": statusState({
-				sourced,
-				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" : ""
-		})]
+				onDragLeave: () => setOver(false),
+				onDrop: (event) => {
+					event.preventDefault();
+					setOver(false);
+					if (field.disabled) return;
+					onPick(event.dataTransfer.files);
+				},
+				children: /* @__PURE__ */ jsx("input", {
+					...field.controlProps,
+					type: "file",
+					multiple,
+					...accept === void 0 ? {} : { accept: accept.join(",") },
+					disabled: field.disabled,
+					onChange: (event) => {
+						onPick(event.target.files);
+						event.target.value = "";
+					}
+				})
+			}),
+			files.length === 0 && pending.length === 0 && removed.length === 0 ? null : /* @__PURE__ */ jsxs("ul", {
+				"data-formancy-part": "file-list",
+				children: [
+					files.map((file, index) => /* @__PURE__ */ jsxs("li", {
+						"data-formancy-part": "file-item",
+						children: [
+							/* @__PURE__ */ jsx(FileThumbnail, { source: queue.sourceOf(file.id) }),
+							/* @__PURE__ */ jsx("span", {
+								"data-formancy-part": "file-name",
+								children: file.name
+							}),
+							index > 0 ? /* @__PURE__ */ jsx("button", {
+								type: "button",
+								"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`
+							}) : 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`
+							}) : null,
+							/* @__PURE__ */ jsxs("button", {
+								type: "button",
+								disabled: field.disabled,
+								onClick: () => {
+									setRemoved((before) => [...before, {
+										at: index,
+										file
+									}]);
+									field.setValue(files.filter((other) => other.id !== file.id));
+								},
+								children: ["Remove ", file.name]
+							})
+						]
+					}, file.id)),
+					pending.map((entry) => /* @__PURE__ */ jsx(PendingRow, {
+						entry,
+						queue,
+						disabled: field.disabled
+					}, entry.key)),
+					removed.map(({ at, file }) => /* @__PURE__ */ jsxs("li", {
+						"data-formancy-part": "file-item",
+						"data-state": "removed",
+						children: [/* @__PURE__ */ jsx("span", {
+							"data-formancy-part": "file-name",
+							children: file.name
+						}), /* @__PURE__ */ jsxs("button", {
+							type: "button",
+							disabled: field.disabled,
+							onClick: () => {
+								setRemoved((before) => before.filter((other) => other.file.id !== file.id));
+								const next = [...files];
+								next.splice(Math.min(at, next.length), 0, file);
+								field.setValue(next);
+							},
+							children: ["Undo removing ", file.name]
+						})]
+					}, file.id))
+				]
+			}),
+			/* @__PURE__ */ jsx("p", {
+				role: "status",
+				"data-formancy-part": "file-status",
+				children: statusOf(pending)
+			})
+		]
 	});
 }
-/** One option's element id, in the shape the radio group already uses, so a
-*  reader of the DOM meets one convention rather than two. */
-function optionDomId(field, value) {
-	return `${field.ids.control}:option:${value}`;
-}
-/**
-* How a grouped field says it is required.
-*
-* A real element rather than an attribute, because the attribute that would
-* mean this — `aria-required` — is not supported on `role="group"`. The
-* engine puts this element's id into the group's `aria-describedby`, so it is
-* announced after the legend; rendering it is all a renderer has to do.
-*
-* Visible as well as announced: WCAG 1.4.1 means a requirement carried only by
-* a red asterisk is a requirement some people cannot perceive.
-*/
-function RequiredHint({ field }) {
-	if (!field.required) return null;
-	return /* @__PURE__ */ jsx("span", {
-		"data-formancy-part": "required-hint",
-		id: field.props.hint.id,
-		children: "required"
-	});
+/** The files with one moved a place. */
+function moved(files, from, to) {
+	const next = [...files];
+	next.splice(to, 0, ...next.splice(from, 1));
+	return next;
 }
-function RadioGroupField({ path, label }) {
-	const field = useField(path);
-	const options = useResolvedOptions(field);
-	const showError = field.touched && field.errors.length > 0;
-	return /* @__PURE__ */ jsxs("fieldset", {
-		"data-formancy-part": "field",
-		"data-formancy-field-path": path,
-		"data-state": showError ? "invalid" : "valid",
-		"aria-describedby": field.controlProps["aria-describedby"],
+/** A file not yet in the answer: waiting, being sent, or refused. */
+function PendingRow({ entry, queue, disabled }) {
+	const failed = entry.state === "failed";
+	return /* @__PURE__ */ jsxs("li", {
+		"data-formancy-part": "file-item",
+		"data-state": entry.state,
 		children: [
-			/* @__PURE__ */ jsx("legend", {
-				"data-formancy-part": "label",
-				children: label
-			}),
-			/* @__PURE__ */ jsx(RequiredHint, { field }),
-			options.map((option) => {
-				const optionId = `${field.ids.control}:${option.value}`;
-				return /* @__PURE__ */ jsxs("span", {
-					"data-formancy-part": "radio-option",
-					children: [/* @__PURE__ */ jsx("input", {
-						type: "radio",
-						id: optionId,
-						name: field.controlProps.name,
-						value: option.value,
-						checked: field.value === option.value,
-						onChange: () => field.setValue(option.value),
-						onBlur: () => field.touch()
-					}), /* @__PURE__ */ jsx("label", {
-						htmlFor: optionId,
-						children: option.label
-					})]
-				}, option.value);
+			/* @__PURE__ */ jsx("span", {
+				"data-formancy-part": "file-name",
+				children: entry.name
 			}),
-			showError ? /* @__PURE__ */ jsx("p", {
-				"data-formancy-part": "error",
-				...field.errorProps,
-				children: field.errors.join(", ")
-			}) : null
+			entry.state === "waiting" ? /* @__PURE__ */ jsx("span", {
+				"data-formancy-part": "file-waiting",
+				children: "Waiting"
+			}) : null,
+			entry.state === "uploading" ? /* @__PURE__ */ jsx("progress", {
+				"data-formancy-part": "file-progress",
+				"aria-label": `Uploading ${entry.name}`,
+				...entry.total === void 0 ? {} : {
+					value: entry.sent,
+					max: entry.total
+				}
+			}) : null,
+			failed ? /* @__PURE__ */ jsxs("span", {
+				"data-formancy-part": "file-error",
+				children: ["Not attached: ", entry.reason]
+			}) : null,
+			failed ? /* @__PURE__ */ jsxs("button", {
+				type: "button",
+				disabled,
+				onClick: () => queue.retry(entry.key),
+				children: [
+					"Try ",
+					entry.name,
+					" again"
+				]
+			}) : null,
+			/* @__PURE__ */ jsx("button", {
+				type: "button",
+				disabled,
+				onClick: () => queue.cancel(entry.key),
+				children: failed ? `Dismiss ${entry.name}` : `Cancel uploading ${entry.name}`
+			})
 		]
 	});
 }
+/** What the status region says: the file being sent, or the files refused, by name. */
+function statusOf(pending) {
+	const sending = pending.find((entry) => entry.state === "uploading");
+	if (sending !== void 0) return `Uploading ${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(", ")}.`;
+	return "";
+}
 /**
-* Text the reader sees that collects nothing — a heading, an explanation, a
-* notice.
+* The field's upload queue — the form's, found by the row this control is drawn for,
+* so a row that moves and remounts its controls keeps its uploads (0130).
 *
-* Not a `<label>`, because there is no control for one to label, and a label
-* pointing at nothing is a label a screen reader announces as an orphan. Not a
-* heading element either: the spec does not say what level it would be, and
-* guessing produces a document outline that skips levels.
+* This control supplies only the sending: the host's uploader, given an
+* `AbortSignal` for the queue's cancel, which `@formancy/core` has no type for.
 */
-function StaticField({ label }) {
-	return /* @__PURE__ */ jsx("p", {
-		"data-formancy-part": "static",
-		children: label
-	});
+function useUploadQueue(wire, upload) {
+	const engine = useFormEngine();
+	const uploads = fieldUploads(engine, wire);
+	useEffect(() => {
+		uploads.sender = upload === void 0 ? void 0 : (file, attempt, field) => {
+			const controller = new AbortController();
+			attempt.onCancel(() => controller.abort());
+			return upload(file, {
+				field,
+				signal: controller.signal,
+				onProgress: (sent, total) => attempt.progress(sent, total)
+			});
+		};
+	}, [uploads, upload]);
+	return uploads.queue;
 }
 /**
-* Several answers from a list, every option visible at once.
+* A picture of an image picked in this session, drawn from its bytes.
 *
-* A `fieldset` with a `legend`, exactly like the radio group, because the
-* relationship is the same one: several controls that answer a single
-* question. What differs is only that more than one may be chosen, which is
-* `type="checkbox"` and an array — not a different structure and not a
-* different way of being announced.
+* **On a canvas, not an `<img>` on an object URL.** A URL is subject to the page's
+* `img-src`, and a strict policy without `blob:` shows a broken image — while this
+* product says a form runs under a strict CSP with no configuration. Decoding with
+* `createImageBitmap` and drawing the bitmap involves no URL at all.
 *
-* Requiring "at least one" is a property of the QUESTION, not of any one box,
-* so it belongs to the group — but not as `aria-required`, which
-* `role="group"` does not support and assistive technology therefore ignores.
-* It is announced through the group's description instead, which the engine
-* composes. Putting it on every box would announce each one as required,
-* which is the opposite of what it means.
+* Only for a file picked here: a file stored before this page has no bytes in the
+* browser, and the renderer knows no address to fetch them from. Decorative — the
+* name beside it is what is read out.
 */
-function SelectBoxesField({ path, label }) {
-	const field = useField(path);
-	const options = useResolvedOptions(field);
-	const showError = field.touched && field.errors.length > 0;
-	const chosen = Array.isArray(field.value) ? field.value : [];
-	const toggle = (value, on) => {
-		const next = options.map((option) => option.value).filter((candidate) => candidate === value ? on : chosen.includes(candidate));
-		field.setValue(next);
-	};
-	return /* @__PURE__ */ jsxs("fieldset", {
-		"data-formancy-part": "field",
-		"data-formancy-field-path": path,
-		"data-state": showError ? "invalid" : "valid",
-		"aria-describedby": field.controlProps["aria-describedby"],
-		children: [
-			/* @__PURE__ */ jsx("legend", {
-				"data-formancy-part": "label",
-				children: label
-			}),
-			/* @__PURE__ */ jsx(RequiredHint, { field }),
-			options.map((option) => {
-				const optionId = `${field.ids.control}:${option.value}`;
-				return /* @__PURE__ */ jsxs("span", {
-					"data-formancy-part": "checkbox-option",
-					children: [/* @__PURE__ */ jsx("input", {
-						type: "checkbox",
-						id: optionId,
-						name: field.controlProps.name,
-						value: option.value,
-						checked: chosen.includes(option.value),
-						disabled: field.disabled,
-						onChange: (event) => toggle(option.value, event.target.checked),
-						onBlur: () => field.touch()
-					}), /* @__PURE__ */ jsx("label", {
-						htmlFor: optionId,
-						children: option.label
-					})]
-				}, option.value);
-			}),
-			showError ? /* @__PURE__ */ jsx("p", {
-				"data-formancy-part": "error",
-				...field.errorProps,
-				children: field.errors.join(", ")
-			}) : null
-		]
+function FileThumbnail({ source }) {
+	const canvas = useRef(null);
+	const drawable = source !== void 0 && source.type.startsWith("image/") && typeof createImageBitmap === "function";
+	useEffect(() => {
+		if (!drawable) return;
+		let current = true;
+		createImageBitmap(source).then((bitmap) => {
+			const target = canvas.current;
+			if (current && target !== null) {
+				const { width, height } = thumbnailSize(bitmap.width, bitmap.height);
+				target.width = width;
+				target.height = height;
+				target.getContext("2d")?.drawImage(bitmap, 0, 0, target.width, target.height);
+			}
+			bitmap.close();
+		}, () => void 0);
+		return () => {
+			current = false;
+		};
+	}, [source, drawable]);
+	if (!drawable) return null;
+	return /* @__PURE__ */ jsx("canvas", {
+		ref: canvas,
+		"data-formancy-part": "file-thumbnail",
+		"aria-hidden": "true",
+		width: 0,
+		height: 0
 	});
 }
+//#endregion
+//#region src/fields/rich-text-field.tsx
+/**
+* The rich text control, over a stored grammar rather than HTML.
+*
+* One file per control, because a control changes for its own reasons.
+* These were one 2,154-line file — the largest in the repository.
+*/
 /**
 * Formatted text, written as the restricted markup the spec defines.
 *
@@ -1800,121 +1595,1210 @@ function RichTextField({ path, label }) {
 		]
 	});
 }
+//#endregion
+//#region src/fields/selectboxes-field.tsx
 /**
-* Attached files.
+* Many answers from a set, as checkboxes or as a tag picker.
 *
-* The control picks files; something else uploads them and reports back what
-* was stored. That split is the whole design: this package has no opinion
-* about where bytes go, which is what lets the same field work against local
-* disk, S3 or a customer's own service.
+* One file per control, because a control changes for its own reasons.
+* These were one 2,154-line file — the largest in the repository.
+*/
+/**
+* Several answers from a list, every option visible at once.
 *
-* Without an uploader the field is read-only and says so, rather than
-* pretending to accept a file it has nowhere to put.
+* A `fieldset` with a `legend`, exactly like the radio group, because the
+* relationship is the same one: several controls that answer a single
+* question. What differs is only that more than one may be chosen, which is
+* `type="checkbox"` and an array — not a different structure and not a
+* different way of being announced.
+*
+* Requiring "at least one" is a property of the QUESTION, not of any one box,
+* so it belongs to the group — but not as `aria-required`, which
+* `role="group"` does not support and assistive technology therefore ignores.
+* It is announced through the group's description instead, which the engine
+* composes. Putting it on every box would announce each one as required,
+* which is the opposite of what it means.
 */
-function FileField({ path, label }) {
+/** A `selectboxes` is chips when the author asked for them, tick boxes otherwise. */
+function SelectBoxesSwitch(props) {
+	return useField(props.path).def?.widget === "tagpicker" ? /* @__PURE__ */ jsx(TagPickerField, { ...props }) : /* @__PURE__ */ jsx(SelectBoxesField, { ...props });
+}
+/**
+* `widget: "tagpicker"` — several answers, narrowed by typing, shown as chips.
+*
+* A widget rather than a field type because the answer does not change: an array
+* of offered option values in the options' own order, which is what a
+* `selectboxes` stores without it. What changes is that a list too long to tick
+* through becomes usable, and that the list may come from the deployment.
+*
+* **The chips are a list, and each carries its own remove button named after the
+* answer it removes.** "Remove" three times over tells a screen reader user which
+* nothing, and a chip a pointer can add and only a pointer can take away is
+* WCAG 2.1.1 — the failure this pattern ships with more often than any other.
+*
+* The combobox half is the typeahead's, deliberately: the same roles, the same
+* keys and the same `narrowOptionsByLabel` from `@formancy/spec`, so the two
+* cannot come to fold case differently. What differs is that choosing does not
+* fill the box — it adds a chip and clears it, because the next answer is the
+* common case.
+*/
+function TagPickerField({ path, label }) {
 	const field = useField(path);
-	const upload = useUploader();
-	const files = Array.isArray(field.value) ? field.value : [];
-	const [busy, setBusy] = useState(false);
-	const [failure, setFailure] = useState(void 0);
-	const [over, setOver] = useState(false);
-	/**
-	* Attachments taken out of the answer but not yet forgotten.
-	*
-	* Held with the position they came from, so undoing puts a file BACK where it
-	* was rather than on the end — the order matters to somebody who numbered
-	* their attachments in a covering note.
-	*/
-	const [removed, setRemoved] = useState([]);
-	const accept = field.def.accept;
-	const multiple = field.def.maxItems === void 0 || field.def.maxItems > 1;
-	const onPick = async (picked) => {
-		if (picked === null || picked.length === 0 || upload === void 0) return;
-		setBusy(true);
-		setFailure(void 0);
-		const uploaded = [];
-		const refused = [];
-		for (const file of Array.from(picked)) try {
-			uploaded.push(await upload(file));
-		} catch (error) {
-			refused.push(`${file.name} (${error instanceof Error ? error.message : String(error)})`);
-		}
-		if (uploaded.length > 0) field.setValue([...files, ...uploaded]);
-		if (refused.length > 0) setFailure(refused.length === 1 ? `${refused[0]} was not attached.` : `${String(refused.length)} files were not attached: ${refused.join(", ")}.`);
-		setBusy(false);
-		field.touch();
+	const options = useResolvedOptions(field);
+	const chosen = Array.isArray(field.value) ? field.value.map(String) : [];
+	const [query, setQuery] = useState("");
+	const [open, setOpen] = useState(false);
+	const listboxId = `${field.ids.control}:listbox`;
+	const remaining = options.filter((option) => !chosen.includes(option.value));
+	const matches = narrowOptionsByLabel(remaining, query);
+	const expanded = open && matches.length > 0;
+	const add = (value) => {
+		const next = options.map((option) => option.value).filter((candidate) => candidate === value || chosen.includes(candidate));
+		field.setValue(next);
+		setQuery("");
+		setOpen(false);
 	};
-	return /* @__PURE__ */ jsxs(FieldShell, {
+	const remove = (value) => {
+		field.setValue(chosen.filter((candidate) => candidate !== value));
+	};
+	const labelFor = (value) => options.find((option) => option.value === value)?.label ?? value;
+	return /* @__PURE__ */ jsx(FieldShell, {
 		path,
 		field,
 		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."
-			}) : /* @__PURE__ */ jsx("div", {
-				"data-formancy-part": "file-dropzone",
-				...over ? { "data-state": "over" } : {},
-				onDragOver: (event) => {
-					event.preventDefault();
-					if (field.disabled || busy) return;
-					setOver(true);
-				},
-				onDragLeave: () => setOver(false),
-				onDrop: (event) => {
-					event.preventDefault();
-					setOver(false);
-					if (field.disabled || busy) return;
-					onPick(event.dataTransfer.files);
-				},
-				children: /* @__PURE__ */ jsx("input", {
+		children: /* @__PURE__ */ jsxs("div", {
+			"data-formancy-part": "tagpicker",
+			children: [chosen.length === 0 ? null : /* @__PURE__ */ jsx("ul", {
+				"data-formancy-part": "tagpicker-chips",
+				"aria-label": `${label}: chosen`,
+				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)}`,
+						onClick: () => remove(value),
+						children: "×"
+					})]
+				}, value))
+			}), /* @__PURE__ */ jsxs("div", {
+				"data-formancy-part": "tagpicker-anchor",
+				children: [/* @__PURE__ */ jsx("input", {
+					type: "text",
+					role: "combobox",
 					...field.controlProps,
-					type: "file",
-					multiple,
-					...accept === void 0 ? {} : { accept: accept.join(",") },
-					disabled: field.disabled || busy,
+					"data-formancy-part": "tagpicker-input",
+					autoComplete: "off",
+					"aria-expanded": expanded,
+					"aria-controls": listboxId,
+					"aria-autocomplete": "list",
+					value: query,
 					onChange: (event) => {
-						onPick(event.target.files);
-						event.target.value = "";
+						setQuery(event.target.value);
+						setOpen(true);
+					},
+					onClick: () => setOpen(true),
+					onKeyDown: (event) => {
+						if (event.key === "Escape") {
+							setOpen(false);
+							return;
+						}
+						if (event.key === "Enter" && expanded && matches[0] !== void 0) {
+							event.preventDefault();
+							add(matches[0].value);
+							return;
+						}
+						if (event.key === "Backspace" && query === "" && chosen.length > 0) remove(chosen[chosen.length - 1]);
+					},
+					onBlur: () => {
+						setOpen(false);
+						field.touch();
 					}
-				})
+				}), /* @__PURE__ */ jsx("ul", {
+					id: listboxId,
+					role: "listbox",
+					"aria-label": `${label} suggestions`,
+					"data-formancy-part": "tagpicker-listbox",
+					hidden: !expanded,
+					children: matches.map((option) => /* @__PURE__ */ jsx("li", {
+						role: "option",
+						"data-formancy-part": "tagpicker-option",
+						"aria-selected": false,
+						onMouseDown: (event) => event.preventDefault(),
+						onClick: () => add(option.value),
+						children: option.label
+					}, option.value))
+				})]
+			})]
+		})
+	});
+}
+function SelectBoxesField({ path, label }) {
+	const field = useField(path);
+	const options = useResolvedOptions(field);
+	const showError = field.touched && field.errors.length > 0;
+	const chosen = Array.isArray(field.value) ? field.value : [];
+	const toggle = (value, on) => {
+		const next = options.map((option) => option.value).filter((candidate) => candidate === value ? on : chosen.includes(candidate));
+		field.setValue(next);
+	};
+	return /* @__PURE__ */ jsxs("fieldset", {
+		"data-formancy-part": "field",
+		"data-formancy-field-path": path,
+		"data-state": showError ? "invalid" : "valid",
+		"aria-describedby": field.controlProps["aria-describedby"],
+		children: [
+			/* @__PURE__ */ jsx("legend", {
+				"data-formancy-part": "label",
+				children: label
 			}),
-			files.length === 0 && removed.length === 0 ? null : /* @__PURE__ */ jsxs("ul", {
-				"data-formancy-part": "file-list",
-				children: [files.map((file) => /* @__PURE__ */ jsxs("li", {
-					"data-formancy-part": "file-item",
-					children: [/* @__PURE__ */ jsx("span", { children: file.name }), /* @__PURE__ */ jsxs("button", {
-						type: "button",
+			/* @__PURE__ */ jsx(RequiredHint, { field }),
+			options.map((option) => {
+				const optionId = `${field.ids.control}:${option.value}`;
+				return /* @__PURE__ */ jsxs("span", {
+					"data-formancy-part": "checkbox-option",
+					children: [/* @__PURE__ */ jsx("input", {
+						type: "checkbox",
+						id: optionId,
+						name: field.controlProps.name,
+						value: option.value,
+						checked: chosen.includes(option.value),
 						disabled: field.disabled,
-						onClick: () => {
-							setRemoved((before) => [...before, {
-								at: files.findIndex((other) => other.id === file.id),
-								file
-							}]);
-							field.setValue(files.filter((other) => other.id !== file.id));
-						},
-						children: ["Remove ", file.name]
+						onChange: (event) => toggle(option.value, event.target.checked),
+						onBlur: () => field.touch()
+					}), /* @__PURE__ */ jsxs("label", {
+						htmlFor: optionId,
+						children: [/* @__PURE__ */ jsx(OptionPicture, { option }), option.label]
 					})]
-				}, file.id)), removed.map(({ at, file }) => /* @__PURE__ */ jsxs("li", {
-					"data-formancy-part": "file-item",
-					"data-state": "removed",
-					children: [/* @__PURE__ */ jsx("span", { children: file.name }), /* @__PURE__ */ jsxs("button", {
+				}, option.value);
+			}),
+			showError ? /* @__PURE__ */ jsx("p", {
+				"data-formancy-part": "error",
+				...field.errorProps,
+				children: field.errors.join(", ")
+			}) : null
+		]
+	});
+}
+//#endregion
+//#region src/fields/ranking-field.tsx
+/**
+* Options put in order ([0138](../../../../docs/decisions/0138-a-ranking-stores-the-order-chosen.md)).
+*
+* **Buttons, and no dragging.** A drag must have an equivalent that is not one (WCAG 2.2
+* SC 2.5.7), and once the buttons exist they are the control: a drag surface is a second
+* route a theme or a consumer may add over the same commands, not the first one.
+*
+* Two lists. The order so far, each option with buttons to move it up, move it down and
+* take it out; and the options not ranked yet, each a button that puts it at the end.
+* Every button is named after the option it acts on — "Move Tea up" — because a column of
+* identical "Up" buttons is a column a screen reader cannot tell apart.
+*
+* **It starts with nothing ranked.** The options' written order is the author's, and an
+* answer that began as it would submit the author's preference as the respondent's.
+*
+* **Focus follows the option.** After "Move Tea up" focus is on Tea's up button in its new
+* place, so moving something three places is three presses of one key; after ranking one,
+* focus moves to the next option still to rank, so ranking them all is a run of Enter.
+*/
+function RankingField({ path, label }) {
+	const field = useField(path);
+	const options = useResolvedOptions(field);
+	const showError = field.touched && field.errors.length > 0;
+	const order = Array.isArray(field.value) ? field.value.map(String) : [];
+	const ranked = order.flatMap((value) => options.filter((option) => option.value === value));
+	const unranked = options.filter((option) => !order.includes(option.value));
+	const buttonId = (action, value) => `${field.ids.control}:${action}:${value}`;
+	const focusAfter = useRef(null);
+	useLayoutEffect(() => {
+		const id = focusAfter.current;
+		if (id === null) return;
+		focusAfter.current = null;
+		document.getElementById(id)?.focus();
+	});
+	const reorder = (next, focus) => {
+		focusAfter.current = focus;
+		field.setValue(next);
+	};
+	const move = (value, by) => {
+		const from = order.indexOf(value);
+		const to = from + by;
+		if (from === -1 || to < 0 || to >= order.length) return;
+		const next = [...order];
+		next[from] = next[to];
+		next[to] = value;
+		reorder(next, buttonId(by === -1 ? "up" : "down", value));
+	};
+	const rank = (value) => {
+		const position = unranked.findIndex((option) => option.value === value);
+		const following = unranked[position + 1] ?? unranked[position - 1];
+		reorder([...order, value], following === void 0 ? buttonId("up", value) : buttonId("rank", following.value));
+	};
+	return /* @__PURE__ */ jsxs("fieldset", {
+		id: field.ids.control,
+		"data-formancy-part": "field",
+		"data-formancy-field-path": path,
+		"data-state": showError ? "invalid" : "valid",
+		"aria-describedby": field.controlProps["aria-describedby"],
+		disabled: field.disabled,
+		children: [
+			/* @__PURE__ */ jsx("legend", {
+				"data-formancy-part": "label",
+				children: label
+			}),
+			/* @__PURE__ */ jsx(RequiredHint, { field }),
+			ranked.length === 0 ? null : /* @__PURE__ */ jsx("ol", {
+				"data-formancy-part": "ranking-order",
+				"aria-label": `${label}: your order`,
+				children: ranked.map((option, index) => /* @__PURE__ */ jsxs("li", {
+					"data-formancy-part": "ranking-item",
+					children: [
+						/* @__PURE__ */ jsx("span", {
+							"data-formancy-part": "ranking-label",
+							children: option.label
+						}),
+						/* @__PURE__ */ jsx("button", {
+							type: "button",
+							id: buttonId("up", option.value),
+							"data-formancy-part": "ranking-up",
+							"aria-label": `Move ${option.label} up`,
+							"aria-disabled": index === 0 ? true : void 0,
+							onClick: () => move(option.value, -1),
+							onBlur: () => field.touch(),
+							children: "↑"
+						}),
+						/* @__PURE__ */ jsx("button", {
+							type: "button",
+							id: buttonId("down", option.value),
+							"data-formancy-part": "ranking-down",
+							"aria-label": `Move ${option.label} down`,
+							"aria-disabled": index === ranked.length - 1 ? true : void 0,
+							onClick: () => move(option.value, 1),
+							onBlur: () => field.touch(),
+							children: "↓"
+						}),
+						/* @__PURE__ */ jsx("button", {
+							type: "button",
+							id: buttonId("remove", option.value),
+							"data-formancy-part": "ranking-remove",
+							"aria-label": `Take ${option.label} out of the order`,
+							onClick: () => reorder(order.filter((value) => value !== option.value), buttonId("rank", option.value)),
+							onBlur: () => field.touch(),
+							children: "×"
+						})
+					]
+				}, option.value))
+			}),
+			unranked.length === 0 ? null : /* @__PURE__ */ jsx("ul", {
+				"data-formancy-part": "ranking-pool",
+				"aria-label": `${label}: not ranked yet`,
+				children: unranked.map((option) => /* @__PURE__ */ jsx("li", {
+					"data-formancy-part": "ranking-candidate",
+					children: /* @__PURE__ */ jsx("button", {
 						type: "button",
-						disabled: field.disabled,
-						onClick: () => {
-							setRemoved((before) => before.filter((other) => other.file.id !== file.id));
-							const next = [...files];
-							next.splice(Math.min(at, next.length), 0, file);
-							field.setValue(next);
-						},
-						children: ["Undo removing ", file.name]
+						id: buttonId("rank", option.value),
+						"data-formancy-part": "ranking-add",
+						"aria-label": `Rank ${option.label}`,
+						onClick: () => rank(option.value),
+						onBlur: () => field.touch(),
+						children: option.label
+					})
+				}, option.value))
+			}),
+			showError ? /* @__PURE__ */ jsx("p", {
+				"data-formancy-part": "error",
+				...field.errorProps,
+				children: field.errors.join(", ")
+			}) : null
+		]
+	});
+}
+//#endregion
+//#region src/fields/matrix-field.tsx
+/**
+* One question asked of several rows ([0139](../../../../docs/decisions/0139-a-matrix-answers-one-question-per-row.md)).
+*
+* **A group per row.** The matrix is a fieldset named by its label; each row is a fieldset
+* named by its row, holding a radio per column named by its column. That is a radio group
+* per row, which is exactly what each row is: arrow keys move within it, Tab moves to the
+* next, and every answer is reached by role and name. Not a `<table>` — its rows and
+* columns would be announced as data, and each radio would need a name made of two headers.
+* Looking like a grid is the theme's business, through the parts below.
+*
+* Each row's radios share a name of their own, so choosing in one row never clears another.
+*/
+function MatrixField({ path, label }) {
+	const field = useField(path);
+	const engine = useFormEngine();
+	const columns = useResolvedOptions(field);
+	const rows = (field.def?.rows ?? []).map((row) => ({
+		value: row.value,
+		label: engine.text(row.label) ?? row.value
+	}));
+	const showError = field.touched && field.errors.length > 0;
+	const answer = typeof field.value === "object" && field.value !== null && !Array.isArray(field.value) ? field.value : {};
+	const choose = (row, column) => {
+		field.setValue({
+			...answer,
+			[row]: column
+		});
+	};
+	return /* @__PURE__ */ jsxs("fieldset", {
+		id: field.ids.control,
+		"data-formancy-part": "field",
+		"data-formancy-field-path": path,
+		"data-state": showError ? "invalid" : "valid",
+		"aria-describedby": field.controlProps["aria-describedby"],
+		disabled: field.disabled,
+		children: [
+			/* @__PURE__ */ jsx("legend", {
+				"data-formancy-part": "label",
+				children: label
+			}),
+			/* @__PURE__ */ jsx(RequiredHint, { field }),
+			/* @__PURE__ */ jsx("div", {
+				"data-formancy-part": "matrix",
+				"data-columns": String(columns.length),
+				children: rows.map((row) => /* @__PURE__ */ jsxs("fieldset", {
+					"data-formancy-part": "matrix-row",
+					children: [/* @__PURE__ */ jsx("legend", {
+						"data-formancy-part": "matrix-row-label",
+						children: row.label
+					}), columns.map((column) => {
+						const id = `${field.ids.control}:${row.value}:${column.value}`;
+						return /* @__PURE__ */ jsxs("span", {
+							"data-formancy-part": "matrix-option",
+							children: [/* @__PURE__ */ jsx("input", {
+								type: "radio",
+								id,
+								name: `${field.controlProps.name}.${row.value}`,
+								value: column.value,
+								checked: answer[row.value] === column.value,
+								onChange: () => choose(row.value, column.value),
+								onBlur: () => field.touch()
+							}), /* @__PURE__ */ jsx("label", {
+								htmlFor: id,
+								children: column.label
+							})]
+						}, column.value);
 					})]
-				}, file.id))]
+				}, row.value))
 			}),
-			/* @__PURE__ */ jsx("p", {
-				role: "status",
-				"data-formancy-part": "file-status",
-				children: busy ? "Uploading…" : failure ?? ""
+			showError ? /* @__PURE__ */ jsx("p", {
+				"data-formancy-part": "error",
+				...field.errorProps,
+				children: field.errors.join(", ")
+			}) : null
+		]
+	});
+}
+//#endregion
+//#region src/fields/scale-fields.tsx
+/**
+* A rating and a slider: one number, two controls.
+*
+* Both are widgets on `number` and neither changes the answer
+* ([0104](../../../docs/decisions/0104-spec-4-opens-with-a-widget-not-a-type.md)),
+* so what is interesting here is the two ways a scale control goes wrong.
+*
+* **The keyboard.** Stars drawn as a row of buttons are a row of tab stops that
+* a screen reader announces as unrelated controls, with no sense that they form
+* a scale or that one is chosen. A rating is a **radio group**: one tab stop,
+* arrow keys along the scale, and the chosen value announced as "3 of 11". That
+* is not a concession to accessibility — it is what the control is.
+*
+* **The bounds.** A scale needs both ends, and the format cannot require them:
+* `min` and `max` are optional on every number field, and making them
+* conditional on a widget would mean a document that stops validating when
+* somebody changes presentation. So a field with no bounds falls back to the
+* ordinary number input rather than drawing a scale of 1–5 or 0–100 that the
+* author never wrote. A control that invents its own range is worse than one
+* that is plain.
+*/
+/** Every value on the scale, inclusive of both ends. */
+function scaleOf(min, max, step) {
+	const out = [];
+	for (let value = min; value <= max + step / 2; value += step) out.push(Math.round(value / step) * step);
+	return out;
+}
+/** Both ends, or nothing: the condition for drawing a scale at all. */
+function boundsOf(def) {
+	if (def.min === void 0 || def.max === void 0 || def.max <= def.min) return void 0;
+	return {
+		min: def.min,
+		max: def.max,
+		step: def.step !== void 0 && def.step > 0 ? def.step : 1
+	};
+}
+/**
+* Which control a `number` field gets.
+*
+* The same shape `selectboxes` uses for its tag picker: one switch per type, so
+* the registry keeps one entry and a widget cannot be registered independently
+* of the type it belongs to ([0065](../../../docs/decisions/0065-a-widget-is-authored-not-registered.md)).
+*/
+function NumberSwitch(props) {
+	const field = useField(props.path);
+	if (field.def?.widget === "rating") return /* @__PURE__ */ jsx(RatingField, { ...props });
+	if (field.def?.widget === "slider") return /* @__PURE__ */ jsx(SliderField, { ...props });
+	return /* @__PURE__ */ jsx(NumberFallback, { ...props });
+}
+function RatingField({ path, label }) {
+	const field = useField(path);
+	const bounds = boundsOf(field.def ?? {});
+	if (bounds === void 0) return /* @__PURE__ */ jsx(NumberFallback, {
+		path,
+		label
+	});
+	const { controlProps } = field;
+	const chosen = typeof field.value === "number" ? field.value : void 0;
+	return /* @__PURE__ */ jsx(FieldShell, {
+		path,
+		field,
+		label,
+		children: /* @__PURE__ */ jsx("div", {
+			...controlProps,
+			role: "radiogroup",
+			"aria-labelledby": field.ids.label,
+			"data-formancy-part": "rating",
+			children: scaleOf(bounds.min, bounds.max, bounds.step).map((value) => /* @__PURE__ */ jsxs("label", {
+				"data-formancy-part": "rating-step",
+				"data-chosen": value === chosen ? "true" : void 0,
+				children: [/* @__PURE__ */ jsx("input", {
+					type: "radio",
+					name: controlProps.id,
+					value,
+					checked: value === chosen,
+					onChange: () => field.setValue(value),
+					onBlur: () => field.touch()
+				}), /* @__PURE__ */ jsx("span", {
+					"data-formancy-part": "rating-label",
+					children: value
+				})]
+			}, value))
+		})
+	});
+}
+function SliderField({ path, label }) {
+	const field = useField(path);
+	const bounds = boundsOf(field.def ?? {});
+	if (bounds === void 0) return /* @__PURE__ */ jsx(NumberFallback, {
+		path,
+		label
+	});
+	const midpoint = bounds.min + (bounds.max - bounds.min) / 2;
+	const shown = typeof field.value === "number" ? field.value : midpoint;
+	return /* @__PURE__ */ jsx(FieldShell, {
+		path,
+		field,
+		label,
+		children: /* @__PURE__ */ jsxs("div", {
+			"data-formancy-part": "slider",
+			children: [/* @__PURE__ */ jsx("input", {
+				type: "range",
+				...field.controlProps,
+				min: bounds.min,
+				max: bounds.max,
+				step: bounds.step,
+				value: shown,
+				onChange: (event) => field.setValue(event.target.valueAsNumber),
+				onBlur: () => field.touch()
+			}), /* @__PURE__ */ jsx("span", {
+				"data-formancy-part": "slider-value",
+				"aria-hidden": "true",
+				children: shown
+			})]
+		})
+	});
+}
+/**
+* The ordinary number input, for a field whose bounds a scale cannot be drawn
+* from.
+*
+* A copy of `NumberField` rather than an import, and deliberately: importing it
+* would make `text-fields.tsx` and this file a cycle, and the duplication is six
+* lines of the most stable markup in the package. The thing that must not
+* diverge is what the field *stores*, and that is the engine's.
+*/
+function NumberFallback({ path, label }) {
+	const field = useField(path);
+	return /* @__PURE__ */ jsx(FieldShell, {
+		path,
+		field,
+		label,
+		children: /* @__PURE__ */ jsx("input", {
+			type: "number",
+			...field.controlProps,
+			value: typeof field.value === "number" ? field.value : "",
+			onChange: (event) => field.setValue(event.target.value === "" ? null : event.target.valueAsNumber),
+			onBlur: () => field.touch()
+		})
+	});
+}
+//#endregion
+//#region src/fields/signature-field.tsx
+/**
+* The signature control: a mark drawn, or a name typed.
+*
+* One file per control, because a control changes for its own reasons.
+* These were one 2,154-line file — the largest in the repository.
+*/
+/**
+* Sign here: draw a mark, or type your name.
+*
+* **Both routes are the feature, not a fallback and its apology.** Typing your
+* name is how most people sign most things, and it is the only route a keyboard
+* has — a field that offered drawing alone would be a WCAG 2.1.1 failure with a
+* legal signature attached to it. So the two sit side by side and the last one
+* used is the answer; they are never both present, because a reader choosing
+* between them is a signed document that renders differently depending on the
+* choice.
+*
+* **SVG, not canvas.** A canvas answer would be pixels, and this stores points
+* ([0083](../../../docs/decisions/0083-a-signature-is-points-or-a-name.md)):
+* points scale, diff, survive a re-render and mean something to a reader that is
+* not a browser. Drawing them as an SVG path costs nothing extra and makes the
+* mark visible to anything that can read the DOM, including a test.
+*
+* **No stroke timing.** Velocity is what makes a signature biometric, and
+* biometric data is a category (GDPR Article 9) nothing here is equipped to
+* hold.
+*/
+function SignatureField({ path, label }) {
+	const field = useField(path);
+	const answer = typeof field.value === "object" && field.value !== null ? field.value : {};
+	const drawn = answer.drawn ?? [];
+	const [width, height] = field.def?.box ?? [600, 200];
+	const surface = useRef(null);
+	const stroke = useRef(null);
+	/**
+	* The strokes finished before this one started.
+	*
+	* Held rather than read back from the value, which is what the first version
+	* did — and the value already contains the stroke in progress, so every move
+	* appended another one. A signature drawn in the playground came out as forty
+	* strokes of a single point each; the unit tests moved once per stroke, which
+	* is the one shape that cannot show it.
+	*/
+	const before = useRef([]);
+	/**
+	* A client point in the field's own coordinate space, rounded to whole numbers.
+	*
+	* Whole numbers because the canonical hash a submission is bound to must not
+	* depend on how a browser rounded a pointer event. Clamped, because a pointer
+	* that leaves the box mid-stroke would otherwise record a point the engine
+	* refuses — the answer being invalid is the right outcome for a hand-written
+	* payload and the wrong one for somebody whose hand went past the edge.
+	*/
+	const pointFrom = (event) => {
+		const rect = surface.current?.getBoundingClientRect();
+		const scaleX = rect === void 0 || rect.width === 0 ? 1 : width / rect.width;
+		const scaleY = rect === void 0 || rect.height === 0 ? 1 : height / rect.height;
+		const x = (event.clientX - (rect?.left ?? 0)) * scaleX;
+		const y = (event.clientY - (rect?.top ?? 0)) * scaleY;
+		return [Math.max(0, Math.min(width, Math.round(x))), Math.max(0, Math.min(height, Math.round(y)))];
+	};
+	const commit = (strokes) => {
+		field.setValue(strokes.length === 0 ? null : { drawn: strokes });
+	};
+	const preventsScroll = { touchAction: "none" };
+	useEffect(() => {
+		const element = surface.current;
+		if (element === null) return;
+		const swallow = (event) => {
+			if (event.cancelable) event.preventDefault();
+		};
+		element.addEventListener("touchstart", swallow, { passive: false });
+		element.addEventListener("touchmove", swallow, { passive: false });
+		return () => {
+			element.removeEventListener("touchstart", swallow);
+			element.removeEventListener("touchmove", swallow);
+		};
+	}, []);
+	const onPointerDown = (event) => {
+		before.current = drawn;
+		stroke.current = [pointFrom(event)];
+		surface.current?.setPointerCapture?.(event.pointerId);
+	};
+	const onPointerMove = (event) => {
+		if (stroke.current === null) return;
+		stroke.current = [...stroke.current, pointFrom(event)];
+		commit([...before.current, stroke.current]);
+	};
+	const onPointerUp = () => {
+		const finished = stroke.current;
+		if (finished === null) return;
+		stroke.current = null;
+		if (finished.length < 2) commit(before.current);
+	};
+	return /* @__PURE__ */ jsx(FieldShell, {
+		path,
+		field,
+		label,
+		children: /* @__PURE__ */ jsxs("div", {
+			"data-formancy-part": "signature",
+			children: [
+				/* @__PURE__ */ jsx("svg", {
+					ref: surface,
+					"data-formancy-part": "signature-surface",
+					style: preventsScroll,
+					viewBox: `0 0 ${String(width)} ${String(height)}`,
+					role: "img",
+					"aria-label": label,
+					onPointerDown,
+					onPointerMove,
+					onPointerUp,
+					onPointerLeave: onPointerUp,
+					children: drawn.map((points, at) => /* @__PURE__ */ jsx("path", {
+						"data-formancy-part": "signature-stroke",
+						d: points.map(([x, y], step) => `${step === 0 ? "M" : "L"}${String(x)} ${String(y)}`).join(" "),
+						fill: "none"
+					}, at))
+				}),
+				/* @__PURE__ */ jsx("input", {
+					"data-formancy-part": "signature-typed",
+					type: "text",
+					value: answer.typed ?? "",
+					"aria-label": "Type your name",
+					onChange: (event) => {
+						const typed = event.target.value;
+						field.setValue(typed === "" ? null : { typed });
+					},
+					onBlur: field.touch
+				}),
+				/* @__PURE__ */ jsx("button", {
+					"data-formancy-part": "signature-clear",
+					type: "button",
+					onClick: () => {
+						stroke.current = null;
+						before.current = [];
+						field.setValue(null);
+					},
+					children: "Clear"
+				})
+			]
+		})
+	});
+}
+//#endregion
+//#region src/fields/static-field.tsx
+/**
+* Text the reader sees that collects nothing.
+*
+* One file per control, because a control changes for its own reasons.
+* These were one 2,154-line file — the largest in the repository.
+*/
+/**
+* Text the reader sees that collects nothing — a heading, an explanation, a
+* notice.
+*
+* Not a `<label>`, because there is no control for one to label, and a label
+* pointing at nothing is a label a screen reader announces as an orphan. Not a
+* 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 }) {
+	return /* @__PURE__ */ jsx("p", {
+		"data-formancy-part": "static",
+		children: label
+	});
+}
+//#endregion
+//#region src/fields/temporal-fields.tsx
+/**
+* The temporal controls, each holding one canonical fixed-width string.
+*
+* One file per control, because a control changes for its own reasons.
+* These were one 2,154-line file — the largest in the repository.
+*/
+function DateField({ path, label }) {
+	const field = useField(path);
+	return /* @__PURE__ */ jsx(FieldShell, {
+		path,
+		field,
+		label,
+		children: /* @__PURE__ */ jsx("input", {
+			type: "date",
+			...field.controlProps,
+			value: typeof field.value === "string" ? field.value : "",
+			onChange: (event) => field.setValue(event.target.value === "" ? null : event.target.value),
+			onBlur: () => field.touch()
+		})
+	});
+}
+/**
+* A time of day, as `HH:MM`.
+*
+* `<input type="time">` gives the platform's own picker, its own keyboard handling
+* and its own locale display — a 12-hour clock where the reader expects one — while
+* its `value` is always `HH:MM` on a 24-hour clock. That is exactly the split the
+* format wants: the reader sees their convention, the answer records one canonical
+* shape.
+*
+* `step` is not set, so the browser offers no seconds. A time answer has none, and a
+* control offering a precision the format discards is a control that loses what
+* somebody typed.
+*/
+function TimeField({ path, label }) {
+	const field = useField(path);
+	return /* @__PURE__ */ jsx(FieldShell, {
+		path,
+		field,
+		label,
+		children: /* @__PURE__ */ jsx("input", {
+			type: "time",
+			...field.controlProps,
+			...typeof field.def.earliest === "string" ? { min: field.def.earliest } : {},
+			...typeof field.def.latest === "string" ? { max: field.def.latest } : {},
+			value: typeof field.value === "string" ? field.value : "",
+			onChange: (event) => field.setValue(event.target.value === "" ? null : event.target.value),
+			onBlur: () => field.touch()
+		})
+	});
+}
+/**
+* An instant, stored as `YYYY-MM-DDTHH:MM:SSZ`.
+*
+* `<input type="datetime-local">` because there is no zoned datetime input in any
+* browser — so the control shows the reader a local wall clock and this converts.
+* The conversion is the whole reason this component exists rather than reusing
+* `DateField`:
+*
+* - **In:** the control gives `YYYY-MM-DDTHH:MM` in the reader's own zone. `new
+*   Date(local).toISOString()` interprets a zoneless string as local time, which is
+*   what is wanted here and is exactly what `bindTimestamp` refuses for a stored
+*   value — the difference is that the reader's zone is known at the moment they
+*   type, and is not knowable later.
+* - **Out:** the stored instant is rendered back into local time for the control,
+*   sliced to minutes because the input rejects a seconds component it was not asked
+*   for.
+*
+* Seconds are therefore always `00` in an answer a person typed. The format keeps
+* them because a machine-supplied answer has them and a fixed width is what makes
+* ordering work.
+*/
+function DateTimeField({ path, label }) {
+	const field = useField(path);
+	const stored = typeof field.value === "string" ? field.value : "";
+	const asLocal = () => {
+		if (stored === "") return "";
+		const instant = new Date(stored);
+		if (Number.isNaN(instant.getTime())) return "";
+		const pad = (part) => String(part).padStart(2, "0");
+		return `${String(instant.getFullYear())}-${pad(instant.getMonth() + 1)}-${pad(instant.getDate())}T${pad(instant.getHours())}:${pad(instant.getMinutes())}`;
+	};
+	return /* @__PURE__ */ jsx(FieldShell, {
+		path,
+		field,
+		label,
+		children: /* @__PURE__ */ jsx("input", {
+			type: "datetime-local",
+			...field.controlProps,
+			value: asLocal(),
+			onChange: (event) => {
+				const local = event.target.value;
+				if (local === "") {
+					field.setValue(null);
+					return;
+				}
+				const instant = new Date(local);
+				field.setValue(Number.isNaN(instant.getTime()) ? null : `${instant.toISOString().slice(0, 19)}Z`);
+			},
+			onBlur: () => field.touch()
+		})
+	});
+}
+//#endregion
+//#region src/fields/text-fields.tsx
+/**
+* The controls that take typed text, and the widgets over them.
+*
+* One file per control, because a control changes for its own reasons.
+* These were one 2,154-line file — the largest in the repository.
+*/
+/**
+* A single-line answer, and — with `widget: "scanner"` — a camera route to the same
+* string.
+*
+* The input is the control in both cases, never a second one beside it: typing is
+* the accessibility floor and the fallback at once, so it is what is always there
+* and the scan button is what is sometimes added. With no scanner supplied the
+* markup is the default control exactly, because a Scan button that opens nothing is
+* worse than no button ([0071](../../../docs/decisions/0071-a-scanner-is-supplied-not-built.md)).
+*/
+function TextField({ path, label }) {
+	const field = useField(path);
+	const scan = useScanner();
+	const [scanning, setScanning] = useState(false);
+	/** A device failure, held here rather than in the field's errors. See below. */
+	const [trouble, setTrouble] = useState(void 0);
+	/**
+	* The ONE place a text field's answer is written, typed or scanned.
+	*
+	* Structural rather than careful: the parameter is a `string`, so there is no path
+	* from the camera to `setValue` that could store something typing could not. That
+	* is the line a widget may never cross — it changes how a field looks, never what
+	* it collects ([0065](../../../docs/decisions/0065-a-widget-is-authored-not-registered.md)).
+	*/
+	const commit = (text) => field.setValue(text.replace(/[\r\n]/g, ""));
+	const mask = field.def.mask;
+	const answer = typeof field.value === "string" ? field.value : "";
+	const shown = mask === void 0 ? answer : formatMasked(mask, answer);
+	const read = async () => {
+		if (scan === void 0 || scanning) return;
+		setScanning(true);
+		setTrouble(void 0);
+		try {
+			const text = await scan({
+				label,
+				path
+			});
+			if (text === null) return;
+			if (typeof text !== "string") {
+				setTrouble("Scanning did not work: the scanner did not return text. Type the value instead.");
+				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.`);
+		} finally {
+			setScanning(false);
+		}
+	};
+	return /* @__PURE__ */ jsxs(FieldShell, {
+		path,
+		field,
+		label,
+		children: [/* @__PURE__ */ jsx("input", {
+			type: "text",
+			...field.controlProps,
+			value: shown,
+			placeholder: mask === void 0 ? void 0 : maskPlaceholder(mask),
+			inputMode: mask !== void 0 && maskIsNumeric(mask) ? "numeric" : void 0,
+			onChange: (event) => {
+				if (mask === void 0) {
+					commit(event.target.value);
+					return;
+				}
+				const input = event.target;
+				const forward = event.nativeEvent.inputType === "deleteContentForward";
+				const edit = editMasked(mask, answer, input.value, {
+					caret: input.selectionStart,
+					direction: forward ? "forward" : "backward"
+				});
+				input.value = formatMasked(mask, edit.answer);
+				input.setSelectionRange(edit.caret, edit.caret);
+				commit(edit.answer);
+			},
+			onBlur: () => field.touch()
+		}), field.def.widget === "scanner" && scan !== void 0 ? /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsxs("button", {
+			type: "button",
+			"data-formancy-part": "scanner-button",
+			disabled: field.disabled,
+			"aria-busy": scanning ? true : void 0,
+			onClick: () => {
+				read();
+			},
+			children: ["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 ?? ""
+		})] }) : null]
+	});
+}
+function TextareaField({ path, label }) {
+	const field = useField(path);
+	return /* @__PURE__ */ jsx(FieldShell, {
+		path,
+		field,
+		label,
+		children: /* @__PURE__ */ jsx("textarea", {
+			...field.controlProps,
+			value: typeof field.value === "string" ? field.value : "",
+			onChange: (event) => field.setValue(event.target.value),
+			onBlur: () => field.touch()
+		})
+	});
+}
+//#endregion
+//#region src/form.tsx
+/**
+* The form, the list that walks it, and which component renders which type.
+*
+* What is left after the controls moved into `fields/`: 2,154 lines that had
+* become the place things went. Three subjects remain here and they are one —
+* a form renders a list, a list renders a slot, a slot may render a repeater,
+* and a repeater renders a list. Mutual recursion is not a seam.
+*
+* `null` in the map is not an omission. `hidden` renders nothing by design, and
+* `group`, `page` and `repeater` are containers the list itself walks rather
+* than controls.
+*/
+/**
+* Renders the whole form from the engine: one slot per field, resolved through
+* the registry. Slots subscribe individually, so a keystroke re-renders one
+* field and a visibility flip mounts or unmounts exactly the fields it hit.
+* A paged schema renders a stepper, one page at a time, navigation, and the
+* submit control on the last page — a failed submit navigates to the first
+* page with a problem instead of leaving the user on a clean review page
+* staring at a rejection.
+*/
+function FormancyForm(props) {
+	return useFormEngine().wizard() === void 0 ? /* @__PURE__ */ jsx(FlatForm, { ...props }) : /* @__PURE__ */ jsx(PagedForm, { ...props });
+}
+function SubmitButton({ submitLabel, onSubmit, onFailedNavigate }) {
+	const engine = useFormEngine();
+	const submit = useSubmit();
+	return /* @__PURE__ */ jsx("button", {
+		type: "button",
+		"data-formancy-part": "submit",
+		onClick: () => {
+			const outcome = submit();
+			if (!outcome.ok && onFailedNavigate !== void 0) {
+				const firstInvalid = engine.firstInvalid();
+				if (firstInvalid !== null) onFailedNavigate(engine.pageOf(parsePath(firstInvalid)));
+			}
+			onSubmit?.(outcome.ok ? {
+				ok: true,
+				errors: outcome.errors,
+				data: engine.value()
+			} : {
+				ok: false,
+				errors: outcome.errors
+			});
+		},
+		children: submitLabel ?? "Submit"
+	});
+}
+function FlatForm(props) {
+	return /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx(FieldList, { ...props }), /* @__PURE__ */ jsx(SubmitButton, { ...props })] });
+}
+function PagedForm(props) {
+	const engine = useFormEngine();
+	const wizard = useWizard();
+	const pages = engine.pages().map((page, index) => ({
+		...page,
+		index
+	})).filter((page) => !page.skipped);
+	return /* @__PURE__ */ jsxs(Fragment$1, { children: [
+		/* @__PURE__ */ jsx("nav", {
+			"data-formancy-part": "stepper",
+			"aria-label": "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
+			}, page.key)) })
+		}),
+		/* @__PURE__ */ jsx(FieldList, {
+			...props,
+			page: wizard.page
+		}),
+		/* @__PURE__ */ jsxs("div", {
+			"data-formancy-part": "wizard-nav",
+			children: [wizard.canGoBack ? /* @__PURE__ */ jsx("button", {
+				type: "button",
+				onClick: () => wizard.back(),
+				children: "Back"
+			}) : null, wizard.canGoNext ? /* @__PURE__ */ jsx("button", {
+				type: "button",
+				onClick: () => void wizard.next(),
+				children: "Next"
+			}) : /* @__PURE__ */ jsx(SubmitButton, {
+				...props,
+				onFailedNavigate: (page) => wizard.goTo(page)
+			})]
+		})
+	] });
+}
+function FieldList({ labels, registry, page, layout }) {
+	const engine = useFormEngine();
+	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) => engine.pageOf(parsePath(path)) === page,
+			renderField: (path) => {
+				if (repeaterWires.includes(path)) return /* @__PURE__ */ jsx(RepeaterSection, {
+					wire: path,
+					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, {
+		path: wire,
+		fallbackLabel: labels?.[wire],
+		registry
+	}, wire)), repeaterWires.filter(inPage).map((wire) => /* @__PURE__ */ jsx(RepeaterSection, {
+		wire,
+		labels,
+		registry
+	}, wire))] });
+}
+function FieldSlot({ path, fallbackLabel, registry }) {
+	const field = useField(path);
+	if (!field.visible) return null;
+	const Component = registry?.byPath?.[path] ?? registry?.byType?.[field.type] ?? DEFAULT_COMPONENTS[field.type];
+	if (Component === null) return null;
+	const label = field.label ?? fallbackLabel ?? path;
+	return /* @__PURE__ */ jsx(Component, {
+		path,
+		label
+	});
+}
+function RepeaterSection({ wire, labels, registry }) {
+	const engine = useFormEngine();
+	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 fallbackFor = (instanceWire) => {
+		const template = instanceWire.replace(/\[\d+\]/, "[]");
+		return labels?.[template] ?? labels?.[instanceWire];
+	};
+	const grid = def?.widget === "datagrid";
+	const declaredColumns = def?.columns ?? [];
+	const plan = grid ? datagridColumns(def, declaredColumns) : [];
+	const tracks = declaredColumns.some((column) => column.width !== void 0) ? plan.map(({ column }) => column?.width === void 0 ? "1fr" : `${String(column.width)}fr`).join(" ") : void 0;
+	/** The control in one cell: the leaf the column's child field collects into.
+	*
+	*  One leaf, because a grid's rows are FLAT -- a child holding fields of its own is
+	*  refused when the document is saved
+	*  ([0078](../../../docs/decisions/0078-a-grid-row-is-flat.md)). This walked the whole
+	*  subtree under the child while a group could be a column, and every clause that made
+	*  that walk safe is gone with the arrangement it served.
+	*
+	*  Still a filter over the paths that EXIST rather than the path the column implies, so
+	*  a document nobody validated renders an empty cell instead of asking the engine about
+	*  a field it does not have. */
+	const leavesOf = (index, key) => {
+		const wanted = `${wire}[${String(index)}].${key}`;
+		return engine.fieldPaths().filter((leaf) => leaf === wanted);
+	};
+	/** A column's visible heading: the author's shortening, else the child's own label,
+	*  else the labels prop, else the key.
+	*
+	*  Visible text and NOTHING else -- never an `id` target, never an `aria-label`.
+	*  Measured against the accessible-name implementation this repository installs: a
+	*  column heading contributes nothing to the name of a control in its column, whether
+	*  it is a `<th scope="col">` or a `headers=` target. So the heading cannot replace a
+	*  cell's label, and pointing a control at it would only ADD the heading to the name --
+	*  which is the failure 0066 separates `header` from `label` to prevent. */
+	const headingOf = (entry) => engine.text(entry.column?.header) ?? engine.text(entry.child?.label) ?? fallbackFor(`${wire}[0].${entry.key}`) ?? entry.key;
+	/** A row's own controls, identical in both arrangements down to the names, because
+	*  0068 put the row's position in those names and a grid does not change where a person
+	*  is.
+	*
+	*  The text sits in its own element so a THEME can clip it and draw a mark instead,
+	*  which is what a grid wants -- "Remove recipient 1 of 1" on three wrapped lines took
+	*  more room than the answers beside it, measured in the playground. Clipped and never
+	*  removed: `display: none` and `visibility: hidden` both compute the button's name to
+	*  the empty string, and a button called nothing is worse than a wide one.
+	*
+	*  The renderer draws no mark of its own. An icon is appearance, appearance belongs to
+	*  the consumer ([0004](../../../docs/decisions/0004-headless-core.md)), and a renderer
+	*  that shipped a glyph would be choosing one for every design system at once. */
+	const rowButtons = (index) => /* @__PURE__ */ jsxs(Fragment$1, { children: [
+		/* @__PURE__ */ jsx("button", {
+			type: "button",
+			"data-formancy-part": "row-remove",
+			onClick: () => repeater.removeRow(index),
+			children: /* @__PURE__ */ jsx("span", {
+				"data-formancy-part": "row-action-text",
+				children: `${removeLabel} ${index + 1} of ${repeater.rowCount}`
+			})
+		}),
+		index > 0 ? /* @__PURE__ */ jsx("button", {
+			type: "button",
+			"data-formancy-part": "row-up",
+			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`
+			})
+		}) : null,
+		index < repeater.rowCount - 1 ? /* @__PURE__ */ jsx("button", {
+			type: "button",
+			"data-formancy-part": "row-down",
+			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`
+			})
+		}) : null
+	] });
+	/** One control in a row.
+	*
+	*  Keyed by the POSITIONAL WIRE, so every control in a row is remounted when the row
+	*  moves and focus is lost on a reorder. Keying by the field's key within the row fixes
+	*  that here, and was reverted to keep the two renderers identical: the same change in
+	*  Angular lets it REUSE a component whose path is read once in ngOnInit, so after a
+	*  removal it binds to the old wire and shows the wrong row's answer -- caught by a
+	*  conformance fixture. One renderer keeping focus and the other not is the
+	*  framework-specific divergence this architecture exists to prevent, so both wait for
+	*  reactive path binding in Angular. */
+	const slot = (instanceWire) => /* @__PURE__ */ jsx(FieldSlot, {
+		path: instanceWire,
+		fallbackLabel: fallbackFor(instanceWire),
+		registry
+	}, instanceWire);
+	const rows = repeater.rowIds.map((rowId, index) => grid ? /* @__PURE__ */ jsxs("div", {
+		"data-formancy-part": "datagrid-row",
+		children: [plan.map((entry) => /* @__PURE__ */ jsx("div", {
+			"data-formancy-part": "datagrid-cell",
+			...entry.column?.align === void 0 ? {} : { "data-align": entry.column.align },
+			children: leavesOf(index, entry.key).map(slot)
+		}, entry.key)), /* @__PURE__ */ jsx("div", {
+			"data-formancy-part": "datagrid-actions",
+			children: rowButtons(index)
+		})]
+	}, rowId) : /* @__PURE__ */ jsxs("div", {
+		"data-formancy-part": "row",
+		children: [engine.fieldPaths().filter((candidate) => candidate.startsWith(`${wire}[${String(index)}]`)).map(slot), rowButtons(index)]
+	}, rowId));
+	return /* @__PURE__ */ jsxs("fieldset", {
+		"data-formancy-part": "repeater",
+		children: [
+			/* @__PURE__ */ jsx("legend", {
+				"data-formancy-part": "repeater-legend",
+				children: label
+			}),
+			grid ? /* @__PURE__ */ jsxs("div", {
+				"data-formancy-part": "datagrid",
+				"data-columns": String(plan.length),
+				...tracks === void 0 ? {} : { style: { "--fm-datagrid-columns": tracks } },
+				children: [repeater.rowCount > 0 ? /* @__PURE__ */ jsx("div", {
+					"data-formancy-part": "datagrid-head",
+					children: plan.map((entry) => /* @__PURE__ */ jsx("span", {
+						"data-formancy-part": "datagrid-heading",
+						...entry.column?.align === void 0 ? {} : { "data-align": entry.column.align },
+						children: headingOf(entry)
+					}, entry.key))
+				}) : null, rows]
+			}) : rows,
+			/* @__PURE__ */ jsx("button", {
+				type: "button",
+				onClick: () => repeater.addRow(),
+				children: addLabel
 			})
 		]
 	});
@@ -1928,16 +2812,19 @@ function FileField({ path, label }) {
 const DEFAULT_COMPONENTS = {
 	text: TextField,
 	textarea: TextareaField,
-	number: NumberField,
+	number: NumberSwitch,
 	checkbox: CheckboxField,
 	date: DateField,
 	time: TimeField,
 	datetime: DateTimeField,
 	select: SelectField,
 	radio: RadioGroupField,
-	selectboxes: SelectBoxesField,
+	selectboxes: SelectBoxesSwitch,
+	ranking: RankingField,
+	matrix: MatrixField,
 	file: FileField,
 	richtext: RichTextField,
+	signature: SignatureField,
 	hidden: null,
 	static: StaticField,
 	group: null,
@@ -1967,7 +2854,7 @@ function ErrorSummary({ labels }) {
 		previousCount.current = errors.length;
 	}, [errors]);
 	if (errors.length === 0) return null;
-	const labelFor = (path) => labels?.[path] ?? labels?.[path.replace(/\[\d+\]/, "[]")] ?? path;
+	const labelFor = (path) => labels?.[path] ?? labels?.[path.replace(/\[\d+\]/, "[]")] ?? engine.getFieldSnapshot(parsePath(path)).label ?? path;
 	return /* @__PURE__ */ jsxs("div", {
 		"data-formancy-part": "error-summary",
 		tabIndex: -1,