@rejot-dev/thalo-lsp 0.0.0

package/dist/handlers/completions/providers/type-expr.js

@@ -0,0 +1,56 @@
+import { PRIMITIVE_TYPES } from "@rejot-dev/thalo";
+
+//#region src/handlers/completions/providers/type-expr.ts
+/**
+* Get description for a primitive type.
+*/
+function getPrimitiveTypeDescription(type) {
+	switch (type) {
+		case "string": return "Any text value";
+		case "datetime": return "Date value (YYYY-MM-DD)";
+		case "daterange": return "Date range (YYYY ~ YYYY, YYYY-MM, YYYY Q1, etc.)";
+		case "link": return "Reference to another entry (^link-id)";
+		case "number": return "Numeric value (integer or float)";
+	}
+}
+/**
+* Provider for type expression completion in schema field definitions.
+*/
+const typeExprProvider = {
+	name: "type-expr",
+	contextKinds: ["field_type"],
+	getCompletions(ctx, _workspace) {
+		const partial = ctx.partial.toLowerCase();
+		const items = [];
+		for (const type of PRIMITIVE_TYPES) {
+			if (partial && !type.toLowerCase().startsWith(partial)) continue;
+			items.push({
+				label: type,
+				kind: 25,
+				detail: "Primitive type",
+				documentation: {
+					kind: "markdown",
+					value: getPrimitiveTypeDescription(type)
+				},
+				insertText: type,
+				filterText: type
+			});
+		}
+		if (!partial || "\"".startsWith(partial)) items.push({
+			label: "\"...\"",
+			kind: 12,
+			detail: "Literal type",
+			documentation: {
+				kind: "markdown",
+				value: "Define a literal value type (e.g., \"article\" | \"video\")"
+			},
+			insertText: "\"",
+			filterText: "\""
+		});
+		return items;
+	}
+};
+
+//#endregion
+export { typeExprProvider };
+//# sourceMappingURL=type-expr.js.map

package/dist/handlers/completions/providers/type-expr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-expr.js","names":["typeExprProvider: CompletionProvider","items: CompletionItem[]"],"sources":["../../../../src/handlers/completions/providers/type-expr.ts"],"sourcesContent":["import type { CompletionItem, CompletionItemKind } from \"vscode-languageserver\";\nimport type { Workspace } from \"@rejot-dev/thalo\";\nimport { PRIMITIVE_TYPES, type PrimitiveType } from \"@rejot-dev/thalo\";\nimport type { CompletionContext } from \"../context.js\";\nimport type { CompletionProvider } from \"../completions.js\";\n\n/**\n * Get description for a primitive type.\n */\nfunction getPrimitiveTypeDescription(type: PrimitiveType): string {\n  switch (type) {\n    case \"string\":\n      return \"Any text value\";\n    case \"datetime\":\n      return \"Date value (YYYY-MM-DD)\";\n    case \"daterange\":\n      return \"Date range (YYYY ~ YYYY, YYYY-MM, YYYY Q1, etc.)\";\n    case \"link\":\n      return \"Reference to another entry (^link-id)\";\n    case \"number\":\n      return \"Numeric value (integer or float)\";\n  }\n}\n\n/**\n * Provider for type expression completion in schema field definitions.\n */\nexport const typeExprProvider: CompletionProvider = {\n  name: \"type-expr\",\n  contextKinds: [\"field_type\"],\n\n  getCompletions(ctx: CompletionContext, _workspace: Workspace): CompletionItem[] {\n    const partial = ctx.partial.toLowerCase();\n    const items: CompletionItem[] = [];\n\n    // Suggest primitive types\n    for (const type of PRIMITIVE_TYPES) {\n      if (partial && !type.toLowerCase().startsWith(partial)) {\n        continue;\n      }\n\n      items.push({\n        label: type,\n        kind: 25 as CompletionItemKind, // TypeParameter\n        detail: \"Primitive type\",\n        documentation: {\n          kind: \"markdown\",\n          value: getPrimitiveTypeDescription(type),\n        },\n        insertText: type,\n        filterText: type,\n      });\n    }\n\n    // Suggest starting a literal type with quote\n    if (!partial || '\"'.startsWith(partial)) {\n      items.push({\n        label: '\"...\"',\n        kind: 12 as CompletionItemKind, // Value\n        detail: \"Literal type\",\n        documentation: {\n          kind: \"markdown\",\n          value: 'Define a literal value type (e.g., \"article\" | \"video\")',\n        },\n        insertText: '\"',\n        filterText: '\"',\n      });\n    }\n\n    return items;\n  },\n};\n"],"mappings":";;;;;;AASA,SAAS,4BAA4B,MAA6B;AAChE,SAAQ,MAAR;EACE,KAAK,SACH,QAAO;EACT,KAAK,WACH,QAAO;EACT,KAAK,YACH,QAAO;EACT,KAAK,OACH,QAAO;EACT,KAAK,SACH,QAAO;;;;;;AAOb,MAAaA,mBAAuC;CAClD,MAAM;CACN,cAAc,CAAC,aAAa;CAE5B,eAAe,KAAwB,YAAyC;EAC9E,MAAM,UAAU,IAAI,QAAQ,aAAa;EACzC,MAAMC,QAA0B,EAAE;AAGlC,OAAK,MAAM,QAAQ,iBAAiB;AAClC,OAAI,WAAW,CAAC,KAAK,aAAa,CAAC,WAAW,QAAQ,CACpD;AAGF,SAAM,KAAK;IACT,OAAO;IACP,MAAM;IACN,QAAQ;IACR,eAAe;KACb,MAAM;KACN,OAAO,4BAA4B,KAAK;KACzC;IACD,YAAY;IACZ,YAAY;IACb,CAAC;;AAIJ,MAAI,CAAC,WAAW,KAAI,WAAW,QAAQ,CACrC,OAAM,KAAK;GACT,OAAO;GACP,MAAM;GACN,QAAQ;GACR,eAAe;IACb,MAAM;IACN,OAAO;IACR;GACD,YAAY;GACZ,YAAY;GACb,CAAC;AAGJ,SAAO;;CAEV"}

package/dist/handlers/definition.js

@@ -0,0 +1,166 @@
+import { parseDocument } from "@rejot-dev/thalo/native";
+import { findDefinition, findEntityDefinition, findFieldDefinition, findNodeAtPosition, findSectionDefinition } from "@rejot-dev/thalo";
+
+//#region src/handlers/definition.ts
+/**
+* Convert a file path to a URI
+*/
+function pathToUri(path) {
+	if (!path.startsWith("file://")) return `file://${encodeURIComponent(path).replace(/%2F/g, "/")}`;
+	return path;
+}
+/**
+* Get the file type from a URI
+*/
+function getFileType(uri) {
+	if (uri.endsWith(".thalo")) return "thalo";
+	if (uri.endsWith(".md")) return "markdown";
+	return "thalo";
+}
+/**
+* Convert LSP Position to thalo Position (both are 0-based).
+*/
+function lspToThaloPosition(pos) {
+	return {
+		line: pos.line,
+		column: pos.character
+	};
+}
+/**
+* Handle textDocument/definition request
+*
+* Finds the definition location for various syntax elements at the given position:
+* - ^link-id → Entry definition
+* - Entity name in instance/alter-entity → define-entity
+* - Metadata key → Field definition in schema
+* - Section header → Section definition in schema
+*
+* Supports both standalone .thalo files and thalo blocks embedded in markdown.
+*
+* @param workspace - The thalo workspace
+* @param document - The text document
+* @param position - The position in the document (line/character)
+* @returns The definition location, or null if not found
+*/
+function handleDefinition(workspace, document, position) {
+	const fileType = getFileType(document.uri);
+	try {
+		const context = findNodeAtPosition(parseDocument(document.getText(), {
+			fileType,
+			filename: document.uri
+		}), lspToThaloPosition(position));
+		switch (context.kind) {
+			case "link": {
+				const result = findDefinition(workspace, context.linkId);
+				if (result) return {
+					uri: pathToUri(result.file),
+					range: {
+						start: {
+							line: result.location.startPosition.row,
+							character: result.location.startPosition.column
+						},
+						end: {
+							line: result.location.endPosition.row,
+							character: result.location.endPosition.column
+						}
+					}
+				};
+				return null;
+			}
+			case "entity":
+			case "schema_entity": {
+				const result = findEntityDefinition(workspace, context.kind === "entity" ? context.entityName : context.entityName);
+				if (result) return {
+					uri: pathToUri(result.file),
+					range: {
+						start: {
+							line: result.location.startPosition.row,
+							character: result.location.startPosition.column
+						},
+						end: {
+							line: result.location.endPosition.row,
+							character: result.location.endPosition.column
+						}
+					}
+				};
+				return null;
+			}
+			case "metadata_key": {
+				const result = findFieldDefinition(workspace, context.key, context.entityContext);
+				if (result) return {
+					uri: pathToUri(result.file),
+					range: {
+						start: {
+							line: result.location.startPosition.row,
+							character: result.location.startPosition.column
+						},
+						end: {
+							line: result.location.endPosition.row,
+							character: result.location.endPosition.column
+						}
+					}
+				};
+				return null;
+			}
+			case "section_header": {
+				const result = findSectionDefinition(workspace, context.sectionName, context.entityContext);
+				if (result) return {
+					uri: pathToUri(result.file),
+					range: {
+						start: {
+							line: result.location.startPosition.row,
+							character: result.location.startPosition.column
+						},
+						end: {
+							line: result.location.endPosition.row,
+							character: result.location.endPosition.column
+						}
+					}
+				};
+				return null;
+			}
+			case "field_name": {
+				const result = findFieldDefinition(workspace, context.fieldName, context.entityContext);
+				if (result) return {
+					uri: pathToUri(result.file),
+					range: {
+						start: {
+							line: result.location.startPosition.row,
+							character: result.location.startPosition.column
+						},
+						end: {
+							line: result.location.endPosition.row,
+							character: result.location.endPosition.column
+						}
+					}
+				};
+				return null;
+			}
+			case "section_name": {
+				const result = findSectionDefinition(workspace, context.sectionName, context.entityContext);
+				if (result) return {
+					uri: pathToUri(result.file),
+					range: {
+						start: {
+							line: result.location.startPosition.row,
+							character: result.location.startPosition.column
+						},
+						end: {
+							line: result.location.endPosition.row,
+							character: result.location.endPosition.column
+						}
+					}
+				};
+				return null;
+			}
+			default: return null;
+		}
+	} catch (error) {
+		console.error(`[thalo-lsp] Error in definition handler:`, error);
+		return null;
+	}
+}
+
+//#endregion
+export { handleDefinition };
+//# sourceMappingURL=definition.js.map

package/dist/handlers/definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.js","names":[],"sources":["../../src/handlers/definition.ts"],"sourcesContent":["import type { Position, Location } from \"vscode-languageserver\";\nimport type { TextDocument } from \"vscode-languageserver-textdocument\";\nimport {\n  findNodeAtPosition,\n  findDefinition,\n  findEntityDefinition,\n  findFieldDefinition,\n  findSectionDefinition,\n  type Workspace,\n  type Position as ThaloPosition,\n} from \"@rejot-dev/thalo\";\nimport { parseDocument } from \"@rejot-dev/thalo/native\";\n\n/**\n * Convert a file path to a URI\n */\nfunction pathToUri(path: string): string {\n  // Add file:// prefix if not present\n  if (!path.startsWith(\"file://\")) {\n    return `file://${encodeURIComponent(path).replace(/%2F/g, \"/\")}`;\n  }\n  return path;\n}\n\n/**\n * Get the file type from a URI\n */\nfunction getFileType(uri: string): \"thalo\" | \"markdown\" {\n  if (uri.endsWith(\".thalo\")) {\n    return \"thalo\";\n  }\n  if (uri.endsWith(\".md\")) {\n    return \"markdown\";\n  }\n  return \"thalo\";\n}\n\n/**\n * Convert LSP Position to thalo Position (both are 0-based).\n */\nfunction lspToThaloPosition(pos: Position): ThaloPosition {\n  return { line: pos.line, column: pos.character };\n}\n\n/**\n * Handle textDocument/definition request\n *\n * Finds the definition location for various syntax elements at the given position:\n * - ^link-id → Entry definition\n * - Entity name in instance/alter-entity → define-entity\n * - Metadata key → Field definition in schema\n * - Section header → Section definition in schema\n *\n * Supports both standalone .thalo files and thalo blocks embedded in markdown.\n *\n * @param workspace - The thalo workspace\n * @param document - The text document\n * @param position - The position in the document (line/character)\n * @returns The definition location, or null if not found\n */\nexport function handleDefinition(\n  workspace: Workspace,\n  document: TextDocument,\n  position: Position,\n): Location | null {\n  const fileType = getFileType(document.uri);\n\n  try {\n    // Parse the document\n    const parsed = parseDocument(document.getText(), {\n      fileType,\n      filename: document.uri,\n    });\n\n    // Find what element is at the position using the AST\n    const context = findNodeAtPosition(parsed, lspToThaloPosition(position));\n\n    switch (context.kind) {\n      case \"link\": {\n        // Find the definition for this link\n        const result = findDefinition(workspace, context.linkId);\n        if (result) {\n          return {\n            uri: pathToUri(result.file),\n            range: {\n              start: {\n                line: result.location.startPosition.row,\n                character: result.location.startPosition.column,\n              },\n              end: {\n                line: result.location.endPosition.row,\n                character: result.location.endPosition.column,\n              },\n            },\n          };\n        }\n        return null;\n      }\n\n      case \"entity\":\n      case \"schema_entity\": {\n        // Find the define-entity for this entity\n        const entityName = context.kind === \"entity\" ? context.entityName : context.entityName;\n        const result = findEntityDefinition(workspace, entityName);\n        if (result) {\n          return {\n            uri: pathToUri(result.file),\n            range: {\n              start: {\n                line: result.location.startPosition.row,\n                character: result.location.startPosition.column,\n              },\n              end: {\n                line: result.location.endPosition.row,\n                character: result.location.endPosition.column,\n              },\n            },\n          };\n        }\n        return null;\n      }\n\n      case \"metadata_key\": {\n        // Find the field definition in the schema\n        const result = findFieldDefinition(workspace, context.key, context.entityContext);\n        if (result) {\n          return {\n            uri: pathToUri(result.file),\n            range: {\n              start: {\n                line: result.location.startPosition.row,\n                character: result.location.startPosition.column,\n              },\n              end: {\n                line: result.location.endPosition.row,\n                character: result.location.endPosition.column,\n              },\n            },\n          };\n        }\n        return null;\n      }\n\n      case \"section_header\": {\n        // Find the section definition in the schema\n        const result = findSectionDefinition(workspace, context.sectionName, context.entityContext);\n        if (result) {\n          return {\n            uri: pathToUri(result.file),\n            range: {\n              start: {\n                line: result.location.startPosition.row,\n                character: result.location.startPosition.column,\n              },\n              end: {\n                line: result.location.endPosition.row,\n                character: result.location.endPosition.column,\n              },\n            },\n          };\n        }\n        return null;\n      }\n\n      case \"field_name\": {\n        // In schema definitions, go to the field definition itself\n        const result = findFieldDefinition(workspace, context.fieldName, context.entityContext);\n        if (result) {\n          return {\n            uri: pathToUri(result.file),\n            range: {\n              start: {\n                line: result.location.startPosition.row,\n                character: result.location.startPosition.column,\n              },\n              end: {\n                line: result.location.endPosition.row,\n                character: result.location.endPosition.column,\n              },\n            },\n          };\n        }\n        return null;\n      }\n\n      case \"section_name\": {\n        // In schema definitions, go to the section definition itself\n        const result = findSectionDefinition(workspace, context.sectionName, context.entityContext);\n        if (result) {\n          return {\n            uri: pathToUri(result.file),\n            range: {\n              start: {\n                line: result.location.startPosition.row,\n                character: result.location.startPosition.column,\n              },\n              end: {\n                line: result.location.endPosition.row,\n                character: result.location.endPosition.column,\n              },\n            },\n          };\n        }\n        return null;\n      }\n\n      default:\n        return null;\n    }\n  } catch (error) {\n    console.error(`[thalo-lsp] Error in definition handler:`, error);\n    return null;\n  }\n}\n"],"mappings":"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"}

package/dist/handlers/diagnostics.js

@@ -0,0 +1,77 @@
+import { checkDocument } from "@rejot-dev/thalo";
+
+//#region src/handlers/diagnostics.ts
+/**
+* Map thalo severity to LSP DiagnosticSeverity
+*/
+function mapSeverity(severity) {
+	switch (severity) {
+		case "error": return 1;
+		case "warning": return 2;
+		case "info": return 3;
+		default: return 3;
+	}
+}
+/**
+* Convert a URI to a file path
+*/
+function uriToPath(uri) {
+	if (uri.startsWith("file://")) return decodeURIComponent(uri.slice(7));
+	return uri;
+}
+/**
+* Convert a thalo Diagnostic to an LSP Diagnostic
+*/
+function convertDiagnostic(diagnostic) {
+	return {
+		range: {
+			start: {
+				line: diagnostic.location.startPosition.row,
+				character: diagnostic.location.startPosition.column
+			},
+			end: {
+				line: diagnostic.location.endPosition.row,
+				character: diagnostic.location.endPosition.column
+			}
+		},
+		severity: mapSeverity(diagnostic.severity),
+		code: diagnostic.code,
+		source: "thalo",
+		message: diagnostic.message
+	};
+}
+/**
+* Get diagnostics for a document
+*
+* @param workspace - The thalo workspace
+* @param textDocument - The LSP text document
+* @returns Array of LSP diagnostics
+*/
+function getDiagnostics(workspace, textDocument) {
+	const path = uriToPath(textDocument.uri);
+	if (!workspace.getModel(path)) return [];
+	try {
+		return checkDocument(path, workspace).map(convertDiagnostic);
+	} catch (error) {
+		console.error(`[thalo-lsp] Error checking ${path}:`, error);
+		return [{
+			range: {
+				start: {
+					line: 0,
+					character: 0
+				},
+				end: {
+					line: 0,
+					character: 0
+				}
+			},
+			severity: 1,
+			source: "thalo",
+			message: `Parse error: ${error instanceof Error ? error.message : String(error)}`
+		}];
+	}
+}
+
+//#endregion
+export { getDiagnostics };
+//# sourceMappingURL=diagnostics.js.map

package/dist/handlers/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","names":[],"sources":["../../src/handlers/diagnostics.ts"],"sourcesContent":["import type { Diagnostic as LspDiagnostic, DiagnosticSeverity } from \"vscode-languageserver\";\nimport type { TextDocument } from \"vscode-languageserver-textdocument\";\nimport {\n  checkDocument,\n  type Workspace,\n  type Diagnostic as ThaloDiagnostic,\n  type Severity,\n} from \"@rejot-dev/thalo\";\n\n/**\n * Map thalo severity to LSP DiagnosticSeverity\n */\nfunction mapSeverity(severity: Severity): DiagnosticSeverity {\n  switch (severity) {\n    case \"error\":\n      return 1; // DiagnosticSeverity.Error\n    case \"warning\":\n      return 2; // DiagnosticSeverity.Warning\n    case \"info\":\n      return 3; // DiagnosticSeverity.Information\n    default:\n      return 3;\n  }\n}\n\n/**\n * Convert a URI to a file path\n */\nfunction uriToPath(uri: string): string {\n  if (uri.startsWith(\"file://\")) {\n    return decodeURIComponent(uri.slice(7));\n  }\n  return uri;\n}\n\n/**\n * Convert a thalo Diagnostic to an LSP Diagnostic\n */\nfunction convertDiagnostic(diagnostic: ThaloDiagnostic): LspDiagnostic {\n  return {\n    range: {\n      start: {\n        line: diagnostic.location.startPosition.row,\n        character: diagnostic.location.startPosition.column,\n      },\n      end: {\n        line: diagnostic.location.endPosition.row,\n        character: diagnostic.location.endPosition.column,\n      },\n    },\n    severity: mapSeverity(diagnostic.severity),\n    code: diagnostic.code,\n    source: \"thalo\",\n    message: diagnostic.message,\n  };\n}\n\n/**\n * Get diagnostics for a document\n *\n * @param workspace - The thalo workspace\n * @param textDocument - The LSP text document\n * @returns Array of LSP diagnostics\n */\nexport function getDiagnostics(workspace: Workspace, textDocument: TextDocument): LspDiagnostic[] {\n  const path = uriToPath(textDocument.uri);\n  const model = workspace.getModel(path);\n\n  if (!model) {\n    return [];\n  }\n\n  try {\n    const thaloDiagnostics = checkDocument(path, workspace);\n    return thaloDiagnostics.map(convertDiagnostic);\n  } catch (error) {\n    // Return a diagnostic for parse errors\n    console.error(`[thalo-lsp] Error checking ${path}:`, error);\n    return [\n      {\n        range: {\n          start: { line: 0, character: 0 },\n          end: { line: 0, character: 0 },\n        },\n        severity: 1, // Error\n        source: \"thalo\",\n        message: `Parse error: ${error instanceof Error ? error.message : String(error)}`,\n      },\n    ];\n  }\n}\n"],"mappings":";;;;;;AAYA,SAAS,YAAY,UAAwC;AAC3D,SAAQ,UAAR;EACE,KAAK,QACH,QAAO;EACT,KAAK,UACH,QAAO;EACT,KAAK,OACH,QAAO;EACT,QACE,QAAO;;;;;;AAOb,SAAS,UAAU,KAAqB;AACtC,KAAI,IAAI,WAAW,UAAU,CAC3B,QAAO,mBAAmB,IAAI,MAAM,EAAE,CAAC;AAEzC,QAAO;;;;;AAMT,SAAS,kBAAkB,YAA4C;AACrE,QAAO;EACL,OAAO;GACL,OAAO;IACL,MAAM,WAAW,SAAS,cAAc;IACxC,WAAW,WAAW,SAAS,cAAc;IAC9C;GACD,KAAK;IACH,MAAM,WAAW,SAAS,YAAY;IACtC,WAAW,WAAW,SAAS,YAAY;IAC5C;GACF;EACD,UAAU,YAAY,WAAW,SAAS;EAC1C,MAAM,WAAW;EACjB,QAAQ;EACR,SAAS,WAAW;EACrB;;;;;;;;;AAUH,SAAgB,eAAe,WAAsB,cAA6C;CAChG,MAAM,OAAO,UAAU,aAAa,IAAI;AAGxC,KAAI,CAFU,UAAU,SAAS,KAAK,CAGpC,QAAO,EAAE;AAGX,KAAI;AAEF,SADyB,cAAc,MAAM,UAAU,CAC/B,IAAI,kBAAkB;UACvC,OAAO;AAEd,UAAQ,MAAM,8BAA8B,KAAK,IAAI,MAAM;AAC3D,SAAO,CACL;GACE,OAAO;IACL,OAAO;KAAE,MAAM;KAAG,WAAW;KAAG;IAChC,KAAK;KAAE,MAAM;KAAG,WAAW;KAAG;IAC/B;GACD,UAAU;GACV,QAAQ;GACR,SAAS,gBAAgB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;GAChF,CACF"}

package/dist/handlers/hover.js

@@ -0,0 +1,73 @@
+import { parseDocument } from "@rejot-dev/thalo/native";
+import { findNodeAtPosition, getHoverInfo } from "@rejot-dev/thalo";
+
+//#region src/handlers/hover.ts
+/**
+* Get the file type from a URI
+*/
+function getFileType(uri) {
+	if (uri.endsWith(".thalo")) return "thalo";
+	if (uri.endsWith(".md")) return "markdown";
+	return "thalo";
+}
+/**
+* Convert LSP Position to thalo Position (both are 0-based).
+*/
+function lspToThaloPosition(pos) {
+	return {
+		line: pos.line,
+		column: pos.character
+	};
+}
+/**
+* Handle textDocument/hover request
+*
+* Provides hover information for various syntax elements:
+* - ^link-id: Shows target entry details
+* - #tag: Shows tag usage statistics
+* - Directives: Shows documentation
+* - Entity names: Shows schema with fields and sections
+* - Metadata keys: Shows field type and description
+* - Type expressions: Shows type documentation
+* - Section headers: Shows section description
+* - Timestamps: Shows entry info or link reference hint
+*
+* Supports both standalone .thalo files and thalo blocks embedded in markdown.
+*
+* @param workspace - The thalo workspace
+* @param document - The text document
+* @param position - The hover position
+* @returns Hover information, or null if nothing to show
+*/
+function handleHover(workspace, document, position) {
+	const fileType = getFileType(document.uri);
+	try {
+		const result = getHoverInfo(workspace, findNodeAtPosition(parseDocument(document.getText(), {
+			fileType,
+			filename: document.uri
+		}), lspToThaloPosition(position)));
+		if (!result) return null;
+		const hover = { contents: {
+			kind: "markdown",
+			value: result.content
+		} };
+		if (result.range) hover.range = {
+			start: {
+				line: result.range.startPosition.row,
+				character: result.range.startPosition.column
+			},
+			end: {
+				line: result.range.endPosition.row,
+				character: result.range.endPosition.column
+			}
+		};
+		return hover;
+	} catch (error) {
+		console.error(`[thalo-lsp] Error in hover handler:`, error);
+		return null;
+	}
+}
+
+//#endregion
+export { handleHover };
+//# sourceMappingURL=hover.js.map

package/dist/handlers/hover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hover.js","names":["hover: Hover"],"sources":["../../src/handlers/hover.ts"],"sourcesContent":["import type { Hover, Position } from \"vscode-languageserver\";\nimport type { TextDocument } from \"vscode-languageserver-textdocument\";\nimport {\n  findNodeAtPosition,\n  getHoverInfo,\n  type Workspace,\n  type Position as ThaloPosition,\n} from \"@rejot-dev/thalo\";\nimport { parseDocument } from \"@rejot-dev/thalo/native\";\n\n/**\n * Get the file type from a URI\n */\nfunction getFileType(uri: string): \"thalo\" | \"markdown\" {\n  if (uri.endsWith(\".thalo\")) {\n    return \"thalo\";\n  }\n  if (uri.endsWith(\".md\")) {\n    return \"markdown\";\n  }\n  return \"thalo\";\n}\n\n/**\n * Convert LSP Position to thalo Position (both are 0-based).\n */\nfunction lspToThaloPosition(pos: Position): ThaloPosition {\n  return { line: pos.line, column: pos.character };\n}\n\n/**\n * Handle textDocument/hover request\n *\n * Provides hover information for various syntax elements:\n * - ^link-id: Shows target entry details\n * - #tag: Shows tag usage statistics\n * - Directives: Shows documentation\n * - Entity names: Shows schema with fields and sections\n * - Metadata keys: Shows field type and description\n * - Type expressions: Shows type documentation\n * - Section headers: Shows section description\n * - Timestamps: Shows entry info or link reference hint\n *\n * Supports both standalone .thalo files and thalo blocks embedded in markdown.\n *\n * @param workspace - The thalo workspace\n * @param document - The text document\n * @param position - The hover position\n * @returns Hover information, or null if nothing to show\n */\nexport function handleHover(\n  workspace: Workspace,\n  document: TextDocument,\n  position: Position,\n): Hover | null {\n  const fileType = getFileType(document.uri);\n\n  try {\n    // Parse the document\n    const parsed = parseDocument(document.getText(), {\n      fileType,\n      filename: document.uri,\n    });\n\n    // Find what element is at the position using the AST\n    const context = findNodeAtPosition(parsed, lspToThaloPosition(position));\n\n    // Get hover info from the service\n    const result = getHoverInfo(workspace, context);\n\n    if (!result) {\n      return null;\n    }\n\n    // Convert to LSP Hover format\n    const hover: Hover = {\n      contents: {\n        kind: \"markdown\",\n        value: result.content,\n      },\n    };\n\n    // Add range if available\n    if (result.range) {\n      hover.range = {\n        start: {\n          line: result.range.startPosition.row,\n          character: result.range.startPosition.column,\n        },\n        end: {\n          line: result.range.endPosition.row,\n          character: result.range.endPosition.column,\n        },\n      };\n    }\n\n    return hover;\n  } catch (error) {\n    console.error(`[thalo-lsp] Error in hover handler:`, error);\n    return null;\n  }\n}\n"],"mappings":";;;;;;;AAaA,SAAS,YAAY,KAAmC;AACtD,KAAI,IAAI,SAAS,SAAS,CACxB,QAAO;AAET,KAAI,IAAI,SAAS,MAAM,CACrB,QAAO;AAET,QAAO;;;;;AAMT,SAAS,mBAAmB,KAA8B;AACxD,QAAO;EAAE,MAAM,IAAI;EAAM,QAAQ,IAAI;EAAW;;;;;;;;;;;;;;;;;;;;;;AAuBlD,SAAgB,YACd,WACA,UACA,UACc;CACd,MAAM,WAAW,YAAY,SAAS,IAAI;AAE1C,KAAI;EAWF,MAAM,SAAS,aAAa,WAHZ,mBAND,cAAc,SAAS,SAAS,EAAE;GAC/C;GACA,UAAU,SAAS;GACpB,CAAC,EAGyC,mBAAmB,SAAS,CAAC,CAGzB;AAE/C,MAAI,CAAC,OACH,QAAO;EAIT,MAAMA,QAAe,EACnB,UAAU;GACR,MAAM;GACN,OAAO,OAAO;GACf,EACF;AAGD,MAAI,OAAO,MACT,OAAM,QAAQ;GACZ,OAAO;IACL,MAAM,OAAO,MAAM,cAAc;IACjC,WAAW,OAAO,MAAM,cAAc;IACvC;GACD,KAAK;IACH,MAAM,OAAO,MAAM,YAAY;IAC/B,WAAW,OAAO,MAAM,YAAY;IACrC;GACF;AAGH,SAAO;UACA,OAAO;AACd,UAAQ,MAAM,uCAAuC,MAAM;AAC3D,SAAO"}

package/dist/handlers/references.js

@@ -0,0 +1,233 @@
+import { parseDocument } from "@rejot-dev/thalo/native";
+import { findEntityReferences, findFieldReferences, findNodeAtPosition, findReferences, findSectionReferences, findTagReferences } from "@rejot-dev/thalo";
+
+//#region src/handlers/references.ts
+/**
+* Convert a file path to a URI
+*/
+function pathToUri(path) {
+	if (!path.startsWith("file://")) return `file://${encodeURIComponent(path).replace(/%2F/g, "/")}`;
+	return path;
+}
+/**
+* Get the file type from a URI
+*/
+function getFileType(uri) {
+	if (uri.endsWith(".thalo")) return "thalo";
+	if (uri.endsWith(".md")) return "markdown";
+	return "thalo";
+}
+/**
+* Convert LSP Position to thalo Position (both are 0-based).
+*/
+function lspToThaloPosition(pos) {
+	return {
+		line: pos.line,
+		column: pos.character
+	};
+}
+/**
+* Handle textDocument/references request
+*
+* Finds all references to various syntax elements at the given position:
+* - ^link-id → All usages of that link
+* - #tag → All entries with that tag
+* - Entity name → All entries using that entity type
+* - Metadata key → All entries using that field
+* - Section header → All entries with that section
+*
+* Supports both standalone .thalo files and thalo blocks embedded in markdown.
+*
+* @param workspace - The thalo workspace
+* @param document - The text document
+* @param position - The position in the document (line/character)
+* @param context - Reference context (includeDeclaration)
+* @returns Array of reference locations, or null if not found
+*/
+function handleReferences(workspace, document, position, context) {
+	const fileType = getFileType(document.uri);
+	try {
+		const nodeContext = findNodeAtPosition(parseDocument(document.getText(), {
+			fileType,
+			filename: document.uri
+		}), lspToThaloPosition(position));
+		switch (nodeContext.kind) {
+			case "link": {
+				const result = findReferences(workspace, nodeContext.linkId, context.includeDeclaration);
+				if (result) return result.locations.map((loc) => ({
+					uri: pathToUri(loc.file),
+					range: {
+						start: {
+							line: loc.location.startPosition.row,
+							character: loc.location.startPosition.column
+						},
+						end: {
+							line: loc.location.endPosition.row,
+							character: loc.location.endPosition.column
+						}
+					}
+				}));
+				return null;
+			}
+			case "tag": return findTagReferences(workspace, nodeContext.tagName).references.map((ref) => ({
+				uri: pathToUri(ref.file),
+				range: {
+					start: {
+						line: ref.location.startPosition.row,
+						character: ref.location.startPosition.column
+					},
+					end: {
+						line: ref.location.endPosition.row,
+						character: ref.location.endPosition.column
+					}
+				}
+			}));
+			case "entity":
+			case "schema_entity": return findEntityReferences(workspace, nodeContext.kind === "entity" ? nodeContext.entityName : nodeContext.entityName, context.includeDeclaration).locations.map((loc) => ({
+				uri: pathToUri(loc.file),
+				range: {
+					start: {
+						line: loc.location.startPosition.row,
+						character: loc.location.startPosition.column
+					},
+					end: {
+						line: loc.location.endPosition.row,
+						character: loc.location.endPosition.column
+					}
+				}
+			}));
+			case "metadata_key": {
+				const result = findFieldReferences(workspace, nodeContext.key, nodeContext.entityContext);
+				const locations = [];
+				if (context.includeDeclaration && result.definition) locations.push({
+					uri: pathToUri(result.definition.file),
+					range: {
+						start: {
+							line: result.definition.location.startPosition.row,
+							character: result.definition.location.startPosition.column
+						},
+						end: {
+							line: result.definition.location.endPosition.row,
+							character: result.definition.location.endPosition.column
+						}
+					}
+				});
+				for (const ref of result.references) locations.push({
+					uri: pathToUri(ref.file),
+					range: {
+						start: {
+							line: ref.location.startPosition.row,
+							character: ref.location.startPosition.column
+						},
+						end: {
+							line: ref.location.endPosition.row,
+							character: ref.location.endPosition.column
+						}
+					}
+				});
+				return locations;
+			}
+			case "section_header": {
+				const result = findSectionReferences(workspace, nodeContext.sectionName, nodeContext.entityContext);
+				const locations = [];
+				if (context.includeDeclaration && result.definition) locations.push({
+					uri: pathToUri(result.definition.file),
+					range: {
+						start: {
+							line: result.definition.location.startPosition.row,
+							character: result.definition.location.startPosition.column
+						},
+						end: {
+							line: result.definition.location.endPosition.row,
+							character: result.definition.location.endPosition.column
+						}
+					}
+				});
+				for (const ref of result.references) locations.push({
+					uri: pathToUri(ref.file),
+					range: {
+						start: {
+							line: ref.location.startPosition.row,
+							character: ref.location.startPosition.column
+						},
+						end: {
+							line: ref.location.endPosition.row,
+							character: ref.location.endPosition.column
+						}
+					}
+				});
+				return locations;
+			}
+			case "field_name": {
+				const result = findFieldReferences(workspace, nodeContext.fieldName, nodeContext.entityContext);
+				const locations = [];
+				if (context.includeDeclaration && result.definition) locations.push({
+					uri: pathToUri(result.definition.file),
+					range: {
+						start: {
+							line: result.definition.location.startPosition.row,
+							character: result.definition.location.startPosition.column
+						},
+						end: {
+							line: result.definition.location.endPosition.row,
+							character: result.definition.location.endPosition.column
+						}
+					}
+				});
+				for (const ref of result.references) locations.push({
+					uri: pathToUri(ref.file),
+					range: {
+						start: {
+							line: ref.location.startPosition.row,
+							character: ref.location.startPosition.column
+						},
+						end: {
+							line: ref.location.endPosition.row,
+							character: ref.location.endPosition.column
+						}
+					}
+				});
+				return locations;
+			}
+			case "section_name": {
+				const result = findSectionReferences(workspace, nodeContext.sectionName, nodeContext.entityContext);
+				const locations = [];
+				if (context.includeDeclaration && result.definition) locations.push({
+					uri: pathToUri(result.definition.file),
+					range: {
+						start: {
+							line: result.definition.location.startPosition.row,
+							character: result.definition.location.startPosition.column
+						},
+						end: {
+							line: result.definition.location.endPosition.row,
+							character: result.definition.location.endPosition.column
+						}
+					}
+				});
+				for (const ref of result.references) locations.push({
+					uri: pathToUri(ref.file),
+					range: {
+						start: {
+							line: ref.location.startPosition.row,
+							character: ref.location.startPosition.column
+						},
+						end: {
+							line: ref.location.endPosition.row,
+							character: ref.location.endPosition.column
+						}
+					}
+				});
+				return locations;
+			}
+			default: return null;
+		}
+	} catch (error) {
+		console.error(`[thalo-lsp] Error in references handler:`, error);
+		return null;
+	}
+}
+
+//#endregion
+export { handleReferences };
+//# sourceMappingURL=references.js.map