textutil

type BytesRange struct {
	// byte range is ignored. When both byte and line ranges are unset, the
	// full (optionally MaxBytes-truncated) content is returned.
	OffsetBytes int64 `json:"offsetBytes,omitempty"` // 0-based byte offset; default 0
	LengthBytes int   `json:"lengthBytes,omitempty"` // bytes to read; 0 => use MaxBytes cap

}

type GrepFile struct {
	// Path is the logical path under the effective root (e.g. workspace-
	// relative or root-relative). URI may carry the canonical address
	// when needed by higher layers (e.g. workspace://... or file://...).
	Path string
	URI  string

	// SearchHash is a stable hash of the grep query parameters used to
	// produce this result set (e.g. pattern, root, path, filters). It allows
	// UIs to de-duplicate or uniquely identify rows across searches.
	SearchHash string

	// RangeKey is an optional, human-readable range identifier derived from
	// the first snippet window (e.g. "12-24"). It is intended as a secondary
	// disambiguator when needed by UIs.
	RangeKey string

	Matches  int     // number of matches in this file
	Score    float32 // optional heuristic score (e.g. density of matches)
	Snippets []Snippet
	Omitted  int // number of snippets or matches omitted due to limits
}

type GrepStats struct {
	Scanned   int  // total files scanned
	Matched   int  // files with at least one match
	Truncated bool // true when limits prevented a full scan
}

type IntRange struct {
	From *int `json:"from,omitempty"`
	To   *int `json:"to,omitempty"`
}

type LineRange struct {

	// StartLine and LineCount describe a 1-based line slice. When StartLine > 0
	// this mode is used in preference to the byte range.
	StartLine int `json:"startLine,omitempty"` // 1-based start line
	LineCount int `json:"lineCount,omitempty"` // number of lines; 0 => until EOF or MaxBytes

}

type Snippet struct {
	// StartLine and EndLine are 1-based line numbers within the source
	// document. When unknown, they may be left as 0.
	StartLine int
	EndLine   int

	// OffsetBytes is the byte offset of the first byte of Text within
	// the original document. LengthBytes is the size of Text in bytes.
	OffsetBytes int64
	LengthBytes int

	// Text contains the snippet content. Implementations may apply
	// additional truncation to enforce byte/line limits.
	Text string

	// Hits optionally records match positions as (lineOffset, columnOffset)
	// pairs relative to StartLine within this snippet.
	Hits [][2]int

	// Cut indicates that the snippet was truncated due to configured
	// limits (e.g. max bytes or max lines).
	Cut bool
}