csslsrs 0.1.0

Language service for CSS, providing features like completions, hover, and folding ranges.
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

use crate::{converters::PositionEncoding, css_data::CssCustomData, store::DocumentStore};
use serde_json;
use std::sync::LazyLock;

/// The Language Service is the main entry point for interacting with CSSlsrs.
/// It contains a DocumentStore, a PositionEncoding and a reference to the CSS data.
pub struct LanguageService {
    pub store: DocumentStore,
    pub encoding: PositionEncoding,
    pub css_data: &'static CssCustomData,
}

static CSS_DATA: LazyLock<CssCustomData> =
    LazyLock::new(
        || match serde_json::from_str(include_str!("../data/css-schema.json")) {
            Ok(data) => data,
            Err(e) => panic!("Failed to parse CSS data: {}", e),
        },
    );

impl LanguageService {
    /// Create a new LanguageService with a default DocumentStore and a custom PositionEncoding.
    ///
    /// ## Example
    /// ```rust
    /// use csslsrs::service::LanguageService;
    /// use csslsrs::converters::PositionEncoding;
    ///
    /// let language_service = LanguageService::new(PositionEncoding::Utf8);
    /// ```
    pub fn new(encoding: PositionEncoding) -> Self {
        LanguageService {
            store: DocumentStore::new(),
            encoding,
            css_data: &CSS_DATA,
        }
    }

    /// Create a new LanguageService with an already existing DocumentStore. This can be useful to share the same DocumentStore between multiple LanguageServices. If you do not need to share the DocumentStore, you can use the LanguageService::new() method instead.
    ///
    /// ## Example
    ///
    /// ```rust
    /// use csslsrs::service::LanguageService;
    /// use csslsrs::store::DocumentStore;
    /// use csslsrs::converters::PositionEncoding;
    ///
    /// let store = DocumentStore::new();
    ///
    /// let language_service = LanguageService::new_with_store(store, PositionEncoding::Utf8);
    /// ```
    pub fn new_with_store(store: DocumentStore, encoding: PositionEncoding) -> Self {
        LanguageService {
            store,
            encoding,
            css_data: &CSS_DATA,
        }
    }
}

impl Default for LanguageService {
    fn default() -> Self {
        LanguageService::new(PositionEncoding::Wide(
            crate::converters::WideEncoding::Utf16,
        ))
    }
}