/**

 * Source map for mapping span IDs to source code locations and related metadata.

 * This is used for error reporting and diagnostics.

 */

use crate::diagnostics::diagnostics_api::{Position, SymbolKind};

use rangemap::RangeMap;

pub type SpanId = u32;

#[derive(Debug)]

pub struct HoverInfo {

    pub description: String,       // keyword description, type info...

    pub kind: Option<SymbolKind>,  // var, domain, function...

    pub ty: Option<String>,        // type info like int(0..10)

    pub decl_span: Option<SpanId>, // where declared (not sure that's doable)

}

// source span with start and end positions

// in the essence source code

#[derive(Debug)]

pub struct SourceSpan {

    pub start_byte: usize, // byte offset in the source code

    pub end_byte: usize,

    pub start_point: Position,

    pub end_point: Position,

    pub hover_info: Option<HoverInfo>,

}

// can add more metadata for hovering and stuff

#[derive(Debug, Default)]

pub struct SourceMap {

    pub spans: Vec<SourceSpan>,

    pub by_byte: RangeMap<usize, SpanId>,

}

// allocate a new span and return span id

// put the position of the span in the source map

    // map byte offsets to span id (RangeMap handles lookup)

impl SourceMap {

    // helper to get hover info for a given byte offset (e.g. cursor position)

}

// helper to allocate a span with hover info directly from a tree-sitter node

// source is not used yet but could be for more complex hover info (e.g. showing the actual code snippet)