@formancy/react 0.8.0 → 0.9.0

package/dist/index.d.mts

@@ -109,6 +109,16 @@ export declare function useSubmit(): () => {
   errors: Record<string, string[]>;
 };
 //#endregion
+//#region src/go-to-field.d.ts
+/**
+ * Take the person to a question: to its page first, on a paged form, and to its control once
+ * that page is drawn — into a group's first option, since a fieldset takes no focus, and past a
+ * tab a layout hides it behind (0213). What the error summary's links and the review's Change do,
+ * one function for both and for a host's own list of questions; the Angular binding's
+ * `injectGoToField` is the same. A path no field has throws, as the engine does for one.
+ */
+export declare function useGoToField(): (path: string) => void;
+//#endregion
 //#region src/fields/internals.d.ts
 /**
  * The pieces every control shares: the shell it renders inside, the prop shapes, and the few helpers more than one of them needs.

package/dist/index.d.mts.map

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

package/dist/index.mjs

@@ -143,6 +143,24 @@ function useSubmit() {
 	}, [engine]);
 }
 //#endregion
+//#region src/go-to-field.ts
+function useGoToField() {
+	const engine = useFormEngine();
+	const [focusing, setFocusing] = useState(void 0);
+	useEffect(() => {
+		if (focusing === void 0) return;
+		focusControl(document.getElementById(focusing.id));
+		setFocusing(void 0);
+	}, [focusing]);
+	return useCallback((path) => {
+		const at = parsePath(path);
+		const wizard = engine.wizard();
+		const page = engine.pageOf(at);
+		if (wizard !== void 0 && wizard.page() !== page) wizard.goTo(page);
+		setFocusing({ id: engine.getFieldSnapshot(at).ids.control });
+	}, [engine]);
+}
+//#endregion
 //#region src/layout.tsx
 function LayoutTree({ schema, nodes, locale, renderField, at = [], shows }) {
 	return /* @__PURE__ */ jsx(Fragment$1, { children: nodes.map((node, index) => {
@@ -396,12 +414,7 @@ function useReview(goTo) {
 	const engine = useFormEngine();
 	const submit = useSubmit();
 	const [reviewing, setReviewing] = useState(false);
-	const [focusing, setFocusing] = useState(void 0);
-	useEffect(() => {
-		if (focusing === void 0) return;
-		focusControl(document.getElementById(focusing));
-		setFocusing(void 0);
-	}, [focusing]);
+	const goToField = useGoToField();
 	return {
 		reviewing,
 		check() {
@@ -411,8 +424,7 @@ function useReview(goTo) {
 		},
 		change(answer) {
 			setReviewing(false);
-			goTo?.(answer.page);
-			setFocusing(answer.controlId);
+			goToField(answer.field);
 		}
 	};
 }
@@ -1008,6 +1020,7 @@ function RadioGroupField({ path, label }) {
 						name: field.controlProps.name,
 						value: option.value,
 						checked: field.value === option.value,
+						disabled: field.disabled,
 						onChange: () => field.setValue(option.value),
 						onBlur: () => field.touch()
 					}), /* @__PURE__ */ jsxs("label", {
@@ -1817,6 +1830,7 @@ function RatingField({ path, label }) {
 					name: controlProps.id,
 					value,
 					checked: value === chosen,
+					disabled: field.disabled,
 					onChange: () => field.setValue(value),
 					onBlur: () => field.touch()
 				}), /* @__PURE__ */ jsx("span", {
@@ -1915,12 +1929,13 @@ function SignatureField({ path, label }) {
 		};
 	}, []);
 	const onPointerDown = (event) => {
+		if (field.disabled) return;
 		before.current = drawn;
 		stroke.current = [pointFrom(event)];
 		surface.current?.setPointerCapture?.(event.pointerId);
 	};
 	const onPointerMove = (event) => {
-		if (stroke.current === null) return;
+		if (stroke.current === null || field.disabled) return;
 		stroke.current = [...stroke.current, pointFrom(event)];
 		commit([...before.current, stroke.current]);
 	};
@@ -1944,6 +1959,7 @@ function SignatureField({ path, label }) {
 					viewBox: `0 0 ${String(width)} ${String(height)}`,
 					role: "img",
 					"aria-label": label,
+					"aria-disabled": field.disabled ? true : void 0,
 					onPointerDown,
 					onPointerMove,
 					onPointerUp,
@@ -1955,11 +1971,11 @@ function SignatureField({ path, label }) {
 					}, at))
 				}),
 				/* @__PURE__ */ jsx("input", {
-					id: field.ids.control,
+					...field.controlProps,
 					"data-formancy-part": "signature-typed",
 					type: "text",
 					value: answer.typed ?? "",
-					"aria-label": text("signature.typed"),
+					"aria-label": text("signature.typed", { label }),
 					onChange: (event) => {
 						const typed = event.target.value;
 						field.setValue(typed === "" ? null : { typed });
@@ -1969,6 +1985,7 @@ function SignatureField({ path, label }) {
 				/* @__PURE__ */ jsx("button", {
 					"data-formancy-part": "signature-clear",
 					type: "button",
+					disabled: field.disabled,
 					onClick: () => {
 						stroke.current = null;
 						before.current = [];
@@ -2508,12 +2525,7 @@ function ErrorSummary({ labels }) {
 	const errors = useSyncExternalStore(subscribe, getErrors, getErrors);
 	const region = useRef(null);
 	const previousCount = useRef(0);
-	const [focusing, setFocusing] = useState(void 0);
-	useEffect(() => {
-		if (focusing === void 0) return;
-		focusControl(document.getElementById(focusing));
-		setFocusing(void 0);
-	}, [focusing]);
+	const goToField = useGoToField();
 	useEffect(() => {
 		if (errors.length > 0 && previousCount.current === 0) region.current?.focus();
 		previousCount.current = errors.length;
@@ -2534,10 +2546,7 @@ function ErrorSummary({ labels }) {
 				href: `#${controlId}`,
 				onClick: (event) => {
 					event.preventDefault();
-					const wizard = engine.wizard();
-					const page = engine.pageOf(parsePath(path));
-					if (wizard !== void 0 && wizard.page() !== page) wizard.goTo(page);
-					setFocusing(controlId);
+					goToField(path);
 				},
 				children: text("errors.entry", {
 					label: labelFor(path),
@@ -2581,6 +2590,6 @@ function ResumeNotice({ migration, labels }) {
 	});
 }
 //#endregion
-export { ErrorSummary, FormancyForm, FormancyProvider, OptionsSourcesProvider, ResumeNotice, RichText, RichTextEditorProvider, ScannerProvider, UploaderProvider, useField, useFormEngine, useFormText, useOptionsSources, useRepeater, useRichTextEditorFactory, useScanner, useSubmit, useUploader, useWizard };
+export { ErrorSummary, FormancyForm, FormancyProvider, OptionsSourcesProvider, ResumeNotice, RichText, RichTextEditorProvider, ScannerProvider, UploaderProvider, useField, useFormEngine, useFormText, useGoToField, useOptionsSources, useRepeater, useRichTextEditorFactory, useScanner, useSubmit, useUploader, useWizard };
 
 //# sourceMappingURL=index.mjs.map