using System.ComponentModel.DataAnnotations; using API.Entities; using API.Entities.Enums; using API.Entities.Enums.UserPreferences; namespace API.DTOs; public class UserPreferencesDto { /// /// Manga Reader Option: What direction should the next/prev page buttons go /// [Required] public ReadingDirection ReadingDirection { get; set; } /// /// Manga Reader Option: How should the image be scaled to screen /// [Required] public ScalingOption ScalingOption { get; set; } /// /// Manga Reader Option: Which side of a split image should we show first /// [Required] public PageSplitOption PageSplitOption { get; set; } /// /// Manga Reader Option: How the manga reader should perform paging or reading of the file /// /// Webtoon uses scrolling to page, LeftRight uses paging by clicking left/right side of reader, UpDown uses paging /// by clicking top/bottom sides of reader. /// /// [Required] public ReaderMode ReaderMode { get; set; } /// /// Manga Reader Option: How many pages to display in the reader at once /// [Required] public LayoutMode LayoutMode { get; set; } /// /// Manga Reader Option: Emulate a book by applying a shadow effect on the pages /// [Required] public bool EmulateBook { get; set; } /// /// Manga Reader Option: Background color of the reader /// [Required] public string BackgroundColor { get; set; } = "#000000"; /// /// Manga Reader Option: Should swiping trigger pagination /// [Required] public bool SwipeToPaginate { get; set; } /// /// Manga Reader Option: Allow the menu to close after 6 seconds without interaction /// [Required] public bool AutoCloseMenu { get; set; } /// /// Manga Reader Option: Show screen hints to the user on some actions, ie) pagination direction change /// [Required] public bool ShowScreenHints { get; set; } = true; /// /// Book Reader Option: Override extra Margin /// [Required] public int BookReaderMargin { get; set; } /// /// Book Reader Option: Override line-height /// [Required] public int BookReaderLineSpacing { get; set; } /// /// Book Reader Option: Override font size /// [Required] public int BookReaderFontSize { get; set; } /// /// Book Reader Option: Maps to the default Kavita font-family (inherit) or an override /// [Required] public string BookReaderFontFamily { get; set; } = null!; /// /// Book Reader Option: Allows tapping on side of screens to paginate /// [Required] public bool BookReaderTapToPaginate { get; set; } /// /// Book Reader Option: What direction should the next/prev page buttons go /// [Required] public ReadingDirection BookReaderReadingDirection { get; set; } /// /// Book Reader Option: What writing style should be used, horizontal or vertical. /// [Required] public WritingStyle BookReaderWritingStyle { get; set; } /// /// UI Site Global Setting: The UI theme the user should use. /// /// Should default to Dark [Required] public SiteTheme? Theme { get; set; } [Required] public string BookReaderThemeName { get; set; } = null!; [Required] public BookPageLayoutMode BookReaderLayoutMode { get; set; } /// /// Book Reader Option: A flag that hides the menu-ing system behind a click on the screen. This should be used with tap to paginate, but the app doesn't enforce this. /// /// Defaults to false [Required] public bool BookReaderImmersiveMode { get; set; } = false; /// /// Global Site Option: If the UI should layout items as Cards or List items /// /// Defaults to Cards [Required] public PageLayoutMode GlobalPageLayoutMode { get; set; } = PageLayoutMode.Cards; /// /// UI Site Global Setting: If unread summaries should be blurred until expanded or unless user has read it already /// /// Defaults to false [Required] public bool BlurUnreadSummaries { get; set; } = false; /// /// UI Site Global Setting: Should Kavita prompt user to confirm downloads that are greater than 100 MB. /// [Required] public bool PromptForDownloadSize { get; set; } = true; /// /// UI Site Global Setting: Should Kavita disable CSS transitions /// [Required] public bool NoTransitions { get; set; } = false; }