Multimedia y ubicación

Todos los campos comparten el contrato base (control, name, label, description, placeholder, disabled, required, tooltip, className). Aquí se listan solo las props adicionales de cada campo.

FormFileField

Archivos con drag & drop, límites de tipo/tamaño y lista de seleccionados.

Prop	Tipo	Requerida
`accept`	`string`	—
`multiple`	`boolean`	—
`maxSize`	`number`	—
`maxFiles`	`number`	—
`showPreview`	`boolean`	—
`onFilesChange`	`((files: File[]) => void)`	—
`dropzoneClassName`	`string`	—

FormAvatarField

Avatar con previsualización circular y subida.

Prop	Tipo	Requerida
`size`	`'sm' \| 'md' \| 'lg' \| 'xl'`	—
`fallback`	`string`	—
`fallbackIcon`	`React.ReactNode`	—
`maxFileSize`	`number`	—
`accept`	`string`	—
`showRemoveButton`	`boolean`	—
`labels`	`{`	—

FormImageCropField

Recorte de imagen en canvas propio: zoom, rotación y aspecto fijo — sin librerías.

FormSignatureField

Firma a mano en canvas con undo y export PNG/JPEG/SVG — sin librerías.

Prop	Tipo	Requerida
`width`	`number`	—
`height`	`number`	—
`strokeColor`	`string`	—
`strokeWidth`	`number`	—
`backgroundColor`	`string`	—
`showDownload`	`boolean`	—
`showUndo`	`boolean`	—
`outputFormat`	`'png' \| 'jpeg' \| 'svg'`	—

FormAddressField

Dirección estructurada (calle, ciudad, provincia, código, país).

FormCoordinatesField

Latitud/longitud con validación de rangos.

Prop	Tipo	Requerida
`showGetLocation`	`boolean`	—
`showOpenMap`	`boolean`	—
`showCopy`	`boolean`	—
`precision`	`number`	—
`mapProvider`	`'google' \| 'openstreetmap'`	—
`labels`	`{`	—

ImageUploadField

Selector de imagen con preview (forma rect/redonda) y rechazo temprano con causa.

Prop	Tipo	Requerida
`value`	`string`	sí
`pendingFile`	`File \| null`	sí
`onRemove`	`() => void`	sí
`onFileSelect`	`(file: File \| null) => void`	sí
`shape`	`'rect' \| 'round'`	—