/*
This file is part of GNU Taler
(C) 2022-2024 Taler Systems S.A.
GNU Taler is free software; you can redistribute it and/or modify it under the
terms of the GNU General Public License as published by the Free Software
Foundation; either version 3, or (at your option) any later version.
GNU Taler is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with
GNU Taler; see the file COPYING. If not, see
*/
import {
AmountJson,
TalerExchangeApi,
TranslatedString,
} from "@gnu-taler/taler-util";
import { useState } from "preact/hooks";
import { UIField } from "@gnu-taler/web-util/browser";
// export type UIField = {
// value: string | undefined;
// onUpdate: (s: string) => void;
// error: TranslatedString | undefined;
// };
type FormHandler = {
[k in keyof T]?: T[k] extends string
? UIField
: T[k] extends AmountJson
? UIField
: T[k] extends TalerExchangeApi.AmlState
? UIField
: FormHandler;
};
export type FormValues = {
[k in keyof T]: T[k] extends string ? string | undefined : FormValues;
};
export type RecursivePartial = {
[k in keyof T]?: T[k] extends string
? string
: T[k] extends AmountJson
? AmountJson
: T[k] extends TalerExchangeApi.AmlState
? TalerExchangeApi.AmlState
: RecursivePartial;
};
export type FormErrors = {
[k in keyof T]?: T[k] extends string
? TranslatedString
: T[k] extends AmountJson
? TranslatedString
: T[k] extends TalerExchangeApi.AmlState
? TranslatedString
: FormErrors;
};
export type FormStatus =
| {
status: "ok";
result: T;
errors: undefined;
}
| {
status: "fail";
result: RecursivePartial;
errors: FormErrors;
};
function constructFormHandler(
form: RecursivePartial>,
updateForm: (d: RecursivePartial>) => void,
errors: FormErrors | undefined,
): FormHandler {
const keys = Object.keys(form) as Array;
const handler = keys.reduce((prev, fieldName) => {
const currentValue: unknown = form[fieldName];
const currentError: unknown =
errors !== undefined ? errors[fieldName] : undefined;
function updater(newValue: unknown) {
updateForm({ ...form, [fieldName]: newValue });
}
/**
* There is no clear way to know if this object is a custom field
* or a group of fields
*/
if (typeof currentValue === "object") {
// @ts-expect-error FIXME better typing
const group = constructFormHandler(currentValue, updater, currentError);
// @ts-expect-error FIXME better typing
prev[fieldName] = group;
return prev;
}
const field: UIField = {
// @ts-expect-error FIXME better typing
error: currentError,
// @ts-expect-error FIXME better typing
value: currentValue,
onChange: updater,
state: {},
};
// @ts-expect-error FIXME better typing
prev[fieldName] = field;
return prev;
}, {} as FormHandler);
return handler;
}
/**
* FIXME: Consider sending this to web-utils
*
*
* @param defaultValue
* @param check
* @returns
*/
export function useFormState(
defaultValue: RecursivePartial>,
check: (f: RecursivePartial>) => FormStatus,
): [FormHandler, FormStatus] {
const [form, updateForm] =
useState>>(defaultValue);
const status = check(form);
const handler = constructFormHandler(form, updateForm, status.errors);
return [handler, status];
}