exp

type Deps struct {
	Store *store.Store
}

type Format string

type Options struct {
	// Format 空字符串时由 OutPath 后缀推断（.txt → TXT，.epub → EPUB）；
	// OutPath 也为空时回退 FormatTXT。SDK 调用方可显式指定以跳过推断。
	Format Format

	// OutPath 输出文件路径；空表示 {novelDir}/{NovelName}.{ext}，
	// ext 由 Format 决定（NovelName 为空则用目录名）。
	OutPath string

	// From / To 章节范围，闭区间。0 表示从第 1 章 / 到最后一章。
	// 范围内未完成的章节会被跳过并写入 Result.Skipped，不视为错误。
	From, To int

	// Overwrite 文件存在时是否覆盖；默认拒绝。
	Overwrite bool
}

type Result struct {
	// Path 实际写入的文件路径（绝对或调用方传入的相对）。
	Path string
	// Chapters 实际写入的章节数。
	Chapters int
	// Bytes 文件字节数（UTF-8）。
	Bytes int
	// Skipped 落在请求范围内但未完成的章节号。
	Skipped []int
}