shuck-server 0.1.0

Language server scaffold for shuck
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123

use lsp_types::{self as types, request as req};
use shuck_semantic::EditorSymbolTarget;

use crate::edit::RangeExt;
use crate::resolve;
use crate::session::{Client, DocumentSnapshot, RequestCancellationToken, Session};
use crate::workspace_functions::{
    WorkspaceFunctionContext, canonical_path, workspace_function_index,
};

pub(crate) struct Hover;

pub(crate) struct HoverSnapshot {
    document: Option<DocumentSnapshot>,
    workspace: WorkspaceFunctionContext,
}

impl super::RequestHandler for Hover {
    type RequestType = req::HoverRequest;
}

impl super::super::traits::BackgroundRequestHandler for Hover {
    type Snapshot = HoverSnapshot;

    fn snapshot(
        session: &Session,
        params: &types::HoverParams,
        cancellation: RequestCancellationToken,
    ) -> crate::server::Result<Self::Snapshot> {
        let uri = params
            .text_document_position_params
            .text_document
            .uri
            .clone();
        Ok(HoverSnapshot {
            document: session.take_snapshot(uri),
            workspace: session.workspace_function_context(cancellation),
        })
    }

    fn run_with_snapshot(
        snapshot: Self::Snapshot,
        client: &Client,
        params: types::HoverParams,
    ) -> crate::server::Result<Option<types::Hover>> {
        let Some(document) = snapshot.document else {
            return Ok(None);
        };
        hover(document, snapshot.workspace, client, params)
    }
}

fn hover(
    snapshot: DocumentSnapshot,
    workspace: WorkspaceFunctionContext,
    client: &Client,
    params: types::HoverParams,
) -> crate::server::Result<Option<types::Hover>> {
    let Some(analysis) = snapshot.analysis() else {
        return Ok(None);
    };
    let position = params.text_document_position_params.position;
    let offset = usize::from(
        types::Range {
            start: position,
            end: position,
        }
        .to_text_range(
            analysis.source(),
            analysis.line_index(),
            snapshot.encoding(),
        )
        .start(),
    );
    let Some(EditorSymbolTarget::FunctionCall(call)) =
        analysis.semantic().editor_query().target_at_offset(offset)
    else {
        return resolve::hover(snapshot, client, params);
    };

    // Without a source operation, the document-local semantic answer is both
    // exact and cheaper than materializing the workspace function index.
    if analysis.semantic().source_refs().is_empty() {
        return resolve::hover(snapshot, client, params);
    }
    let Some(path) = snapshot
        .query()
        .file_url()
        .to_file_path()
        .ok()
        .map(|path| canonical_path(&path))
    else {
        return resolve::hover(snapshot, client, params);
    };
    let Some(index) = workspace_function_index(&workspace) else {
        return Ok(None);
    };
    let Some(target) =
        index.resolve_call_site_exact(&path, call.name_span, &workspace.cancellation)
    else {
        return Ok(None);
    };
    if target.path == path {
        return resolve::hover(snapshot, client, params);
    }
    let Some(definition_span) = target.selection_span.or(target.def_span) else {
        return Ok(None);
    };
    let Some(file) = index.file(&target.path) else {
        return Ok(None);
    };
    Ok(Some(resolve::render_sourced_function_hover(
        &snapshot,
        analysis.source(),
        analysis.line_index(),
        resolve::SourcedFunctionHover {
            name: call.name.as_str(),
            target_span: call.name_span,
            definition_uri: file.editor_uri(),
            definition_span,
        },
    )))
}