omena-lsp-server 0.3.0

Rust LSP server boundary scaffold for Omena CSS Modules
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

//! workspace/symbol: name-search over the corpus's style DECLARATIONS —
//! class selectors, Sass variables/mixins/functions, custom properties —
//! read exclusively from the precomputed per-document candidates, so a
//! query never builds an index or touches disk. Cmd+T for "where is this
//! class/token defined?".

use crate::{
    LspDocumentOrigin, LspQueryReadView,
    protocol::{file_label_from_uri, is_style_document_uri},
};
use serde_json::{Value, json};

/// Bounded so a one-letter query cannot flood the client; VS Code refines
/// the query as the user types.
const MAX_WORKSPACE_SYMBOLS: usize = 256;

pub(crate) fn resolve_lsp_workspace_symbols(
    state: &dyn LspQueryReadView,
    params: Option<&Value>,
) -> Value {
    let query = params
        .and_then(|params| params.pointer("/query"))
        .and_then(Value::as_str)
        .unwrap_or_default()
        .to_lowercase();
    let mut symbols = Vec::new();
    'documents: for document in state.query_documents().values() {
        // LOCAL declarations only: the corpus also admits foreign
        // (node_modules) stylesheets for resolution, and surfacing their
        // internals would drown the user's own symbols (review finding).
        if document.origin != LspDocumentOrigin::Local
            || !is_style_document_uri(document.uri.as_str())
        {
            continue;
        }
        for candidate in &document.style_candidates {
            let Some((display_name, symbol_kind)) =
                workspace_symbol_shape(candidate.kind, candidate.name.as_str())
            else {
                continue;
            };
            if !query.is_empty() && !display_name.to_lowercase().contains(query.as_str()) {
                continue;
            }
            symbols.push(json!({
                "name": display_name,
                "kind": symbol_kind,
                "location": {
                    "uri": document.uri,
                    "range": candidate.range,
                },
                "containerName": file_label_from_uri(document.uri.as_str()),
            }));
            if symbols.len() >= MAX_WORKSPACE_SYMBOLS {
                break 'documents;
            }
        }
    }
    symbols.sort_by(|left, right| {
        left.pointer("/name")
            .and_then(Value::as_str)
            .cmp(&right.pointer("/name").and_then(Value::as_str))
    });
    json!(symbols)
}

/// DECLARATION candidate kinds only — references would flood the list and
/// belong to textDocument/references. LSP SymbolKind: Class=5, Method=6,
/// Property=7, Function=12, Variable=13.
fn workspace_symbol_shape(candidate_kind: &str, name: &str) -> Option<(String, u8)> {
    match candidate_kind {
        "selector" => Some((format!(".{name}"), 5)),
        "sassVariableDeclaration" => Some((format!("${name}"), 13)),
        "sassMixinDeclaration" => Some((format!("@mixin {name}"), 6)),
        "sassFunctionDeclaration" => Some((format!("@function {name}"), 12)),
        "sassSymbolDeclaration" => Some((format!("${name}"), 13)),
        "customPropertyDeclaration" => Some((name.to_string(), 7)),
        _ => None,
    }
}