merge

type Limits = creator.Limits

type Options struct {
	// Compression 是输出 ZIP 的压缩策略，空值时使用 creator.CompressionAuto。
	Compression creator.CompressionMode
	// CompressionLevel 是 DEFLATE 压缩级别，0 使用默认级别 5，显式范围
	// 1（最快）到 9（最紧凑）。仅对实际使用 Deflate 的条目生效。
	CompressionLevel int
	// Deterministic 使用固定 ZIP 时间，生成可复现的合并结果。
	Deterministic bool
	// Signatures 是签名处理方式，空值时使用 creator.SignaturePreserve。
	// preserve 无法保持签名路径或受保护文件字节不变时返回错误。
	Signatures creator.SignatureMode
	// Orphans 是文档目录之外条目的处理方式，空值时使用 OrphanError。
	Orphans OrphanMode
	// Limits 限制合并输入的规模，零值使用默认限制。
	Limits Limits
	// OnWarning 可选，接收合并过程中的非致命提示，例如签名被重写后签名值失效。
	OnWarning func(string)
	// OnSignature 可选，接收每个输入签名的处理结果。
	OnSignature func(SignatureEvent)
}

type OrphanMode string

type PageLimits struct {
	// MaxInputBytes 是单个输入 OFD 的最大字节数，0 表示默认 512MB。
	MaxInputBytes int64
	// MaxTotalBytes 是所有输入 OFD 的总字节数上限，0 表示默认 1GB。
	MaxTotalBytes int64
	// MaxPages 是输出合并文档的最大页数，0 表示默认 100000。
	MaxPages int
}

type PageOptions struct {
	// Compression 是输出 ZIP 的压缩策略，空值时使用 creator.CompressionAuto。
	Compression creator.CompressionMode
	// CompressionLevel 是 DEFLATE 压缩级别，0 使用默认级别 5，显式范围
	// 1（最快）到 9（最紧凑）。仅对实际使用 Deflate 的条目生效。
	CompressionLevel int
	// Deterministic 使用固定 ZIP 时间，生成可复现的合并结果。
	Deterministic bool
	// Pages 指定输出页序，元素为按输入顺序拼接后的 1 起始全局页码；为空时输出
	// 全部页面。允许重复与重排，越界会返回错误。与 Selectors 互斥。
	Pages []int
	// Selectors 按来源选页，元素为 1 起始的来源序号与该来源内 1 起始的页码；
	// Source 为 0 表示全局页序。与 Pages 互斥。
	Selectors []PageSelector
	// Limits 限制输入字节数与输出页数，零值使用默认限制。
	Limits PageLimits
	// Concurrency 是并行解析/转换输入的并发数，0 表示默认 4，1 表示串行。
	Concurrency int
	// OnSignature 可选，接收每个输入签名在模型级合并中被丢弃的结果。
	OnSignature func(SignatureEvent)
	// ID、Title、Author、Subject 可选覆盖输出文档元数据；为空时沿用首个来源。
	ID      string
	Title   string
	Author  string
	Subject string
}

type PageSelector struct {
	Source int
	Pages  []int
}

type SignatureAction string

type SignatureEvent struct {
	// Input 是来源名称，文件输入时为路径。
	Input string
	// DocumentIndex 是文档体索引，从 0 开始。
	DocumentIndex int
	// ID 是签名标识或签名文件路径。
	ID string
	// Action 是对该签名的处理动作。
	Action SignatureAction
}

type SignatureStatus struct {
	// ID 是签名标识。
	ID string
	// DigestValid 仅表示签名引用与数据摘要匹配，不包含算法一致性与保护范围检查。
	DigestValid bool
	// Verified 表示 SM2/SES 密码学签名验证通过。
	Verified bool
	// VerificationError 是密码学验证的错误信息。
	VerificationError string
	// Validation 是完整验签结论；只有 Status 为 valid 才表示完整通过。
	Validation *parser.SignatureValidation
}

type Source struct {
	Name   string
	Path   string
	Data   []byte
	Reader io.ReaderAt
	Size   int64
}