Ability to define schema name for nested objects in requests

[manuel-watchenterprise]

It can be personal taste to have everything in schemas but when it comes to code generators with hardly typed languages such as dart and java, it is almost required to have this option, otherwise ugly automatic names will appear in the application code. Also, it prevents duplications as multiple endpoints can return the same but all of them will have the full specification as it is not using schemas.

Would be nice to understand multiple levels and arrays.

I don't think it's Scramble's responsibility if these extra properties are different in various requests. The first occurrence defines the schema and any reference to the very same schema should use that regardless what is in the request.
However, recognising such a situation can be handy, obviously.

public function rules(Request $request): array
{
  return [
    /**
     * @schemaName UserMeta
     */
    'meta' => ['array'],
    'meta.something' => ['required', 'string'], // added to MediaUploadDto schema def

    /**
     * @schemaName MediaAttachmentsDto
     * @var array<string, MediaUploadDto>
     */
    'media' => ['array'],

    /**
     * @schemaName MediaUploadDto
     */
    'media.avatar' => ['array'],
    'media.avatar.filename' => ['required', 'string'], // added to MediaUploadDto schema def
    'media.avatar.size' => ['nullable', 'integer'], // added to MediaUploadDto schema def

    /**
     * @schemaName MediaUploadDto
     */
    'media.cover_image' => ['array'],
    'media.cover_image.filename' => ['required', 'string'],
    'media.cover_image.size' => ['required', 'integer'],
    'media.cover_image.blurhash' => ['nullable', 'integer'], // not necessarily added to MediaUploadDto schema def

    'gallery' => ['array'],
    /**
     * @schemaName MediaUploadDto
     */
    'gallery.*' => ['array'],
    'gallery.*.filename' => ['required', 'string'],
    'gallery.*.size' => ['required', 'integer'],
  ];
}

class UpdateUserProfileRequest {
  UserMeta meta;
  MediaAttachmentsDto media;
  List<MediaUploadDto> gallery;
}
class UserMeta {
  String something;
}
class MediaAttachmentsDto {
  MediaUploadDto avatar;
  MediaUploadDto coverImage;
}
interface MediaUploadDto {
  String filename;
  Integer size;
}

interface UpdateUserProfileRequest {
  meta: UserMeta;
  media: MediaAttachmentsDto;
  gallery: MediaUploadDto[];
}
interface UserMeta {
  something: string;
}
interface MediaAttachmentsDto {
  [key: string]: MediaUploadDto;
}
interface MediaUploadDto {
  filemane: string;
  size: number | null;
}