excel

type BatchConfig struct {
	// BatchSize 每批写入行数(默认 1000);0 表示不分批。
	BatchSize int
	// OnProgress 进度回调(已写入行数,总行数),nil 不回调。
	OnProgress func(written, total int)
}

type RowError struct {
	Row   int    // Excel 行号(1-based)
	Error string // 错误描述
}

type SheetData[T any] struct {
	// SheetName 工作表名(默认 "Sheet1")。
	SheetName string
	// Template 该 sheet 的模板配置。
	Template Template
	// Data 该 sheet 的数据列表。
	Data []T
}

type Template struct {
	// FilePath 模板文件路径(导出时打开;导入时作为表头参考)。
	FilePath string
	// SheetName 工作表名(默认 "Sheet1")。
	SheetName string
	// HeaderRow 表头行号(1-based,默认 1)。
	HeaderRow int
	// DataStartRow 数据起始行号(1-based,默认 2)。
	DataStartRow int
}