Enum Region 

pub enum Region {
    Lines {
        start: u32,
        end: u32,
    },
    AstNode {
        node_kind: String,
        name: Option<String>,
        start_byte: u32,
        end_byte: u32,
    },
    WholeFile,
}

A region within a file that participates in a conflict.

Regions localize conflicts to specific parts of a file — either line ranges or AST node spans. This is the difference between “file has conflict” and “lines 42-67 of function process_order have a conflict.”

Serialization

Uses #[serde(tag = "kind")] with snake_case variant names:

{ "kind": "lines", "start": 42, "end": 67 }
{ "kind": "ast_node", "node_kind": "function", "name": "process_order", "start_byte": 1024, "end_byte": 2048 }

Variants

Lines

A contiguous range of lines (1-indexed, inclusive start, exclusive end).

Example

Region::Lines { start: 10, end: 15 } means lines 10..15.

Fields

start: u32

First line of the region (1-indexed, inclusive).

end: u32

One past the last line of the region (exclusive).

AstNode

An AST node identified by tree-sitter node kind and optional name.

Used when the merge engine has parsed the file and can identify conflicts at the syntax-tree level rather than raw line ranges.

Example

AstNode { node_kind: "function_item", name: Some("process_order"), start_byte: 1024, end_byte: 2048 }

Fields

node_kind: String

The tree-sitter node kind (e.g., “function_item”, “struct_item”).

name: Option<String>

The name of the node if available (e.g., function name, struct name).

start_byte: u32

Start byte offset in the file (0-indexed).

end_byte: u32

End byte offset in the file (exclusive).

WholeFile

The entire file (used when region-level granularity is not available).

Implementations

impl Region

pub const fn lines(start: u32, end: u32) -> Self

Create a line-based region.

pub fn ast_node( node_kind: impl Into<String>, name: Option<String>, start_byte: u32, end_byte: u32, ) -> Self

Create an AST-node region.

pub const fn whole_file() -> Self

Create a whole-file region.

pub fn summary(&self) -> String

Return a human-readable summary of this region.

Trait Implementations

impl Clone for Region

fn clone(&self) -> Region

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Region

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Region

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Region

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for Region

fn eq(&self, other: &Region) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Region

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for Region

impl StructuralPartialEq for Region