@ripple-ts/language-server 0.2.178 → 0.2.179

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ripple-ts/language-server",
-  "version": "0.2.178",
+  "version": "0.2.179",
   "description": "Language Server Protocol implementation for Ripple",
   "main": "index.js",
   "bin": {
@@ -19,7 +19,7 @@
     "volar-service-typescript": "0.0.65",
     "vscode-languageserver-textdocument": "^1.0.12",
     "vscode-uri": "^3.1.0",
-    "@ripple-ts/typescript-plugin": "0.2.178"
+    "@ripple-ts/typescript-plugin": "0.2.179"
   },
   "peerDependencies": {
     "typescript": "^5.9.2"

package/src/autoInsertPlugin.js

@@ -1,18 +1,8 @@
 /** @import { LanguageServicePlugin } from '@volar/language-server' */
-/** @import { RippleVirtualCode } from '@ripple-ts/typescript-plugin/src/language.js') */
 
-const { URI } = require('vscode-uri');
+const { getVirtualCode, createLogging } = require('./utils.js');
 
-const DEBUG = process.env.RIPPLE_DEBUG === 'true';
-
-/**
- * @param {...unknown} args
- */
-function log(...args) {
-	if (DEBUG) {
-		console.log('[Ripple Auto-Insert]', ...args);
-	}
-}
+const { log } = createLogging('[Ripple Auto-Insert Plugin]');
 
 /**
  * List of HTML void/self-closing elements that don't need closing tags
@@ -74,18 +64,7 @@ function createAutoInsertPlugin() {
 						return null;
 					}
 
-					const uri = URI.parse(document.uri);
-					const decoded = context.decodeEmbeddedDocumentUri(uri);
-
-					if (!decoded) {
-						return null;
-					}
-
-					const [sourceUri, virtualCodeId] = decoded;
-					const sourceScript = context.language.scripts.get(sourceUri);
-					const virtualCode = /** @type {RippleVirtualCode } */ (
-						sourceScript?.generated?.embeddedCodes.get(virtualCodeId)
-					);
+					const virtualCode = getVirtualCode(document, context);
 
 					// Map position back to source
 					const offset = document.offsetAt(position);

package/src/compileErrorDiagnosticPlugin.js

@@ -1,32 +1,12 @@
-const { RippleVirtualCode } = require('@ripple-ts/typescript-plugin/src/language.js');
-const { URI } = require('vscode-uri');
-
 /**
- * @typedef {import('@volar/language-server').LanguageServicePlugin} LanguageServicePlugin
- * @typedef {import('@volar/language-server').LanguageServiceContext} LanguageServiceContext
- * @typedef {import('@volar/language-server').Diagnostic} Diagnostic
- * @typedef {import('@volar/language-server').DiagnosticSeverity} DiagnosticSeverity
- * @typedef {import('@volar/language-server').Position} Position
- * @typedef {import('vscode-languageserver-textdocument').TextDocument} TextDocument
+ * @import {Diagnostic, LanguageServicePlugin, LanguageServiceContext} from '@volar/language-server'
+ * @import {TextDocument} from 'vscode-languageserver-textdocument'
  */
 
-const DEBUG = process.env.RIPPLE_DEBUG === 'true';
+const { getVirtualCode, createLogging } = require('./utils.js');
 
-/**
- * @param {...unknown} args
- */
-function log(...args) {
-	if (DEBUG) {
-		console.log('[Ripple Language]', ...args);
-	}
-}
-
-/**
- * @param {...unknown} args
- */
-function logError(...args) {
-	console.error('[Ripple Language ERROR]', ...args);
-}
+const { log, logError } = createLogging('[Ripple Compile Error Diagnostic Plugin]');
+const { DiagnosticSeverity } = require('@volar/language-server');
 
 /**
  * @returns {LanguageServicePlugin}
@@ -44,22 +24,16 @@ function createCompileErrorDiagnosticPlugin() {
 		},
 		create(/** @type {LanguageServiceContext} */ context) {
 			return {
-				/**
-				 * @param {TextDocument} document
-				 * @param {import('@volar/language-server').CancellationToken} _token
-				 * @returns {import('@volar/language-server').NullableProviderResult<Diagnostic[]>}
-				 */
 				provideDiagnostics(document, _token) {
 					try {
 						log('Providing Ripple diagnostics for:', document.uri);
 
-						const info = getEmbeddedInfo(context, document);
+						const virtualCode = getVirtualCode(document, context);
 
-						if (!info || !info.virtualCode.errors || info.virtualCode.errors.length === 0) {
+						if (!virtualCode || !virtualCode.errors || virtualCode.errors.length === 0) {
 							return [];
 						}
 
-						const virtualCode = info.virtualCode;
 						const diagnostics = [];
 
 						log('Processing', virtualCode.errors.length, 'errors');
@@ -127,7 +101,7 @@ function parseCompilationErrorWithDocument(error, fallbackFileName, sourceText,
 			const zeroBasedEndColumn = Math.max(0, endColumn);
 
 			return {
-				severity: 1, // DiagnosticSeverity.Error
+				severity: DiagnosticSeverity.Error,
 				range: {
 					start: { line: zeroBasedStartLine, character: zeroBasedStartColumn },
 					end: { line: zeroBasedEndLine, character: zeroBasedEndColumn },
@@ -160,7 +134,7 @@ function parseCompilationErrorWithDocument(error, fallbackFileName, sourceText,
 			let length = Math.min(1, sourceText.split('\n')[zeroBasedLine]?.length - actualColumn || 1);
 
 			return {
-				severity: 1, // DiagnosticSeverity.Error
+				severity: DiagnosticSeverity.Error,
 				range: {
 					start: { line: zeroBasedLine, character: actualColumn },
 					end: { line: zeroBasedLine, character: actualColumn + length },
@@ -175,7 +149,7 @@ function parseCompilationErrorWithDocument(error, fallbackFileName, sourceText,
 			const endPosition = document.positionAt(Math.min(1, sourceText.length));
 
 			return {
-				severity: 1, // DiagnosticSeverity.Error
+				severity: DiagnosticSeverity.Error,
 				range: {
 					start: startPosition,
 					end: endPosition,
@@ -189,7 +163,7 @@ function parseCompilationErrorWithDocument(error, fallbackFileName, sourceText,
 		logError('Error parsing compilation error:', parseError);
 
 		return {
-			severity: 1,
+			severity: DiagnosticSeverity.Error,
 			range: {
 				start: { line: 0, character: 0 },
 				end: { line: 0, character: 1 },
@@ -201,40 +175,6 @@ function parseCompilationErrorWithDocument(error, fallbackFileName, sourceText,
 	}
 }
 
-/**
- * @param {LanguageServiceContext} context
- * @param {TextDocument} document
- */
-function getEmbeddedInfo(context, document) {
-	try {
-		const uri = URI.parse(document.uri);
-		const decoded = context.decodeEmbeddedDocumentUri(uri);
-		if (!decoded) {
-			return;
-		}
-
-		const [documentUri, embeddedCodeId] = decoded;
-
-		const sourceScript = context.language.scripts.get(documentUri);
-		if (!sourceScript?.generated) {
-			return;
-		}
-
-		const virtualCode = sourceScript.generated.embeddedCodes.get(embeddedCodeId);
-		if (!(virtualCode instanceof RippleVirtualCode)) {
-			return;
-		}
-
-		return {
-			sourceScript: sourceScript,
-			virtualCode,
-		};
-	} catch (err) {
-		logError('Failed to get embedded info:', err);
-		return null;
-	}
-}
-
 module.exports = {
 	createCompileErrorDiagnosticPlugin,
 };

package/src/completionPlugin.js

@@ -1,20 +1,11 @@
 /**
- * @typedef {import('@volar/language-server').LanguageServicePlugin} LanguageServicePlugin
+ * @import {LanguageServicePlugin} from '@volar/language-server'
  */
 
 const { CompletionItemKind, InsertTextFormat } = require('@volar/language-server');
-const { URI } = require('vscode-uri');
+const { getVirtualCode, createLogging } = require('./utils.js');
 
-const DEBUG = process.env.RIPPLE_DEBUG === 'true';
-
-/**
- * @param {...unknown} args
- */
-function log(...args) {
-	if (DEBUG) {
-		console.log('[Ripple Completion]', ...args);
-	}
-}
+const { log } = createLogging('[Ripple Completion Plugin]');
 
 /**
  * Ripple-specific completion enhancements
@@ -143,6 +134,15 @@ const RIPPLE_SNIPPETS = [
 		insertTextFormat: InsertTextFormat.Snippet,
 		sortText: '0-untrack',
 	},
+	{
+		label: 'try-pending',
+		kind: CompletionItemKind.Snippet,
+		detail: 'try...pending block',
+		documentation: 'Handle async content with loading fallback',
+		insertText: "try {\n\t$1\n} pending {\n\t<div>{'Loading...'}</div>\n}",
+		insertTextFormat: InsertTextFormat.Snippet,
+		sortText: '0-try-pending',
+	},
 ];
 
 /**
@@ -217,22 +217,13 @@ function createCompletionPlugin() {
 						return { items: [], isIncomplete: false };
 					}
 
+					const virtualCode = getVirtualCode(document, context);
+
 					// Check if we're inside an embedded code (like CSS in <style> blocks)
 					// If so, don't provide Ripple snippets - let CSS completions take priority
-					const uri = URI.parse(document.uri);
-					const decoded = context.decodeEmbeddedDocumentUri(uri);
-					if (decoded) {
-						const [documentUri, embeddedCodeId] = decoded;
-						const sourceScript = context.language.scripts.get(documentUri);
-
-						if (sourceScript?.generated) {
-							const virtualCode = sourceScript.generated.embeddedCodes.get(embeddedCodeId);
-							// If we're in a CSS embedded code (from <style> blocks), skip Ripple completions
-							if (virtualCode && virtualCode.languageId === 'css') {
-								log('Skipping Ripple completions in CSS context');
-								return { items: [], isIncomplete: false };
-							}
-						}
+					if (virtualCode && virtualCode.languageId === 'css') {
+						log('Skipping Ripple completions in CSS context');
+						return { items: [], isIncomplete: false };
 					}
 
 					const line = document.getText({
@@ -296,26 +287,6 @@ function createCompletionPlugin() {
 	};
 }
 
-/**
- * Heuristic to detect if we're inside a component template
- * @param {string} text
- * @returns {boolean}
- */
-function isLikelyInTemplate(text) {
-	// Simple heuristic: inside component body after opening brace
-	const componentMatch = text.match(/component\s+\w+\([^)]*\)\s*\{/);
-	if (!componentMatch || componentMatch.index === undefined) return false;
-
-	// Count braces to see if we're inside
-	let braceCount = 0;
-	for (let i = componentMatch.index + componentMatch[0].length; i < text.length; i++) {
-		if (text[i] === '{') braceCount++;
-		if (text[i] === '}') braceCount--;
-	}
-
-	return braceCount > 0;
-}
-
 module.exports = {
 	createCompletionPlugin,
 };

package/src/definitionPlugin.js

@@ -1,18 +1,8 @@
 /** @import { LanguageServicePlugin } from '@volar/language-server' */
-/** @import { RippleVirtualCode } from '@ripple-ts/typescript-plugin/src/language.js') */
 
-const { URI } = require('vscode-uri');
+const { getVirtualCode, createLogging } = require('./utils.js');
 
-const DEBUG = process.env.RIPPLE_DEBUG === 'true';
-
-/**
- * @param {...unknown} args
- */
-function log(...args) {
-	if (DEBUG) {
-		console.log('[Ripple Definition]', ...args);
-	}
-}
+const { log } = createLogging('[Ripple Definition Plugin]');
 
 /**
  * @returns {LanguageServicePlugin}
@@ -26,9 +16,6 @@ function createDefinitionPlugin() {
 		create(context) {
 			return {
 				async provideDefinition(document, position, token) {
-					const uri = URI.parse(document.uri);
-					const decoded = context.decodeEmbeddedDocumentUri(uri);
-
 					// Get TypeScript definition from typescript-semantic service
 					let tsDefinitions = [];
 					for (const [plugin, instance] of context.plugins) {
@@ -47,17 +34,6 @@ function createDefinitionPlugin() {
 						return;
 					}
 
-					// If not in a Ripple embedded context, just return TypeScript results
-					if (!decoded) {
-						return tsDefinitions;
-					}
-
-					const [sourceUri, virtualCodeId] = decoded;
-					const sourceScript = context.language.scripts.get(sourceUri);
-					const virtualCode = /** @type {RippleVirtualCode } */ (
-						sourceScript?.generated?.embeddedCodes.get(virtualCodeId)
-					);
-
 					// Get the range from TypeScript's definition to find the exact token
 					// This gives us the precise start and end of the token (e.g., "function")
 					const firstDefinition = tsDefinitions[0];
@@ -69,6 +45,8 @@ function createDefinitionPlugin() {
 					const rangeStart = document.offsetAt(range.start);
 					const rangeEnd = document.offsetAt(range.end);
 
+					const virtualCode = getVirtualCode(document, context);
+
 					// Find the mapping using the exact token range for O(1) lookup
 					const mapping = virtualCode.findMappingByGeneratedRange(rangeStart, rangeEnd);
 

package/src/documentHighlightPlugin.js

@@ -0,0 +1,121 @@
+/** @import { LanguageServicePlugin } from '@volar/language-server' */
+/** @import { LanguageServicePluginInstance } from '@volar/language-server' */
+
+const { getVirtualCode, getWordFromPosition, createLogging } = require('./utils.js');
+const { log } = createLogging('[Ripple Document Highlight Plugin]');
+
+/**
+ * Document Highlight plugin for Ripple
+ * Provides word highlighting (grey background) for custom Ripple keywords like 'pending'
+ * @returns {LanguageServicePlugin}
+ */
+function createDocumentHighlightPlugin() {
+	return {
+		name: 'ripple-document-highlight',
+		capabilities: {
+			documentHighlightProvider: true,
+		},
+		create(context) {
+			/** @type {LanguageServicePluginInstance['provideDocumentHighlights']} */
+			let originalProvideDocumentHighlights;
+			/** @type {LanguageServicePluginInstance} */
+			let originalInstance;
+
+			// Get TypeScript's document highlights provider
+			for (const [plugin, instance] of context.plugins) {
+				if (plugin.name === 'typescript-semantic' && instance.provideDocumentHighlights) {
+					originalInstance = instance;
+					originalProvideDocumentHighlights = instance.provideDocumentHighlights;
+					instance.provideDocumentHighlights = undefined;
+					break;
+				}
+			}
+
+			if (!originalProvideDocumentHighlights) {
+				log(
+					"'typescript-semantic plugin' was not found or has no 'provideDocumentHighlights'. \
+					Document highlights will be limited to custom Ripple keywords only.",
+				);
+			}
+
+			return {
+				async provideDocumentHighlights(document, position, token) {
+					if (!originalProvideDocumentHighlights) {
+						return null;
+					}
+
+					let tsHighlights = await originalProvideDocumentHighlights.call(
+						originalInstance,
+						document,
+						position,
+						token,
+					);
+
+					if (!tsHighlights || tsHighlights.length > 0) {
+						// If TypeScript recognized tokens and provided highlights, return them
+						return tsHighlights;
+					}
+
+					const virtualCode = getVirtualCode(document, context);
+
+					if (!virtualCode) {
+						return tsHighlights;
+					}
+
+					// Check if we're on a custom Ripple keyword
+					const offset = document.offsetAt(position);
+					const text = document.getText();
+
+					// Find word boundaries
+					const { word } = getWordFromPosition(text, offset);
+
+					// If the word is a Ripple keyword, find all occurrences in the document
+
+					const regex = new RegExp(`\\b${word}\\b`, 'g');
+					let match;
+
+					while ((match = regex.exec(text)) !== null) {
+						const start = match.index;
+						const end = match.index + word.length;
+						const mapping = virtualCode.findMappingByGeneratedRange(start, end);
+
+						if (!mapping) {
+							// If no mapping, skip all others as well
+							// This shouldn't happen as TS handles only mapped ranges
+							return tsHighlights;
+						}
+
+						if (!mapping.data.customData?.wordHighlight?.kind) {
+							// Skip if we didn't define word highlighting in segments
+							continue;
+						}
+
+						if (!tsHighlights) {
+							tsHighlights = [];
+						}
+
+						tsHighlights.push({
+							range: {
+								start: document.positionAt(start),
+								end: document.positionAt(end),
+							},
+
+							kind: mapping.data.customData.wordHighlight.kind,
+						});
+					}
+
+					if (tsHighlights.length > 0) {
+						log(`Found ${tsHighlights.length} occurrences of '${word}'`);
+					}
+
+					// Return TypeScript highlights if no custom keyword was found
+					return [...tsHighlights];
+				},
+			};
+		},
+	};
+}
+
+module.exports = {
+	createDocumentHighlightPlugin,
+};

package/src/hoverPlugin.js

@@ -1,26 +1,9 @@
 /** @import { LanguageServicePlugin } from '@volar/language-server' */
-/** @import { RippleVirtualCode } from '@ripple-ts/typescript-plugin/src/language.js') */
 /** @import { LanguageServicePluginInstance } from '@volar/language-server' */
 
-const { URI } = require('vscode-uri');
+const { getVirtualCode, createLogging } = require('./utils.js');
 
-const DEBUG = process.env.RIPPLE_DEBUG === 'true';
-
-/**
- * @param {...unknown} args
- */
-function log(...args) {
-	if (DEBUG) {
-		console.log('[Ripple Hover]', ...args);
-	}
-}
-
-/**
- * @param {...unknown} args
- */
-function logError(...args) {
-	console.error('[Ripple Hover]', ...args);
-}
+const { log, logError } = createLogging('[Ripple Hover Plugin]');
 
 /**
  * @returns {LanguageServicePlugin}
@@ -55,9 +38,6 @@ function createHoverPlugin() {
 			}
 			return {
 				async provideHover(document, position, token) {
-					const uri = URI.parse(document.uri);
-					const decoded = context.decodeEmbeddedDocumentUri(uri);
-
 					// Get TypeScript hover from typescript-semantic service
 					let tsHover = null;
 					if (originalProvideHover) {
@@ -65,23 +45,13 @@ function createHoverPlugin() {
 					}
 
 					// If no TypeScript hover, nothing to modify
-					if (!tsHover) {
+					if (!tsHover || !tsHover.range) {
 						return;
 					}
 
-					// If not in a Ripple embedded context, just return TypeScript results
-					if (!decoded) {
-						return tsHover;
-					}
-
-					const [sourceUri, virtualCodeId] = decoded;
-					const sourceScript = context.language.scripts.get(sourceUri);
-					const virtualCode = /** @type {RippleVirtualCode } */ (
-						sourceScript?.generated?.embeddedCodes.get(virtualCodeId)
-					);
+					const virtualCode = getVirtualCode(document, context);
 
-					// If there's no range to adjust, return as-is
-					if (!tsHover.range) {
+					if (!virtualCode) {
 						return tsHover;
 					}
 

package/src/server.js

@@ -1,4 +1,7 @@
-const {
+/** @import {CompilerOptions} from 'typescript' */
+
+const { createLogging } = require('./utils.js');
+const {
 	createConnection,
 	createServer,
 	createTypeScriptProject,
@@ -9,6 +12,7 @@ const { createHoverPlugin } = require('./hoverPlugin.js');
 const { createCompletionPlugin } = require('./completionPlugin.js');
 const { createAutoInsertPlugin } = require('./autoInsertPlugin.js');
 const { createTypeScriptDiagnosticFilterPlugin } = require('./typescriptDiagnosticPlugin.js');
+const { createDocumentHighlightPlugin } = require('./documentHighlightPlugin.js');
 const {
 	getRippleLanguagePlugin,
 	resolveConfig,
@@ -16,25 +20,7 @@ const {
 const { createTypeScriptServices } = require('./typescriptService.js');
 const { create: createCssService } = require('volar-service-css');
 
-const DEBUG = process.env.RIPPLE_DEBUG === 'true';
-
-/** @typedef {import('typescript').CompilerOptions} CompilerOptions */
-
-/**
- * @param {...unknown} args
- */
-function log(...args) {
-	if (DEBUG) {
-		console.log('[Ripple Server]', ...args);
-	}
-}
-
-/**
- * @param {...unknown} args
- */
-function logError(...args) {
-	console.error('[Ripple Server ERROR]', ...args);
-}
+const { log, logError } = createLogging('[Ripple Language Server]');
 
 function createRippleLanguageServer() {
 	const connection = createConnection();
@@ -115,11 +101,12 @@ function createRippleLanguageServer() {
 					createDefinitionPlugin(),
 					createCssService(),
 					...createTypeScriptServices(ts),
-					// !IMPORTANT 'createTypeScriptDiagnosticFilterPlugin' and 'createHoverPlugin'
-					// must come after TypeScript services
+					// !IMPORTANT 'createTypeScriptDiagnosticFilterPlugin', 'createHoverPlugin',
+					// and 'createDocumentHighlightPlugin' must come after TypeScript services
 					// to intercept volar's and vscode default providers
 					createTypeScriptDiagnosticFilterPlugin(),
 					createHoverPlugin(),
+					createDocumentHighlightPlugin(),
 				],
 			);
 

package/src/typescriptDiagnosticPlugin.js

@@ -1,31 +1,11 @@
 /** @import { LanguageServicePlugin } from '@volar/language-server' */
 /** @import { LanguageServicePluginInstance } from '@volar/language-server' */
 
-// @ts-expect-error type-only import from ESM module into CJS is fine
-/** @import { CodeMapping } from 'ripple/compiler' */
+const { getVirtualCode, createLogging } = require('./utils.js');
 
-const { getVirtualCode } = require('./utils.js');
-
-const DEBUG = process.env.RIPPLE_DEBUG === 'true';
-
-/**
- * @param {...unknown} args
- */
-function log(...args) {
-	if (DEBUG) {
-		console.log('[Ripple Typescript Diagnostics]', ...args);
-	}
-}
+const { log, logError } = createLogging('[Ripple TypeScript Diagnostic Plugin]');
 
 /**
- * @param {...unknown} args
- */
-function logError(...args) {
-	console.error('[Ripple Typescript Diagnostics]', ...args);
-}
-
-/**
- * Create a plugin to filter TypeScript diagnostics based on customData in mappings
  * @returns {LanguageServicePlugin}
  */
 function createTypeScriptDiagnosticFilterPlugin() {
@@ -45,7 +25,7 @@ function createTypeScriptDiagnosticFilterPlugin() {
 			/** @type {LanguageServicePluginInstance} */
 			let originalInstance;
 
-			// Disable typescript-semantic's provideHover so it doesn't merge with ours
+			// Disable typescript-semantic's provideDiagnostics so it doesn't merge with ours
 			for (const [plugin, instance] of context.plugins) {
 				if (plugin.name === 'typescript-semantic') {
 					originalInstance = instance;
@@ -118,54 +98,6 @@ function createTypeScriptDiagnosticFilterPlugin() {
 	};
 }
 
-/**
- * Get the mapping at a specific position in the document
- * @param {import('@volar/language-server').LanguageServiceContext} context
- * @param {import('vscode-languageserver-textdocument').TextDocument} document
- * @param {import('@volar/language-server').Position} position
- * @returns {CodeMapping | null}
- */
-function getMappingAtPosition(context, document, position) {
-	try {
-		const { URI } = require('vscode-uri');
-		const { RippleVirtualCode } = require('@ripple-ts/typescript-plugin/src/language.js');
-
-		const uri = URI.parse(document.uri);
-		const decoded = context.decodeEmbeddedDocumentUri(uri);
-		if (!decoded) {
-			return null;
-		}
-
-		const [sourceUri, virtualCodeId] = decoded;
-		const sourceScript = context.language.scripts.get(sourceUri);
-		const virtualCode = /** @type {RippleVirtualCode} */ (
-			sourceScript?.generated?.embeddedCodes.get(virtualCodeId)
-		);
-
-		if (!virtualCode?.mappings) {
-			return null;
-		}
-
-		// Convert position to offset in the virtual document
-		const offset = document.offsetAt(position);
-
-		// Find mapping that contains this offset
-		for (const mapping of virtualCode.mappings) {
-			const genStart = mapping.generatedOffsets[0];
-			const genEnd = genStart + mapping.lengths[0];
-
-			if (offset >= genStart && offset < genEnd) {
-				return mapping;
-			}
-		}
-
-		return null;
-	} catch (err) {
-		log('Error getting mapping at position:', err);
-		return null;
-	}
-}
-
 module.exports = {
 	createTypeScriptDiagnosticFilterPlugin,
 };

package/src/typescriptService.js

@@ -1,6 +1,6 @@
 /**
- * @typedef {import('@volar/language-server').LanguageServiceContext} LanguageServiceContext
- * @typedef {import('vscode-languageserver-textdocument').TextDocument} TextDocument
+ * @import {LanguageServiceContext} from '@volar/language-server'
+ * @import {TextDocument} from 'vscode-languageserver-textdocument'
  */
 
 // Monkey-patch getUserPreferences before requiring the main module

package/src/utils.js

@@ -3,6 +3,7 @@
 /** @import {RippleVirtualCode} from '@ripple-ts/typescript-plugin/src/language.js' */
 
 const { URI } = require('vscode-uri');
+const { createLogging, DEBUG } = require('@ripple-ts/typescript-plugin/src/utils.js');
 
 /**
  * Get virtual code from the encoded document URI
@@ -24,6 +25,34 @@ function getVirtualCode(document, context) {
 	return virtualCode;
 }
 
+/**
+ * Get the word at a specific position in the text
+ * @param {string} text
+ * @param {number} start
+ * @returns {{word: string, start: number, end: number}}
+ */
+function getWordFromPosition(text, start) {
+	let wordStart = start;
+	let wordEnd = start;
+	while (wordStart > 0 && /\w/.test(text[wordStart - 1])) {
+		wordStart--;
+	}
+	while (wordEnd < text.length && /\w/.test(text[wordEnd])) {
+		wordEnd++;
+	}
+
+	const word = text.substring(wordStart, wordEnd);
+
+	return {
+		word,
+		start: wordStart,
+		end: wordEnd,
+	};
+}
+
 module.exports = {
 	getVirtualCode,
+	getWordFromPosition,
+	createLogging,
+	DEBUG,
 };