Mountain/Command/Hover/
Fn.rs

1//! # Hover Function
2//!
3//! Implements hover functionality for language features.
4//!
5//! ## Responsibilities
6//!
7//! - Handle hover requests from the frontend
8//! - Delegate to language feature providers
9//! - Transform provider responses to standard format
10//!
11//! ## Architectural Role
12//!
13//! This module is part of the **Command layer**, providing the actual
14//! hover functionality that bridges the frontend to the language service.
15//!
16//! ## Design
17//!
18//! - Single async function as the entry point
19//! - Validates input before processing
20//! - Delegates to providers for actual implementation
21//! - Returns standardized response
22
23use serde_json::Value;
24use tauri::{AppHandle, Wry};
25use url::Url;
26
27use crate::{
28	Command::Hover::Interface::{
29		HoverRequest::Struct as HoverRequest,
30		HoverResponse::Struct as HoverResponse,
31		Position::Struct as Position,
32	},
33	dev_log,
34};
35
36/// Validates a hover request
37fn ValidateRequest(uri:&str, position:&Value) -> Result<HoverRequest, String> {
38	// Parse URI
39	let document_uri = Url::parse(uri).map_err(|e| format!("Invalid URI: {}", e))?;
40
41	// Parse position from JSON value
42	let position_dto:Position =
43		serde_json::from_value(position.clone()).map_err(|e| format!("Invalid position: {}", e))?;
44
45	Ok(HoverRequest { uri:document_uri.to_string(), position:position_dto })
46}
47
48/// Provides hover information at the given document position.
49///
50/// This function is the main entry point for the hover command,
51/// called by the Tauri command dispatcher.
52///
53/// # Arguments
54///
55/// * `application_handle` - The Tauri application handle
56/// * `uri` - The URI of the document
57/// * `position` - The position in the document to get hover for
58///
59/// # Returns
60///
61/// Returns a `HoverResponse` containing the hover contents, or an error string.
62pub async fn Hover(application_handle:AppHandle<Wry>, uri:String, position:Value) -> Result<HoverResponse, String> {
63	dev_log!("commands", "[Hover] Providing hover for: {} at {:?}", uri, position);
64
65	// Validate request
66	let request = ValidateRequest(&uri, &position)?;
67
68	// Get the document URI
69	let document_uri = Url::parse(&request.uri).map_err(|e| format!("Failed to parse URI: {}", e))?;
70
71	// Delegate to the provider implementation
72	// Note: This is a stub - actual implementation would call the provider
73	let _result = ProvideHover(document_uri, request.position).await?;
74
75	// For now, return an empty response
76	// DEPENDENCY: Full hover implementation requires provider registry in
77	// ApplicationState and provider invocation via RPC to language server
78	Ok(HoverResponse::default())
79}
80
81/// Internal implementation to get hover from a provider.
82///
83/// This would typically invoke the language feature provider registry
84/// to find an appropriate provider for the document.
85async fn ProvideHover(_uri:Url, _position:Position) -> Result<HoverResponse, String> {
86	// DEPENDENCY: Provider invocation requires:
87	// 1. Provider registry lookup in ApplicationState by document URI
88	// 2. RPC call to language server via CocoonService
89	// 3. Result transformation to HoverResponse
90
91	dev_log!("commands", "[Hover] Calling provider for hover information");
92
93	Ok(HoverResponse::default())
94}
95
96#[cfg(test)]
97mod tests {
98
99	use super::*;
100
101	#[test]
102	fn test_validate_request_valid() {
103		let uri = "file:///test.rs";
104
105		let position = serde_json::json!({
106			"line": 10,
107			"character": 5
108		});
109
110		let result = ValidateRequest(uri, &position);
111
112		assert!(result.is_ok());
113
114		let request = result.unwrap();
115
116		assert_eq!(request.uri, uri);
117
118		assert_eq!(request.position.line, 10);
119
120		assert_eq!(request.position.character, 5);
121	}
122
123	#[test]
124	fn test_validate_request_invalid_uri() {
125		let uri = "not-a-valid-uri";
126
127		let position = serde_json::json!({
128			"line": 10,
129			"character": 5
130		});
131
132		let result = ValidateRequest(uri, &position);
133
134		assert!(result.is_err());
135	}
136
137	#[test]
138	fn test_validate_request_invalid_position() {
139		let uri = "file:///test.rs";
140
141		let position = serde_json::json!({
142			"not_a_position": true
143		});
144
145		let result = ValidateRequest(uri, &position);
146
147		assert!(result.is_err());
148	}
149
150	#[test]
151	fn test_hover_response_default() {
152		let response = HoverResponse::default();
153
154		assert!(response.contents.is_empty());
155
156		assert!(response.range.is_none());
157	}
158
159	#[test]
160	fn test_hover_response_with_contents() {
161		use crate::Command::Hover::Interface::HoverContent::Enum as HoverContent;
162
163		let contents = vec![HoverContent::PlainText("Test hover".to_string())];
164
165		let response = HoverResponse::new(contents);
166
167		assert_eq!(response.contents.len(), 1);
168
169		assert!(response.range.is_none());
170	}
171}
Mountain/Command/Hover/Fn.rs

Mountain/Command/Hover/
Fn.rs
