mirror of
https://github.com/documenso/documenso.git
synced 2025-11-13 00:03:33 +10:00
Rework: - Field styling to improve visibility - Field insertions, better alignment, centering and overflows ## Changes General changes: - Set default text alignment to left if no meta found - Reduce borders and rings around fields to allow smaller fields - Removed lots of redundant duplicated code surrounding field rendering - Make fields more consistent across viewing, editing and signing - Add more transparency to fields to allow users to see under fields - No more optional/required/etc colors when signing, required fields will be highlighted as orange when form is "validating" Highlighted internal changes: - Utilize native PDF fields to insert text, instead of drawing text - Change font auto scaling to only apply to when the height overflows AND no custom font is set ⚠️ Multiline changes: Multi line is enabled for a field under these conditions 1. Field content exceeds field width 2. Field includes a new line 3. Field type is TEXT ## [BEFORE] Field UI Signing  ## [AFTER] Field UI Signing  ## [BEFORE] Signing a checkbox   ## [AFTER] Signing a checkbox   ## [BEFORE] What a 2nd recipient sees once someone else signed a document  ## [AFTER] What a 2nd recipient sees once someone else signed a document  ## **[BEFORE]** Inserting fields  ## **[AFTER]** Inserting fields  ## Overflows, multilines and field alignments testing Debugging borders: - Red border = The original field placement without any modifications - Blue border = The available space to overflow ### Single line overflows and field alignments This is left aligned fields, overflow will always go to the end of the page and will not wrap  This is center aligned fields, the max width is the closest edge to the page * 2  This is right aligned text, the width will extend all the way to the left hand side of the page  ### Multiline line overflows and field alignments These are text fields that can be overflowed  Another example of left aligned text overflows with more text 
342 lines
11 KiB
TypeScript
342 lines
11 KiB
TypeScript
import { useEffect, useState } from 'react';
|
|
|
|
import { msg } from '@lingui/core/macro';
|
|
import { useLingui } from '@lingui/react';
|
|
import { Trans } from '@lingui/react/macro';
|
|
import { useRevalidator } from 'react-router';
|
|
|
|
import { validateNumberField } from '@documenso/lib/advanced-fields-validation/validate-number';
|
|
import { DO_NOT_INVALIDATE_QUERY_ON_MUTATION } from '@documenso/lib/constants/trpc';
|
|
import { AppError, AppErrorCode } from '@documenso/lib/errors/app-error';
|
|
import type { TRecipientActionAuth } from '@documenso/lib/types/document-auth';
|
|
import { ZNumberFieldMeta } from '@documenso/lib/types/field-meta';
|
|
import type { FieldWithSignature } from '@documenso/prisma/types/field-with-signature';
|
|
import { trpc } from '@documenso/trpc/react';
|
|
import type {
|
|
TRemovedSignedFieldWithTokenMutationSchema,
|
|
TSignFieldWithTokenMutationSchema,
|
|
} from '@documenso/trpc/server/field-router/schema';
|
|
import { cn } from '@documenso/ui/lib/utils';
|
|
import { Button } from '@documenso/ui/primitives/button';
|
|
import { Dialog, DialogContent, DialogFooter, DialogTitle } from '@documenso/ui/primitives/dialog';
|
|
import { Input } from '@documenso/ui/primitives/input';
|
|
import { useToast } from '@documenso/ui/primitives/use-toast';
|
|
|
|
import { useRequiredDocumentSigningAuthContext } from './document-signing-auth-provider';
|
|
import { DocumentSigningFieldContainer } from './document-signing-field-container';
|
|
import {
|
|
DocumentSigningFieldsInserted,
|
|
DocumentSigningFieldsLoader,
|
|
DocumentSigningFieldsUninserted,
|
|
} from './document-signing-fields';
|
|
import { useDocumentSigningRecipientContext } from './document-signing-recipient-provider';
|
|
|
|
type ValidationErrors = {
|
|
isNumber: string[];
|
|
required: string[];
|
|
minValue: string[];
|
|
maxValue: string[];
|
|
numberFormat: string[];
|
|
};
|
|
|
|
export type DocumentSigningNumberFieldProps = {
|
|
field: FieldWithSignature;
|
|
onSignField?: (value: TSignFieldWithTokenMutationSchema) => Promise<void> | void;
|
|
onUnsignField?: (value: TRemovedSignedFieldWithTokenMutationSchema) => Promise<void> | void;
|
|
};
|
|
|
|
export const DocumentSigningNumberField = ({
|
|
field,
|
|
onSignField,
|
|
onUnsignField,
|
|
}: DocumentSigningNumberFieldProps) => {
|
|
const { _ } = useLingui();
|
|
const { toast } = useToast();
|
|
const { revalidate } = useRevalidator();
|
|
|
|
const { recipient, targetSigner, isAssistantMode } = useDocumentSigningRecipientContext();
|
|
|
|
const [showNumberModal, setShowNumberModal] = useState(false);
|
|
|
|
const safeFieldMeta = ZNumberFieldMeta.safeParse(field.fieldMeta);
|
|
const parsedFieldMeta = safeFieldMeta.success ? safeFieldMeta.data : null;
|
|
|
|
const defaultValue = parsedFieldMeta?.value;
|
|
const [localNumber, setLocalNumber] = useState(
|
|
parsedFieldMeta?.value ? String(parsedFieldMeta.value) : '0',
|
|
);
|
|
|
|
const initialErrors: ValidationErrors = {
|
|
isNumber: [],
|
|
required: [],
|
|
minValue: [],
|
|
maxValue: [],
|
|
numberFormat: [],
|
|
};
|
|
|
|
const [errors, setErrors] = useState(initialErrors);
|
|
|
|
const { executeActionAuthProcedure } = useRequiredDocumentSigningAuthContext();
|
|
|
|
const { mutateAsync: signFieldWithToken, isPending: isSignFieldWithTokenLoading } =
|
|
trpc.field.signFieldWithToken.useMutation(DO_NOT_INVALIDATE_QUERY_ON_MUTATION);
|
|
|
|
const {
|
|
mutateAsync: removeSignedFieldWithToken,
|
|
isPending: isRemoveSignedFieldWithTokenLoading,
|
|
} = trpc.field.removeSignedFieldWithToken.useMutation(DO_NOT_INVALIDATE_QUERY_ON_MUTATION);
|
|
|
|
const isLoading = isSignFieldWithTokenLoading || isRemoveSignedFieldWithTokenLoading;
|
|
|
|
const handleNumberChange = (e: React.ChangeEvent<HTMLInputElement>) => {
|
|
const text = e.target.value;
|
|
setLocalNumber(text);
|
|
|
|
if (parsedFieldMeta) {
|
|
const validationErrors = validateNumberField(text, parsedFieldMeta, true);
|
|
setErrors({
|
|
isNumber: validationErrors.filter((error) => error.includes('valid number')),
|
|
required: validationErrors.filter((error) => error.includes('required')),
|
|
minValue: validationErrors.filter((error) => error.includes('minimum value')),
|
|
maxValue: validationErrors.filter((error) => error.includes('maximum value')),
|
|
numberFormat: validationErrors.filter((error) => error.includes('number format')),
|
|
});
|
|
} else {
|
|
const validationErrors = validateNumberField(text);
|
|
setErrors((prevErrors) => ({
|
|
...prevErrors,
|
|
isNumber: validationErrors.filter((error) => error.includes('valid number')),
|
|
}));
|
|
}
|
|
};
|
|
|
|
const onDialogSignClick = () => {
|
|
setShowNumberModal(false);
|
|
|
|
void executeActionAuthProcedure({
|
|
onReauthFormSubmit: async (authOptions) => await onSign(authOptions),
|
|
actionTarget: field.type,
|
|
});
|
|
};
|
|
|
|
const onSign = async (authOptions?: TRecipientActionAuth) => {
|
|
try {
|
|
if (!localNumber || Object.values(errors).some((error) => error.length > 0)) {
|
|
return;
|
|
}
|
|
|
|
const payload: TSignFieldWithTokenMutationSchema = {
|
|
token: recipient.token,
|
|
fieldId: field.id,
|
|
value: localNumber,
|
|
isBase64: true,
|
|
authOptions,
|
|
};
|
|
|
|
if (onSignField) {
|
|
await onSignField(payload);
|
|
return;
|
|
}
|
|
|
|
await signFieldWithToken(payload);
|
|
|
|
setLocalNumber('');
|
|
|
|
await revalidate();
|
|
} catch (err) {
|
|
const error = AppError.parseError(err);
|
|
|
|
if (error.code === AppErrorCode.UNAUTHORIZED) {
|
|
throw error;
|
|
}
|
|
|
|
console.error(err);
|
|
|
|
toast({
|
|
title: _(msg`Error`),
|
|
description: isAssistantMode
|
|
? _(msg`An error occurred while signing as assistant.`)
|
|
: _(msg`An error occurred while signing the document.`),
|
|
variant: 'destructive',
|
|
});
|
|
}
|
|
};
|
|
|
|
const onPreSign = () => {
|
|
if (isAssistantMode) {
|
|
return true;
|
|
}
|
|
|
|
setShowNumberModal(true);
|
|
|
|
if (localNumber && parsedFieldMeta) {
|
|
const validationErrors = validateNumberField(localNumber, parsedFieldMeta, true);
|
|
setErrors({
|
|
isNumber: validationErrors.filter((error) => error.includes('valid number')),
|
|
required: validationErrors.filter((error) => error.includes('required')),
|
|
minValue: validationErrors.filter((error) => error.includes('minimum value')),
|
|
maxValue: validationErrors.filter((error) => error.includes('maximum value')),
|
|
numberFormat: validationErrors.filter((error) => error.includes('number format')),
|
|
});
|
|
}
|
|
|
|
return false;
|
|
};
|
|
|
|
const onRemove = async () => {
|
|
try {
|
|
const payload: TRemovedSignedFieldWithTokenMutationSchema = {
|
|
token: recipient.token,
|
|
fieldId: field.id,
|
|
};
|
|
|
|
if (onUnsignField) {
|
|
await onUnsignField(payload);
|
|
return;
|
|
}
|
|
|
|
await removeSignedFieldWithToken(payload);
|
|
|
|
setLocalNumber(parsedFieldMeta?.value ? String(parsedFieldMeta?.value) : '');
|
|
|
|
await revalidate();
|
|
} catch (err) {
|
|
console.error(err);
|
|
|
|
toast({
|
|
title: _(msg`Error`),
|
|
description: _(msg`An error occurred while removing the field.`),
|
|
variant: 'destructive',
|
|
});
|
|
}
|
|
};
|
|
|
|
useEffect(() => {
|
|
if (!showNumberModal) {
|
|
setLocalNumber(parsedFieldMeta?.value ? String(parsedFieldMeta.value) : '0');
|
|
setErrors(initialErrors);
|
|
}
|
|
}, [showNumberModal]);
|
|
|
|
useEffect(() => {
|
|
if (
|
|
(!field.inserted && defaultValue && localNumber) ||
|
|
(!field.inserted && parsedFieldMeta?.readOnly && defaultValue)
|
|
) {
|
|
void executeActionAuthProcedure({
|
|
onReauthFormSubmit: async (authOptions) => await onSign(authOptions),
|
|
actionTarget: field.type,
|
|
});
|
|
}
|
|
}, []);
|
|
|
|
let fieldDisplayName = 'Number';
|
|
|
|
if (parsedFieldMeta?.label) {
|
|
fieldDisplayName =
|
|
parsedFieldMeta.label.length > 20
|
|
? parsedFieldMeta.label.substring(0, 20) + '...'
|
|
: parsedFieldMeta.label;
|
|
}
|
|
|
|
const userInputHasErrors = Object.values(errors).some((error) => error.length > 0);
|
|
|
|
return (
|
|
<DocumentSigningFieldContainer
|
|
field={field}
|
|
onPreSign={onPreSign}
|
|
onSign={onSign}
|
|
onRemove={onRemove}
|
|
type="Number"
|
|
>
|
|
{isLoading && <DocumentSigningFieldsLoader />}
|
|
|
|
{!field.inserted && (
|
|
<DocumentSigningFieldsUninserted>{fieldDisplayName}</DocumentSigningFieldsUninserted>
|
|
)}
|
|
|
|
{field.inserted && (
|
|
<DocumentSigningFieldsInserted textAlign={parsedFieldMeta?.textAlign}>
|
|
{field.customText}
|
|
</DocumentSigningFieldsInserted>
|
|
)}
|
|
|
|
<Dialog open={showNumberModal} onOpenChange={setShowNumberModal}>
|
|
<DialogContent>
|
|
<DialogTitle>
|
|
{parsedFieldMeta?.label ? parsedFieldMeta?.label : <Trans>Number</Trans>}
|
|
</DialogTitle>
|
|
|
|
<div>
|
|
<Input
|
|
type="text"
|
|
placeholder={parsedFieldMeta?.placeholder ?? ''}
|
|
className={cn('mt-2 w-full rounded-md', {
|
|
'border-2 border-red-300 ring-2 ring-red-200 ring-offset-2 ring-offset-red-200 focus-visible:border-red-400 focus-visible:ring-4 focus-visible:ring-red-200 focus-visible:ring-offset-2 focus-visible:ring-offset-red-200':
|
|
userInputHasErrors,
|
|
})}
|
|
value={localNumber}
|
|
onChange={handleNumberChange}
|
|
/>
|
|
</div>
|
|
|
|
{userInputHasErrors && (
|
|
<div>
|
|
{errors.isNumber?.map((error, index) => (
|
|
<p key={index} className="mt-2 text-sm text-red-500">
|
|
{error}
|
|
</p>
|
|
))}
|
|
{errors.required?.map((error, index) => (
|
|
<p key={index} className="mt-2 text-sm text-red-500">
|
|
{error}
|
|
</p>
|
|
))}
|
|
{errors.minValue?.map((error, index) => (
|
|
<p key={index} className="mt-2 text-sm text-red-500">
|
|
{error}
|
|
</p>
|
|
))}
|
|
{errors.maxValue?.map((error, index) => (
|
|
<p key={index} className="mt-2 text-sm text-red-500">
|
|
{error}
|
|
</p>
|
|
))}
|
|
{errors.numberFormat?.map((error, index) => (
|
|
<p key={index} className="mt-2 text-sm text-red-500">
|
|
{error}
|
|
</p>
|
|
))}
|
|
</div>
|
|
)}
|
|
|
|
<DialogFooter>
|
|
<div className="flex w-full flex-1 flex-nowrap gap-4">
|
|
<Button
|
|
type="button"
|
|
className="flex-1"
|
|
variant="secondary"
|
|
onClick={() => {
|
|
setShowNumberModal(false);
|
|
setLocalNumber('');
|
|
}}
|
|
>
|
|
<Trans>Cancel</Trans>
|
|
</Button>
|
|
|
|
<Button
|
|
type="button"
|
|
className="flex-1"
|
|
disabled={!localNumber || userInputHasErrors}
|
|
onClick={() => onDialogSignClick()}
|
|
>
|
|
<Trans>Save</Trans>
|
|
</Button>
|
|
</div>
|
|
</DialogFooter>
|
|
</DialogContent>
|
|
</Dialog>
|
|
</DocumentSigningFieldContainer>
|
|
);
|
|
};
|