encoding

type ConvertResult struct {
	// Data 转换后的数据
	Data []byte `json:"-"`

	// SourceEncoding 源编码
	SourceEncoding string `json:"source_encoding"`

	// TargetEncoding 目标编码
	TargetEncoding string `json:"target_encoding"`

	// BytesProcessed 处理的字节数
	BytesProcessed int64 `json:"bytes_processed"`

	// ConversionTime 转换耗时
	ConversionTime time.Duration `json:"conversion_time"`
}

type Converter interface {
	// Convert 在指定编码之间转换
	Convert(data []byte, from, to string) ([]byte, error)

	// ConvertToUTF8 转换为 UTF-8 编码
	ConvertToUTF8(data []byte, from string) ([]byte, error)

	// ConvertString 字符串编码转换
	ConvertString(text, from, to string) (string, error)
}

type ConverterConfig struct {
	// StrictMode 严格模式（遇到无法转换字符时报错）
	StrictMode bool `json:"strict_mode"`

	// InvalidCharReplacement 无效字符替换字符
	InvalidCharReplacement string `json:"invalid_char_replacement"`

	// BufferSize 转换缓冲区大小
	BufferSize int `json:"buffer_size"`

	// MaxMemoryUsage 最大内存使用量（字节，0 表示无限制）
	MaxMemoryUsage int64 `json:"max_memory_usage"`

	// ChunkSize 大文件分块大小（字节，默认 1MB）
	ChunkSize int64 `json:"chunk_size"`

	// PreserveBOM 是否保留 BOM
	PreserveBOM bool `json:"preserve_bom"`

	// NormalizeLineEndings 是否规范化换行符
	NormalizeLineEndings bool `json:"normalize_line_endings"`

	// TargetLineEnding 目标换行符（LF, CRLF, CR）
	TargetLineEnding string `json:"target_line_ending"`
}

type DetectionCandidate struct {
	Encoding      string
	Confidence    float64
	Method        string
	ConvertedText string
	Score         float64
}

type DetectionResult struct {
	// Encoding 检测到的编码名称
	Encoding string `json:"encoding"`

	// Confidence 检测置信度 (0.0-1.0)
	Confidence float64 `json:"confidence"`

	// Language 检测到的语言（可选）
	Language string `json:"language,omitempty"`

	// Details 详细信息（可选）
	Details map[string]interface{} `json:"details,omitempty"`
}

type Detector interface {
	// DetectEncoding 检测数据的编码格式
	DetectEncoding(data []byte) (*DetectionResult, error)

	// DetectFileEncoding 检测文件的编码格式
	DetectFileEncoding(filename string) (*DetectionResult, error)

	// DetectBestEncoding 检测最可能的编码格式（简化版本）
	DetectBestEncoding(data []byte) (string, error)

	// SmartDetectEncoding 智能编码检测（增强版）
	SmartDetectEncoding(data []byte) (*DetectionResult, error)
}

type DetectorConfig struct {
	// SampleSize 检测样本大小（字节，默认 8192）
	SampleSize int `json:"sample_size"`

	// MinConfidence 最小置信度（默认 0.6）
	MinConfidence float64 `json:"min_confidence"`

	// SupportedEncodings 支持的编码列表
	SupportedEncodings []string `json:"supported_encodings"`

	// EnableCache 是否启用检测结果缓存
	EnableCache bool `json:"enable_cache"`

	// CacheSize 缓存大小（默认 1000）
	CacheSize int `json:"cache_size"`

	// CacheTTL 缓存过期时间（默认 1 小时）
	CacheTTL time.Duration `json:"cache_ttl"`

	// EnableLanguageDetection 是否启用语言检测
	EnableLanguageDetection bool `json:"enable_language_detection"`

	// PreferredEncodings 优先编码列表（检测时优先考虑）
	PreferredEncodings []string `json:"preferred_encodings"`
}

type EncodingError struct {
	Op       string // 操作名称
	Encoding string // 相关编码
	File     string // 相关文件（可选）
	Err      error  // 原始错误
}

type FileOperationError struct {
	Op   string // 操作名称
	File string // 文件路径
	Err  error  // 原始错误
}

type FileProcessOptions struct {
	// TargetEncoding 目标编码（默认 UTF-8）
	TargetEncoding string `json:"target_encoding"`

	// MinConfidence 最小置信度阈值（默认 0.8）
	MinConfidence float64 `json:"min_confidence"`

	// CreateBackup 是否创建备份文件（默认 true）
	CreateBackup bool `json:"create_backup"`

	// BackupSuffix 备份文件后缀（默认 ".bak"）
	BackupSuffix string `json:"backup_suffix"`

	// OverwriteExisting 是否覆盖已存在的输出文件（默认 false）
	OverwriteExisting bool `json:"overwrite_existing"`

	// BufferSize 缓冲区大小（字节，默认 8192）
	BufferSize int `json:"buffer_size"`

	// PreserveMode 是否保持文件权限（默认 true）
	PreserveMode bool `json:"preserve_mode"`

	// PreserveTime 是否保持文件时间戳（默认 true）
	PreserveTime bool `json:"preserve_time"`

	// DryRun 试运行模式，不实际修改文件（默认 false）
	DryRun bool `json:"dry_run"`
}

type FileProcessResult struct {
	// InputFile 输入文件路径
	InputFile string `json:"input_file"`

	// OutputFile 输出文件路径
	OutputFile string `json:"output_file"`

	// BackupFile 备份文件路径（如果创建了备份）
	BackupFile string `json:"backup_file,omitempty"`

	// SourceEncoding 检测到的源编码
	SourceEncoding string `json:"source_encoding"`

	// TargetEncoding 目标编码
	TargetEncoding string `json:"target_encoding"`

	// BytesProcessed 处理的字节数
	BytesProcessed int64 `json:"bytes_processed"`

	// ProcessingTime 处理耗时
	ProcessingTime time.Duration `json:"processing_time"`

	// DetectionConfidence 编码检测置信度
	DetectionConfidence float64 `json:"detection_confidence"`
}

type FileProcessor interface {
	// ProcessFile 处理文件（检测并转换编码）
	ProcessFile(inputFile, outputFile string, options *FileProcessOptions) (*FileProcessResult, error)

	// ProcessFileInPlace 就地处理文件（直接修改源文件）
	ProcessFileInPlace(file string, options *FileProcessOptions) (*FileProcessResult, error)

	// ProcessFileToBytes 读取文件并转换编码，返回字节数组
	ProcessFileToBytes(filename, targetEncoding string) ([]byte, error)

	// ProcessFileToString 读取文件并转换编码，返回字符串
	ProcessFileToString(filename, targetEncoding string) (string, error)
}

type Logger interface {
	Debug(msg string, fields ...interface{})
	Info(msg string, fields ...interface{})
	Warn(msg string, fields ...interface{})
	Error(msg string, fields ...interface{})
}

type MetricsCollector interface {
	// GetStats 获取处理统计信息
	GetStats() *ProcessingStats

	// ResetStats 重置统计信息
	ResetStats()

	// RecordOperation 记录操作
	RecordOperation(operation string, duration time.Duration)

	// RecordError 记录错误
	RecordError(operation string, err error)
}

type ProcessingStats struct {
	// TotalOperations 总操作数
	TotalOperations int64 `json:"total_operations"`

	// SuccessOperations 成功操作数
	SuccessOperations int64 `json:"success_operations"`

	// FailedOperations 失败操作数
	FailedOperations int64 `json:"failed_operations"`

	// TotalBytes 总字节数
	TotalBytes int64 `json:"total_bytes"`

	// TotalProcessingTime 总处理时间
	TotalProcessingTime time.Duration `json:"total_processing_time"`

	// AverageProcessingSpeed 平均处理速度（字节/秒）
	AverageProcessingSpeed float64 `json:"average_processing_speed"`

	// EncodingDistribution 编码分布统计
	EncodingDistribution map[string]int64 `json:"encoding_distribution"`

	// StartTime 统计开始时间
	StartTime time.Time `json:"start_time"`

	// LastUpdateTime 最后更新时间
	LastUpdateTime time.Time `json:"last_update_time"`
}

type Processor interface {
	Detector
	Converter

	// SmartConvert 智能转换（自动检测源编码）
	SmartConvert(data []byte, target string) (*ConvertResult, error)

	// SmartConvertString 智能字符串转换（自动检测源编码）
	SmartConvertString(text, target string) (*StringConvertResult, error)
}

type ProcessorConfig struct {
	// DetectorConfig 检测器配置
	DetectorConfig *DetectorConfig `json:"detector_config"`

	// ConverterConfig 转换器配置
	ConverterConfig *ConverterConfig `json:"converter_config"`

	// EnableMetrics 是否启用性能监控
	EnableMetrics bool `json:"enable_metrics"`

	// LogLevel 日志级别
	LogLevel string `json:"log_level"`

	// Logger 自定义日志记录器
	Logger Logger `json:"-"`

	// TempDir 临时文件目录
	TempDir string `json:"temp_dir"`

	// MaxFileSize 最大文件大小（字节，0 表示无限制）
	MaxFileSize int64 `json:"max_file_size"`
}

type StreamOptions struct {
	// SourceEncoding 源编码（空值表示自动检测）
	SourceEncoding string `json:"source_encoding"`

	// TargetEncoding 目标编码（默认 UTF-8）
	TargetEncoding string `json:"target_encoding"`

	// BufferSize 缓冲区大小（默认 8192）
	BufferSize int `json:"buffer_size"`

	// DetectionSampleSize 编码检测样本大小（默认 8192）
	DetectionSampleSize int `json:"detection_sample_size"`

	// SkipBOM 是否跳过 BOM（默认 false）
	SkipBOM bool `json:"skip_bom"`

	// StrictMode 严格模式（遇到无法转换字符时报错，默认 false）
	StrictMode bool `json:"strict_mode"`
}

type StreamProcessor interface {
	// ProcessReader 处理输入流
	ProcessReader(ctx context.Context, r io.Reader, sourceEncoding, targetEncoding string) (io.Reader, error)

	// ProcessWriter 创建转换写入器
	ProcessWriter(ctx context.Context, w io.Writer, sourceEncoding, targetEncoding string) (io.Writer, error)

	// ProcessReaderWriter 处理读写流
	ProcessReaderWriter(ctx context.Context, r io.Reader, w io.Writer, options *StreamOptions) (*StreamResult, error)
}

type StreamResult struct {
	// BytesRead 读取的字节数
	BytesRead int64 `json:"bytes_read"`

	// BytesWritten 写入的字节数
	BytesWritten int64 `json:"bytes_written"`

	// SourceEncoding 检测到的源编码
	SourceEncoding string `json:"source_encoding"`

	// TargetEncoding 目标编码
	TargetEncoding string `json:"target_encoding"`

	// ProcessingTime 处理耗时
	ProcessingTime time.Duration `json:"processing_time"`

	// ErrorCount 转换错误次数
	ErrorCount int `json:"error_count"`
}

type StringConvertResult struct {
	// Text 转换后的字符串
	Text string `json:"text"`

	// SourceEncoding 源编码
	SourceEncoding string `json:"source_encoding"`

	// TargetEncoding 目标编码
	TargetEncoding string `json:"target_encoding"`

	// BytesProcessed 处理的字节数
	BytesProcessed int64 `json:"bytes_processed"`

	// ConversionTime 转换耗时
	ConversionTime time.Duration `json:"conversion_time"`
}