iso

type Analysis struct {
	// Label is the volume identifier, which groups the discs of one title.
	Label string
	// Files is every non-empty file.
	Files []File
	// MainFeature is the ordered clips of the Blu-ray main feature playlist,
	// nil for a disc without one. Playing them back to back is the movie.
	MainFeature []Clip
	// DurationTicks is the main feature's authored length at 45 kHz.
	DurationTicks int64
}

type Clip struct {
	File
	InTicks, DurationTicks int64
}

type Extent struct {
	Offset, Length int64
}

type File struct {
	Path    string
	Size    int64
	Extents []Extent
}

type MPLSPlayItem struct {
	// ClipName is the 5-character clip_information_file_name (e.g. "00001").
	// The corresponding stream lives at BDMV/STREAM/<ClipName>.M2TS.
	ClipName string
	// InTime and OutTime are 45 kHz presentation timestamps. Duration in
	// ticks is OutTime - InTime; convert to seconds by dividing by 45000.
	InTime  uint32
	OutTime uint32
}

type MPLSPlayList struct {
	Version   string // e.g. "0100", "0200", "0300"
	PlayItems []MPLSPlayItem
}

type MainFeaturePlaylist struct {
	PlaylistName    string         // e.g. "00800.MPLS" — for logging only
	SourceKind      string         // "m2ts" or "ssif" — selected source family
	DurationTicks   int64          // sum of (OUT-IN) at 45 kHz — informational, not used for selection
	Streams         []isoFileEntry // ordered M2TS entries (duplicates preserved if the playlist legitimately repeats a clip)
	UniqueClipBytes uint64         // sum of file sizes of UNIQUE clips referenced; the primary scoring metric
	UniqueClipCount int            // number of distinct clips referenced; scoring tiebreaker
	// ClipInTimes and ClipDurations are parallel to Streams: the MPLS
	// PlayItem IN_time and (OUT−IN) for each stream, in 45 kHz ticks. They
	// drive the continuous-timeline remux of the concatenated clips.
	ClipInTimes   []int64
	ClipDurations []int64
}