feat(admin-settings): radio field type + adopt for Documenso signing-order + send-mode

Adds a 'radio' SettingType the registry-driven admin form can render. Same
shape as 'select' (options list, enum validation, resolved/source badges),
but renders inline radio cards instead of a dropdown so each option's
consequences sit side-by-side for the admin.

Adopted on the two highest-stakes Documenso behaviour toggles:
- `eoi_send_mode` — Manual vs Auto signing-invitation dispatch
- `documenso_signing_order` — Parallel vs Sequential recipient flow

Both choices are binary and materially different (one auto-sends mail, the
other doesn't; one routes signing serially, the other in parallel), so the
upfront comparison beats a hidden dropdown.

`documenso_redirect_url` keeps its url-input — it's already a single
free-text field with no enum.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-05-25 13:06:04 +02:00
parent 9138932d1b
commit 7bdfc340ae
4 changed files with 40 additions and 7 deletions

View File

@@ -28,6 +28,7 @@ type SettingType =
| 'number'
| 'boolean'
| 'select'
| 'radio'
| 'url'
| 'email'
| 'textarea'
@@ -526,6 +527,36 @@ function FieldInput({
/>
);
}
if (entry.type === 'radio' && entry.options) {
// Inline radio group — clearer than a dropdown for 23 mutually-exclusive
// options where each choice has materially different consequences (e.g.
// auto-vs-manual signing dispatch). Falls through to plain Select when
// the option count grows.
const current = value == null ? null : String(value);
return (
<div role="radiogroup" aria-labelledby={`${entry.key}-label`} className="space-y-2">
{entry.options.map((o) => {
const checked = current === o.value;
return (
<label
key={o.value}
className="flex cursor-pointer items-start gap-2 rounded-md border border-input bg-background p-2 text-sm hover:bg-accent/40 has-[:checked]:border-primary has-[:checked]:bg-accent/60"
>
<input
type="radio"
name={entry.key}
value={o.value}
checked={checked}
onChange={() => onChange(o.value)}
className="mt-1 h-4 w-4 cursor-pointer accent-primary"
/>
<span className="flex-1">{o.label}</span>
</label>
);
})}
</div>
);
}
if (entry.type === 'select' && entry.options) {
// Radix Select rejects an empty-string `value` because that's its internal
// sentinel for "cleared". Pass `undefined` instead so the placeholder

View File

@@ -210,10 +210,10 @@ export const REGISTRY: SettingEntry[] = [
label: 'Initial signing-invitation email behaviour',
description:
'Auto = the system sends the branded "please sign" email immediately when an EOI/contract/reservation is generated. Manual = the document is generated and the signing URL appears in the UI; a rep clicks "Send invitation" to dispatch. Applies to all document types, not just EOI.',
type: 'select',
type: 'radio',
options: [
{ value: 'manual', label: 'Manual (rep clicks Send after generation)' },
{ value: 'auto', label: 'Auto (send branded email on generate)' },
{ value: 'manual', label: 'Manual rep clicks Send after generation' },
{ value: 'auto', label: 'Auto send branded email on generate' },
],
scope: 'port',
defaultValue: 'manual',
@@ -241,11 +241,11 @@ export const REGISTRY: SettingEntry[] = [
section: 'documenso.behavior',
label: 'Signing order',
description:
'PARALLEL = all recipients can sign at once. SEQUENTIAL = each waits for the previous (v2 only - v1 always parallel).',
type: 'select',
'PARALLEL = all recipients can sign at once. SEQUENTIAL = each waits for the previous (v2 only v1 always parallel).',
type: 'radio',
options: [
{ value: 'PARALLEL', label: 'Parallel - all recipients sign concurrently' },
{ value: 'SEQUENTIAL', label: 'Sequential - order matters (v2 only)' },
{ value: 'PARALLEL', label: 'Parallel all recipients sign concurrently' },
{ value: 'SEQUENTIAL', label: 'Sequential order matters (v2 only)' },
],
scope: 'port',
defaultValue: 'PARALLEL',

View File

@@ -51,6 +51,7 @@ function defaultValidator(entry: SettingEntry): z.ZodTypeAny {
case 'boolean':
return z.coerce.boolean();
case 'select':
case 'radio':
if (entry.options) {
return z.enum(entry.options.map((o) => o.value) as [string, ...string[]]);
}

View File

@@ -6,6 +6,7 @@ export type SettingType =
| 'number'
| 'boolean'
| 'select'
| 'radio'
| 'url'
| 'email'
| 'textarea'