chunk

type Chunk struct {
	Index    int    // 分块索引
	Title    string // 分块标题（可选）
	Text     string // 分块文本
	Metadata map[string]interface{}
}

type ChunkOptions struct {
	// MaxChars 目标最大字符数
	MaxChars int
	// OverlapChars 相邻分块的重叠字符数
	OverlapChars int
	// MinChars 最小字符数
	MinChars int
	// DocumentTitle 文档标题
	DocumentTitle string
	// PreChunkClean 分块前的清理选项
	PreChunkClean map[string]interface{}
}

type ChunkResult struct {
	Chunks       []Chunk
	DocumentType DocumentType
	Duration     int64 // 毫秒
}

type ChunkStats struct {
	TotalChunks  int
	TotalChars   int
	AvgChunkSize int
	MinChunkSize int
	MaxChunkSize int
	OverlapChars int
	DocumentType DocumentType
}

type Chunker interface {
	// Provider 返回提供商名称
	Provider() string

	// Chunk 将文本分块
	Chunk(ctx context.Context, text string, opts *ChunkOptions) ([]Chunk, error)
}

type ChunkerFactory interface {
	// Create 创建分块器
	Create(ctx context.Context, cfg *Config) (Chunker, error)

	// Name 返回工厂名称
	Name() string

	// Supports 检查是否支持该提供商
	Supports(provider string) bool
}

type Config struct {
	// Provider 提供商名称 (llm, rules_structured, rules_table_kv, router 等)
	Provider string

	// Model LLM 模型名称（仅用于 LLM 分块器）
	Model string

	// ChatModel LLM 聊天模型（仅用于 LLM 分块器）
	ChatModel interface{}

	// Detector 文档类型检测器（仅用于 router 分块器）
	Detector DocumentTypeDetector

	// MaxChars 最大字符数
	MaxChars int

	// MinChars 最小字符数
	MinChars int

	// OverlapChars 重叠字符数
	OverlapChars int

	// CustomConfig 自定义配置
	CustomConfig map[string]interface{}
}

type DefaultFactory struct {
	// contains filtered or unexported fields
}

type DocumentType int

type DocumentTypeDetector interface {
	// DetectDocumentType 检测文档类型
	DetectDocumentType(ctx context.Context, text string) (DocumentType, error)
}

type LLMChunker struct {
	// contains filtered or unexported fields
}

type LLMChunkerFactory struct{}

type RouterChunkerFactory struct{}

type RoutingChunker struct {
	// contains filtered or unexported fields
}

type RuleBasedDocumentTypeDetector struct{}

type StructuredChunkerFactory struct{}

type StructuredRuleChunker struct {
	// contains filtered or unexported fields
}

type TableKVChunker struct {
	// contains filtered or unexported fields
}

type TableKVChunkerFactory struct{}