using Kavita.Models.Entities;
using Kavita.Models.Entities.Enums;
using Kavita.Models.Metadata;

namespace Kavita.Models.Parser;

/// <summary>
/// This represents all parsed information from a single file
/// </summary>
public class ParserInfo
{
    /// <summary>
    /// Represents the parsed chapters from a file. By default, will be 0 which means nothing could be parsed.
    /// <remarks>The chapters can only be a single float or a range of float ie) 1-2. Mainly floats should be multiples of 0.5 representing specials</remarks>
    /// </summary>
    public string Chapters { get; set; } = string.Empty;
    /// <summary>
    /// Represents the parsed series from the file or folder
    /// </summary>
    public required string Series { get; set; } = string.Empty;
    /// <summary>
    /// This can be filled in from ComicInfo.xml/Epub during scanning. Will update the SortName field on <see cref="Models.Entities.Series"/>
    /// </summary>
    public string SeriesSort { get; set; } = string.Empty;
    /// <summary>
    /// This can be filled in from ComicInfo.xml/Epub during scanning. Will update the LocalizedName field on <see cref="Models.Entities.Series"/>
    /// </summary>
    public string LocalizedSeries { get; set; } = string.Empty;
    /// <summary>
    /// Represents the parsed volumes from a file. By default, will be 0 which means that nothing could be parsed.
    /// If Volumes is 0 and Chapters is 0, the file is a special. If Chapters is non-zero, then no volume could be parsed.
    /// <example>Beastars Vol 3-4 will map to "3-4"</example>
    /// <remarks>The volumes can only be a single int or a range of ints ie) 1-2. Float based volumes are not supported.</remarks>
    /// </summary>
    public string Volumes { get; set; } = string.Empty;
    /// <summary>
    /// Filename of the underlying file
    /// <example>Beastars v01 (digital).cbz</example>
    /// </summary>
    public string Filename { get; init; } = string.Empty;
    /// <summary>
    /// Full filepath of the underlying file
    /// <example>C:/Manga/Beastars v01 (digital).cbz</example>
    /// </summary>
    public string FullFilePath { get; set; } = string.Empty;

    /// <summary>
    /// <see cref="MangaFormat"/> that represents the type of the file
    /// <remarks>Mainly used to show in the UI and so caching service knows how to cache for reading.</remarks>
    /// </summary>
    public MangaFormat Format { get; set; } = MangaFormat.Unknown;

    /// <summary>
    /// This can potentially story things like "Omnibus, Color, Full Contact Edition, Extra, Final, etc"
    /// </summary>
    /// <remarks>Not Used in Database</remarks>
    public string Edition { get; set; } = string.Empty;

    /// <summary>
    /// If the file contains no volume/chapter information or contains Special Keywords <see cref="Parser.MangaSpecialRegex"/>
    /// </summary>
    public bool IsSpecial { get; set; }
    /// <summary>
    /// If the file has a Special Marker explicitly, this will contain the index
    /// </summary>
    public int SpecialIndex { get; set; } = 0;

    /// <summary>
    /// Used for specials or books, stores what the UI should show.
    /// <remarks>Manga does not use this field</remarks>
    /// </summary>
    public string Title { get; set; } = string.Empty;

    /// <summary>
    /// This can be filled in from ComicInfo.xml during scanning. Will update the SortOrder field on <see cref="Chapter"/>.
    /// Falls back to Parsed Chapter number
    /// </summary>
    public float IssueOrder { get; set; }

    /// <summary>
    /// This will contain any EXTRA comicInfo information parsed from the epub or archive. If there is an archive with comicInfo.xml AND it contains
    /// series, volume information, that will override what we parsed.
    /// </summary>
    public ComicInfo? ComicInfo { get; set; }


}