@rejot-dev/thalo 0.0.0

package/dist/services/entity-navigation.d.ts

@@ -0,0 +1,200 @@
+import { Entry, InstanceEntry, Location, SchemaEntry } from "../ast/ast-types.js";
+import { Workspace } from "../model/workspace.js";
+
+//#region src/services/entity-navigation.d.ts
+
+/**
+ * Result of finding an entity definition (define-entity)
+ */
+interface EntityDefinitionResult {
+  /** The file containing the definition */
+  file: string;
+  /** Location of the definition */
+  location: Location;
+  /** The schema entry that defines this entity */
+  entry: SchemaEntry;
+}
+/**
+ * A reference to an entity (instance entry using that entity type)
+ */
+interface EntityReferenceLocation {
+  /** The file containing the reference */
+  file: string;
+  /** Location of the entry using this entity */
+  location: Location;
+  /** The instance entry using this entity */
+  entry: InstanceEntry | SchemaEntry;
+  /** Whether this is the definition (always false for entity refs) */
+  isDefinition: boolean;
+}
+/**
+ * Result of finding entity references
+ */
+interface EntityReferencesResult {
+  /** The entity name */
+  entityName: string;
+  /** The definition (if it exists) */
+  definition: EntityDefinitionResult | undefined;
+  /** All instance entries using this entity */
+  references: EntityReferenceLocation[];
+  /** All locations (definition + references if includeDefinition) */
+  locations: (EntityDefinitionResult | EntityReferenceLocation)[];
+}
+/**
+ * Find the define-entity for an entity name
+ *
+ * @param workspace - The workspace to search in
+ * @param entityName - The entity name to find
+ * @returns The definition result, or undefined if not found
+ */
+declare function findEntityDefinition(workspace: Workspace, entityName: string): EntityDefinitionResult | undefined;
+/**
+ * Find all references to an entity type
+ *
+ * @param workspace - The workspace to search in
+ * @param entityName - The entity name to find references for
+ * @param includeDefinition - Whether to include the definition in results
+ * @returns The references result
+ */
+declare function findEntityReferences(workspace: Workspace, entityName: string, includeDefinition?: boolean): EntityReferencesResult;
+/**
+ * A reference to a tag (entry with that tag)
+ */
+interface TagReferenceLocation {
+  /** The file containing the reference */
+  file: string;
+  /** Location of the entry with this tag */
+  location: Location;
+  /** The entry with this tag */
+  entry: Entry;
+}
+/**
+ * Result of finding tag references
+ */
+interface TagReferencesResult {
+  /** The tag name (without # prefix) */
+  tagName: string;
+  /** All entries with this tag */
+  references: TagReferenceLocation[];
+}
+/**
+ * Find all entries with a given tag
+ *
+ * @param workspace - The workspace to search in
+ * @param tagName - The tag name (without # prefix)
+ * @returns The references result
+ */
+declare function findTagReferences(workspace: Workspace, tagName: string): TagReferencesResult;
+/**
+ * Result of finding a field definition
+ */
+interface FieldDefinitionResult {
+  /** The file containing the definition */
+  file: string;
+  /** Location of the field definition */
+  location: Location;
+  /** The entity name this field belongs to */
+  entityName: string;
+  /** The schema entry containing this field */
+  schemaEntry: SchemaEntry;
+}
+/**
+ * A reference to a field (instance entry using that metadata key)
+ */
+interface FieldReferenceLocation {
+  /** The file containing the reference */
+  file: string;
+  /** Location of the metadata line */
+  location: Location;
+  /** The instance entry using this field */
+  entry: InstanceEntry;
+}
+/**
+ * Result of finding field references
+ */
+interface FieldReferencesResult {
+  /** The field name */
+  fieldName: string;
+  /** The entity context (if known) */
+  entityName: string | undefined;
+  /** The definition (if it exists) */
+  definition: FieldDefinitionResult | undefined;
+  /** All instance entries using this field */
+  references: FieldReferenceLocation[];
+}
+/**
+ * Find the field definition in a schema
+ *
+ * @param workspace - The workspace to search in
+ * @param fieldName - The field name to find
+ * @param entityName - Optional entity name to constrain the search
+ * @returns The definition result, or undefined if not found
+ */
+declare function findFieldDefinition(workspace: Workspace, fieldName: string, entityName?: string): FieldDefinitionResult | undefined;
+/**
+ * Find all references to a field
+ *
+ * @param workspace - The workspace to search in
+ * @param fieldName - The field name to find references for
+ * @param entityName - Optional entity name to constrain the search
+ * @returns The references result
+ */
+declare function findFieldReferences(workspace: Workspace, fieldName: string, entityName?: string): FieldReferencesResult;
+/**
+ * Result of finding a section definition
+ */
+interface SectionDefinitionResult {
+  /** The file containing the definition */
+  file: string;
+  /** Location of the section definition */
+  location: Location;
+  /** The entity name this section belongs to */
+  entityName: string;
+  /** The schema entry containing this section */
+  schemaEntry: SchemaEntry;
+}
+/**
+ * A reference to a section (instance entry with that section)
+ */
+interface SectionReferenceLocation {
+  /** The file containing the reference */
+  file: string;
+  /** Location of the entry with this section */
+  location: Location;
+  /** The instance entry with this section */
+  entry: InstanceEntry;
+}
+/**
+ * Result of finding section references
+ */
+interface SectionReferencesResult {
+  /** The section name */
+  sectionName: string;
+  /** The entity context (if known) */
+  entityName: string | undefined;
+  /** The definition (if it exists) */
+  definition: SectionDefinitionResult | undefined;
+  /** All instance entries with this section */
+  references: SectionReferenceLocation[];
+}
+/**
+ * Find the section definition in a schema
+ *
+ * @param workspace - The workspace to search in
+ * @param sectionName - The section name to find
+ * @param entityName - Optional entity name to constrain the search
+ * @returns The definition result, or undefined if not found
+ */
+declare function findSectionDefinition(workspace: Workspace, sectionName: string, entityName?: string): SectionDefinitionResult | undefined;
+/**
+ * Find all references to a section
+ *
+ * @param workspace - The workspace to search in
+ * @param sectionName - The section name to find references for
+ * @param entityName - Optional entity name to constrain the search
+ * @returns The references result
+ */
+declare function findSectionReferences(workspace: Workspace, sectionName: string, entityName?: string): SectionReferencesResult;
+//#endregion
+export { EntityDefinitionResult, EntityReferenceLocation, EntityReferencesResult, FieldDefinitionResult, FieldReferenceLocation, FieldReferencesResult, SectionDefinitionResult, SectionReferenceLocation, SectionReferencesResult, TagReferenceLocation, TagReferencesResult, findEntityDefinition, findEntityReferences, findFieldDefinition, findFieldReferences, findSectionDefinition, findSectionReferences, findTagReferences };
+//# sourceMappingURL=entity-navigation.d.ts.map

package/dist/services/entity-navigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-navigation.d.ts","names":[],"sources":["../../src/services/entity-navigation.ts"],"sourcesContent":[],"mappings":";;;;;;;AAUA;AAYiB,UAZA,sBAAA,CAYuB;EAI5B;EAEH,IAAA,EAAA,MAAA;EAAgB;EAAW,QAAA,EAdxB,QAcwB;EAQnB;EAIH,KAAA,EAxBL,WAwBK;;;;;AAcE,UAhCC,uBAAA,CAiCJ;EA6BG;EA0DC,IAAA,EAAA,MAAA;EAYA;EA+BD,QAAA,EA/JJ,QA+JI;EA4BC;EAcA,KAAA,EAvMR,aAuMQ,GAvMQ,WAuMc;EAYtB;EAmBD,YAAA,EAAA,OAAA;AAwDhB;AA8CA;AAcA;AAYA;AAmCgB,UAjYC,sBAAA,CAiYoB;EA0DrB;;;cAvbF;;cAEA;;cAEA,yBAAyB;;;;;;;;;iBAUvB,oBAAA,YACH,gCAEV;;;;;;;;;iBA2Ba,oBAAA,YACH,6DAGV;;;;UAsDc,oBAAA;;;;YAIL;;SAEH;;;;;UAMQ,mBAAA;;;;cAIH;;;;;;;;;iBA2BE,iBAAA,YAA6B,6BAA6B;;;;UA4BzD,qBAAA;;;;YAIL;;;;eAIG;;;;;UAME,sBAAA;;;;YAIL;;SAEH;;;;;UAMQ,qBAAA;;;;;;cAMH;;cAEA;;;;;;;;;;iBAWE,mBAAA,YACH,oDAGV;;;;;;;;;iBAoDa,mBAAA,YACH,oDAGV;;;;UA0Cc,uBAAA;;;;YAIL;;;;eAIG;;;;;UAME,wBAAA;;;;YAIL;;SAEH;;;;;UAMQ,uBAAA;;;;;;cAMH;;cAEA;;;;;;;;;;iBA2BE,qBAAA,YACH,sDAGV;;;;;;;;;iBAsDa,qBAAA,YACH,sDAGV"}

package/dist/services/entity-navigation.js

@@ -0,0 +1,211 @@
+//#region src/services/entity-navigation.ts
+/**
+* Find the define-entity for an entity name
+*
+* @param workspace - The workspace to search in
+* @param entityName - The entity name to find
+* @returns The definition result, or undefined if not found
+*/
+function findEntityDefinition(workspace, entityName) {
+	for (const model of workspace.allModels()) for (const entry of model.ast.entries) if (entry.type === "schema_entry" && entry.header.directive === "define-entity" && entry.header.entityName.value === entityName) return {
+		file: model.file,
+		location: entry.location,
+		entry
+	};
+}
+/**
+* Find all references to an entity type
+*
+* @param workspace - The workspace to search in
+* @param entityName - The entity name to find references for
+* @param includeDefinition - Whether to include the definition in results
+* @returns The references result
+*/
+function findEntityReferences(workspace, entityName, includeDefinition = true) {
+	const definition = findEntityDefinition(workspace, entityName);
+	const references = [];
+	for (const model of workspace.allModels()) for (const entry of model.ast.entries) {
+		if (entry.type === "instance_entry" && entry.header.entity === entityName) references.push({
+			file: model.file,
+			location: entry.location,
+			entry,
+			isDefinition: false
+		});
+		if (entry.type === "schema_entry" && entry.header.directive === "alter-entity" && entry.header.entityName.value === entityName) references.push({
+			file: model.file,
+			location: entry.location,
+			entry,
+			isDefinition: false
+		});
+	}
+	const locations = [];
+	if (includeDefinition && definition) locations.push(definition);
+	locations.push(...references);
+	return {
+		entityName,
+		definition,
+		references,
+		locations
+	};
+}
+/**
+* Get tags from an entry
+*/
+function getEntryTags(entry) {
+	switch (entry.type) {
+		case "instance_entry": return entry.header.tags.map((t) => t.name);
+		case "schema_entry": return entry.header.tags.map((t) => t.name);
+		case "synthesis_entry": return entry.header.tags.map((t) => t.name);
+		case "actualize_entry": return [];
+	}
+}
+/**
+* Find all entries with a given tag
+*
+* @param workspace - The workspace to search in
+* @param tagName - The tag name (without # prefix)
+* @returns The references result
+*/
+function findTagReferences(workspace, tagName) {
+	const references = [];
+	for (const model of workspace.allModels()) for (const entry of model.ast.entries) if (getEntryTags(entry).includes(tagName)) references.push({
+		file: model.file,
+		location: entry.location,
+		entry
+	});
+	return {
+		tagName,
+		references
+	};
+}
+/**
+* Find the field definition in a schema
+*
+* @param workspace - The workspace to search in
+* @param fieldName - The field name to find
+* @param entityName - Optional entity name to constrain the search
+* @returns The definition result, or undefined if not found
+*/
+function findFieldDefinition(workspace, fieldName, entityName) {
+	if (entityName) {
+		const schema = workspace.schemaRegistry.get(entityName);
+		if (schema) {
+			if (schema.fields.get(fieldName)) for (const model of workspace.allModels()) for (const entry of model.ast.entries) {
+				if (entry.type !== "schema_entry") continue;
+				if (entry.header.entityName.value !== entityName) continue;
+				const fieldDef = entry.metadataBlock?.fields.find((f) => f.name.value === fieldName);
+				if (fieldDef) return {
+					file: model.file,
+					location: fieldDef.location,
+					entityName,
+					schemaEntry: entry
+				};
+			}
+		}
+		return;
+	}
+	for (const schemaEntityName of workspace.schemaRegistry.entityNames()) {
+		const result = findFieldDefinition(workspace, fieldName, schemaEntityName);
+		if (result) return result;
+	}
+}
+/**
+* Find all references to a field
+*
+* @param workspace - The workspace to search in
+* @param fieldName - The field name to find references for
+* @param entityName - Optional entity name to constrain the search
+* @returns The references result
+*/
+function findFieldReferences(workspace, fieldName, entityName) {
+	const definition = findFieldDefinition(workspace, fieldName, entityName);
+	const references = [];
+	for (const model of workspace.allModels()) for (const entry of model.ast.entries) {
+		if (entry.type !== "instance_entry") continue;
+		if (entityName && entry.header.entity !== entityName) continue;
+		const meta = entry.metadata.find((m) => m.key.value === fieldName);
+		if (meta) references.push({
+			file: model.file,
+			location: meta.location,
+			entry
+		});
+	}
+	return {
+		fieldName,
+		entityName,
+		definition,
+		references
+	};
+}
+/**
+* Get section names from an instance entry
+*/
+function getEntrySections(entry) {
+	if (!entry.content) return [];
+	return entry.content.children.filter((c) => c.type === "markdown_header").map((h) => {
+		const match = h.text.match(/^#+\s*(.+)$/);
+		return match ? match[1].trim() : h.text;
+	});
+}
+/**
+* Find the section definition in a schema
+*
+* @param workspace - The workspace to search in
+* @param sectionName - The section name to find
+* @param entityName - Optional entity name to constrain the search
+* @returns The definition result, or undefined if not found
+*/
+function findSectionDefinition(workspace, sectionName, entityName) {
+	if (entityName) {
+		const schema = workspace.schemaRegistry.get(entityName);
+		if (schema) {
+			if (schema.sections.get(sectionName)) for (const model of workspace.allModels()) for (const entry of model.ast.entries) {
+				if (entry.type !== "schema_entry") continue;
+				if (entry.header.entityName.value !== entityName) continue;
+				const sectionDef = entry.sectionsBlock?.sections.find((s) => s.name.value === sectionName);
+				if (sectionDef) return {
+					file: model.file,
+					location: sectionDef.location,
+					entityName,
+					schemaEntry: entry
+				};
+			}
+		}
+		return;
+	}
+	for (const schemaEntityName of workspace.schemaRegistry.entityNames()) {
+		const result = findSectionDefinition(workspace, sectionName, schemaEntityName);
+		if (result) return result;
+	}
+}
+/**
+* Find all references to a section
+*
+* @param workspace - The workspace to search in
+* @param sectionName - The section name to find references for
+* @param entityName - Optional entity name to constrain the search
+* @returns The references result
+*/
+function findSectionReferences(workspace, sectionName, entityName) {
+	const definition = findSectionDefinition(workspace, sectionName, entityName);
+	const references = [];
+	for (const model of workspace.allModels()) for (const entry of model.ast.entries) {
+		if (entry.type !== "instance_entry") continue;
+		if (entityName && entry.header.entity !== entityName) continue;
+		if (getEntrySections(entry).includes(sectionName)) references.push({
+			file: model.file,
+			location: entry.location,
+			entry
+		});
+	}
+	return {
+		sectionName,
+		entityName,
+		definition,
+		references
+	};
+}
+
+//#endregion
+export { findEntityDefinition, findEntityReferences, findFieldDefinition, findFieldReferences, findSectionDefinition, findSectionReferences, findTagReferences };
+//# sourceMappingURL=entity-navigation.js.map

package/dist/services/entity-navigation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-navigation.js","names":["references: EntityReferenceLocation[]","locations: (EntityDefinitionResult | EntityReferenceLocation)[]","references: TagReferenceLocation[]","references: FieldReferenceLocation[]","references: SectionReferenceLocation[]"],"sources":["../../src/services/entity-navigation.ts"],"sourcesContent":["import type { Workspace } from \"../model/workspace.js\";\nimport type { Location, Entry, SchemaEntry, InstanceEntry } from \"../ast/ast-types.js\";\n\n// ===================\n// Entity Navigation\n// ===================\n\n/**\n * Result of finding an entity definition (define-entity)\n */\nexport interface EntityDefinitionResult {\n  /** The file containing the definition */\n  file: string;\n  /** Location of the definition */\n  location: Location;\n  /** The schema entry that defines this entity */\n  entry: SchemaEntry;\n}\n\n/**\n * A reference to an entity (instance entry using that entity type)\n */\nexport interface EntityReferenceLocation {\n  /** The file containing the reference */\n  file: string;\n  /** Location of the entry using this entity */\n  location: Location;\n  /** The instance entry using this entity */\n  entry: InstanceEntry | SchemaEntry;\n  /** Whether this is the definition (always false for entity refs) */\n  isDefinition: boolean;\n}\n\n/**\n * Result of finding entity references\n */\nexport interface EntityReferencesResult {\n  /** The entity name */\n  entityName: string;\n  /** The definition (if it exists) */\n  definition: EntityDefinitionResult | undefined;\n  /** All instance entries using this entity */\n  references: EntityReferenceLocation[];\n  /** All locations (definition + references if includeDefinition) */\n  locations: (EntityDefinitionResult | EntityReferenceLocation)[];\n}\n\n/**\n * Find the define-entity for an entity name\n *\n * @param workspace - The workspace to search in\n * @param entityName - The entity name to find\n * @returns The definition result, or undefined if not found\n */\nexport function findEntityDefinition(\n  workspace: Workspace,\n  entityName: string,\n): EntityDefinitionResult | undefined {\n  for (const model of workspace.allModels()) {\n    for (const entry of model.ast.entries) {\n      if (\n        entry.type === \"schema_entry\" &&\n        entry.header.directive === \"define-entity\" &&\n        entry.header.entityName.value === entityName\n      ) {\n        return {\n          file: model.file,\n          location: entry.location,\n          entry,\n        };\n      }\n    }\n  }\n  return undefined;\n}\n\n/**\n * Find all references to an entity type\n *\n * @param workspace - The workspace to search in\n * @param entityName - The entity name to find references for\n * @param includeDefinition - Whether to include the definition in results\n * @returns The references result\n */\nexport function findEntityReferences(\n  workspace: Workspace,\n  entityName: string,\n  includeDefinition = true,\n): EntityReferencesResult {\n  const definition = findEntityDefinition(workspace, entityName);\n\n  // Find all instance entries using this entity\n  const references: EntityReferenceLocation[] = [];\n\n  for (const model of workspace.allModels()) {\n    for (const entry of model.ast.entries) {\n      if (entry.type === \"instance_entry\" && entry.header.entity === entityName) {\n        references.push({\n          file: model.file,\n          location: entry.location,\n          entry,\n          isDefinition: false,\n        });\n      }\n\n      // Also find alter-entity entries that reference this entity\n      if (\n        entry.type === \"schema_entry\" &&\n        entry.header.directive === \"alter-entity\" &&\n        entry.header.entityName.value === entityName\n      ) {\n        references.push({\n          file: model.file,\n          location: entry.location,\n          entry,\n          isDefinition: false,\n        });\n      }\n    }\n  }\n\n  const locations: (EntityDefinitionResult | EntityReferenceLocation)[] = [];\n  if (includeDefinition && definition) {\n    locations.push(definition);\n  }\n  locations.push(...references);\n\n  return {\n    entityName,\n    definition,\n    references,\n    locations,\n  };\n}\n\n// ===================\n// Tag Navigation\n// ===================\n\n/**\n * A reference to a tag (entry with that tag)\n */\nexport interface TagReferenceLocation {\n  /** The file containing the reference */\n  file: string;\n  /** Location of the entry with this tag */\n  location: Location;\n  /** The entry with this tag */\n  entry: Entry;\n}\n\n/**\n * Result of finding tag references\n */\nexport interface TagReferencesResult {\n  /** The tag name (without # prefix) */\n  tagName: string;\n  /** All entries with this tag */\n  references: TagReferenceLocation[];\n}\n\n/**\n * Get tags from an entry\n */\nfunction getEntryTags(entry: Entry): string[] {\n  switch (entry.type) {\n    case \"instance_entry\":\n      return entry.header.tags.map((t) => t.name);\n    case \"schema_entry\":\n      return entry.header.tags.map((t) => t.name);\n    case \"synthesis_entry\":\n      return entry.header.tags.map((t) => t.name);\n    case \"actualize_entry\":\n      // Actualize entries don't have tags\n      return [];\n  }\n}\n\n/**\n * Find all entries with a given tag\n *\n * @param workspace - The workspace to search in\n * @param tagName - The tag name (without # prefix)\n * @returns The references result\n */\nexport function findTagReferences(workspace: Workspace, tagName: string): TagReferencesResult {\n  const references: TagReferenceLocation[] = [];\n\n  for (const model of workspace.allModels()) {\n    for (const entry of model.ast.entries) {\n      if (getEntryTags(entry).includes(tagName)) {\n        references.push({\n          file: model.file,\n          location: entry.location,\n          entry,\n        });\n      }\n    }\n  }\n\n  return {\n    tagName,\n    references,\n  };\n}\n\n// ===================\n// Metadata Field Navigation\n// ===================\n\n/**\n * Result of finding a field definition\n */\nexport interface FieldDefinitionResult {\n  /** The file containing the definition */\n  file: string;\n  /** Location of the field definition */\n  location: Location;\n  /** The entity name this field belongs to */\n  entityName: string;\n  /** The schema entry containing this field */\n  schemaEntry: SchemaEntry;\n}\n\n/**\n * A reference to a field (instance entry using that metadata key)\n */\nexport interface FieldReferenceLocation {\n  /** The file containing the reference */\n  file: string;\n  /** Location of the metadata line */\n  location: Location;\n  /** The instance entry using this field */\n  entry: InstanceEntry;\n}\n\n/**\n * Result of finding field references\n */\nexport interface FieldReferencesResult {\n  /** The field name */\n  fieldName: string;\n  /** The entity context (if known) */\n  entityName: string | undefined;\n  /** The definition (if it exists) */\n  definition: FieldDefinitionResult | undefined;\n  /** All instance entries using this field */\n  references: FieldReferenceLocation[];\n}\n\n/**\n * Find the field definition in a schema\n *\n * @param workspace - The workspace to search in\n * @param fieldName - The field name to find\n * @param entityName - Optional entity name to constrain the search\n * @returns The definition result, or undefined if not found\n */\nexport function findFieldDefinition(\n  workspace: Workspace,\n  fieldName: string,\n  entityName?: string,\n): FieldDefinitionResult | undefined {\n  // If entityName is provided, look in that entity's schema\n  if (entityName) {\n    const schema = workspace.schemaRegistry.get(entityName);\n    if (schema) {\n      const field = schema.fields.get(fieldName);\n      if (field) {\n        // Find the schema entry that defines this field\n        for (const model of workspace.allModels()) {\n          for (const entry of model.ast.entries) {\n            if (entry.type !== \"schema_entry\") {\n              continue;\n            }\n            if (entry.header.entityName.value !== entityName) {\n              continue;\n            }\n\n            const fieldDef = entry.metadataBlock?.fields.find((f) => f.name.value === fieldName);\n            if (fieldDef) {\n              return {\n                file: model.file,\n                location: fieldDef.location,\n                entityName,\n                schemaEntry: entry,\n              };\n            }\n          }\n        }\n      }\n    }\n    return undefined;\n  }\n\n  // Without entityName, search all schemas\n  for (const schemaEntityName of workspace.schemaRegistry.entityNames()) {\n    const result = findFieldDefinition(workspace, fieldName, schemaEntityName);\n    if (result) {\n      return result;\n    }\n  }\n\n  return undefined;\n}\n\n/**\n * Find all references to a field\n *\n * @param workspace - The workspace to search in\n * @param fieldName - The field name to find references for\n * @param entityName - Optional entity name to constrain the search\n * @returns The references result\n */\nexport function findFieldReferences(\n  workspace: Workspace,\n  fieldName: string,\n  entityName?: string,\n): FieldReferencesResult {\n  const definition = findFieldDefinition(workspace, fieldName, entityName);\n\n  const references: FieldReferenceLocation[] = [];\n\n  for (const model of workspace.allModels()) {\n    for (const entry of model.ast.entries) {\n      if (entry.type !== \"instance_entry\") {\n        continue;\n      }\n\n      // If entityName is specified, only look at entries of that entity type\n      if (entityName && entry.header.entity !== entityName) {\n        continue;\n      }\n\n      const meta = entry.metadata.find((m) => m.key.value === fieldName);\n      if (meta) {\n        references.push({\n          file: model.file,\n          location: meta.location,\n          entry,\n        });\n      }\n    }\n  }\n\n  return {\n    fieldName,\n    entityName,\n    definition,\n    references,\n  };\n}\n\n// ===================\n// Section Navigation\n// ===================\n\n/**\n * Result of finding a section definition\n */\nexport interface SectionDefinitionResult {\n  /** The file containing the definition */\n  file: string;\n  /** Location of the section definition */\n  location: Location;\n  /** The entity name this section belongs to */\n  entityName: string;\n  /** The schema entry containing this section */\n  schemaEntry: SchemaEntry;\n}\n\n/**\n * A reference to a section (instance entry with that section)\n */\nexport interface SectionReferenceLocation {\n  /** The file containing the reference */\n  file: string;\n  /** Location of the entry with this section */\n  location: Location;\n  /** The instance entry with this section */\n  entry: InstanceEntry;\n}\n\n/**\n * Result of finding section references\n */\nexport interface SectionReferencesResult {\n  /** The section name */\n  sectionName: string;\n  /** The entity context (if known) */\n  entityName: string | undefined;\n  /** The definition (if it exists) */\n  definition: SectionDefinitionResult | undefined;\n  /** All instance entries with this section */\n  references: SectionReferenceLocation[];\n}\n\n/**\n * Get section names from an instance entry\n */\nfunction getEntrySections(entry: InstanceEntry): string[] {\n  if (!entry.content) {\n    return [];\n  }\n  return entry.content.children\n    .filter((c) => c.type === \"markdown_header\")\n    .map((h) => {\n      // Extract section name from \"# SectionName\" format\n      const match = h.text.match(/^#+\\s*(.+)$/);\n      return match ? match[1].trim() : h.text;\n    });\n}\n\n/**\n * Find the section definition in a schema\n *\n * @param workspace - The workspace to search in\n * @param sectionName - The section name to find\n * @param entityName - Optional entity name to constrain the search\n * @returns The definition result, or undefined if not found\n */\nexport function findSectionDefinition(\n  workspace: Workspace,\n  sectionName: string,\n  entityName?: string,\n): SectionDefinitionResult | undefined {\n  // If entityName is provided, look in that entity's schema\n  if (entityName) {\n    const schema = workspace.schemaRegistry.get(entityName);\n    if (schema) {\n      const section = schema.sections.get(sectionName);\n      if (section) {\n        // Find the schema entry that defines this section\n        for (const model of workspace.allModels()) {\n          for (const entry of model.ast.entries) {\n            if (entry.type !== \"schema_entry\") {\n              continue;\n            }\n            if (entry.header.entityName.value !== entityName) {\n              continue;\n            }\n\n            const sectionDef = entry.sectionsBlock?.sections.find(\n              (s) => s.name.value === sectionName,\n            );\n            if (sectionDef) {\n              return {\n                file: model.file,\n                location: sectionDef.location,\n                entityName,\n                schemaEntry: entry,\n              };\n            }\n          }\n        }\n      }\n    }\n    return undefined;\n  }\n\n  // Without entityName, search all schemas\n  for (const schemaEntityName of workspace.schemaRegistry.entityNames()) {\n    const result = findSectionDefinition(workspace, sectionName, schemaEntityName);\n    if (result) {\n      return result;\n    }\n  }\n\n  return undefined;\n}\n\n/**\n * Find all references to a section\n *\n * @param workspace - The workspace to search in\n * @param sectionName - The section name to find references for\n * @param entityName - Optional entity name to constrain the search\n * @returns The references result\n */\nexport function findSectionReferences(\n  workspace: Workspace,\n  sectionName: string,\n  entityName?: string,\n): SectionReferencesResult {\n  const definition = findSectionDefinition(workspace, sectionName, entityName);\n\n  const references: SectionReferenceLocation[] = [];\n\n  for (const model of workspace.allModels()) {\n    for (const entry of model.ast.entries) {\n      if (entry.type !== \"instance_entry\") {\n        continue;\n      }\n\n      // If entityName is specified, only look at entries of that entity type\n      if (entityName && entry.header.entity !== entityName) {\n        continue;\n      }\n\n      if (getEntrySections(entry).includes(sectionName)) {\n        references.push({\n          file: model.file,\n          location: entry.location,\n          entry,\n        });\n      }\n    }\n  }\n\n  return {\n    sectionName,\n    entityName,\n    definition,\n    references,\n  };\n}\n"],"mappings":"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"}

package/dist/services/hover.d.ts

@@ -0,0 +1,81 @@
+import { ActualizeEntry, Entry, InstanceEntry, Location, SchemaEntry, SynthesisEntry } from "../ast/ast-types.js";
+import { EntitySchema, FieldSchema, SectionSchema } from "../schema/registry.js";
+import { Workspace } from "../model/workspace.js";
+import { NodeContext } from "../ast/node-at-position.js";
+
+//#region src/services/hover.d.ts
+
+/**
+ * Result of a hover lookup
+ */
+interface HoverResult {
+  /** Markdown content to display */
+  content: string;
+  /** Optional range to highlight (file-absolute) */
+  range?: Location;
+}
+/**
+ * Format an entry for hover display
+ */
+declare function formatEntryHover(entry: Entry, file: string): string;
+/**
+ * Format an instance entry for hover
+ */
+declare function formatInstanceEntry(entry: InstanceEntry, file: string): string;
+/**
+ * Format a schema entry for hover
+ */
+declare function formatSchemaEntry(entry: SchemaEntry, file: string): string;
+/**
+ * Format a synthesis entry for hover
+ */
+declare function formatSynthesisEntry(entry: SynthesisEntry, file: string): string;
+/**
+ * Format an actualize entry for hover
+ */
+declare function formatActualizeEntry(entry: ActualizeEntry, file: string): string;
+/**
+ * Get documentation for a directive
+ */
+declare function getDirectiveDocumentation(directive: string): string | null;
+/**
+ * Format an entity schema for hover display
+ */
+declare function formatEntitySchema(schema: EntitySchema): string;
+/**
+ * Format a field schema for hover display
+ */
+declare function formatFieldHover(field: FieldSchema, entityName: string): string;
+/**
+ * Format a section schema for hover display
+ */
+declare function formatSectionHover(section: SectionSchema, entityName: string): string;
+/**
+ * Get documentation for a primitive type
+ */
+declare function getPrimitiveTypeDocumentation(typeName: string): string | null;
+/**
+ * Format tag hover information
+ */
+declare function formatTagHover(tag: string, entries: {
+  entry: Entry;
+  file: string;
+}[]): string;
+/**
+ * Format timestamp hover
+ */
+declare function formatTimestampHover(timestamp: string, entry: Entry | undefined, _file?: string): string;
+/**
+ * Get hover information for a node context.
+ *
+ * This function takes a semantic node context (from findNodeAtPosition) and
+ * returns hover information including markdown content and an optional range.
+ *
+ * @param workspace - The workspace to look up entries, schemas, etc.
+ * @param context - The node context from findNodeAtPosition
+ * @returns Hover result with markdown content, or null if no hover info
+ */
+declare function getHoverInfo(workspace: Workspace, context: NodeContext): HoverResult | null;
+//#endregion
+export { HoverResult, formatActualizeEntry, formatEntitySchema, formatEntryHover, formatFieldHover, formatInstanceEntry, formatSchemaEntry, formatSectionHover, formatSynthesisEntry, formatTagHover, formatTimestampHover, getDirectiveDocumentation, getHoverInfo, getPrimitiveTypeDocumentation };
+//# sourceMappingURL=hover.d.ts.map

package/dist/services/hover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hover.d.ts","names":[],"sources":["../../src/services/hover.ts"],"sourcesContent":[],"mappings":";;;;;;;;;AAuBA;AA+BgB,UA/BC,WAAA,CA+Be;EAgBhB;EAkDA,OAAA,EAAA,MAAA;EA2CA;EAmCA,KAAA,CAAA,EA3KN,QA2KM;AA+BhB;AAgJA;AA8CA;AA6BA;AA2BgB,iBAraA,gBAAA,CAqa6B,KAAA,EAraL,KAqaK,EAAA,IAAA,EAAA,MAAA,CAAA,EAAA,MAAA;AA6F7C;AAiDA;AA+DA;AAAwC,iBAlmBxB,mBAAA,CAkmBwB,KAAA,EAlmBG,aAkmBH,EAAA,IAAA,EAAA,MAAA,CAAA,EAAA,MAAA;;;;iBAhjBxB,iBAAA,QAAyB;;;;iBA2CzB,oBAAA,QAA4B;;;;iBAmC5B,oBAAA,QAA4B;;;;iBA+B5B,yBAAA;;;;iBAgJA,kBAAA,SAA2B;;;;iBA8C3B,gBAAA,QAAwB;;;;iBA6BxB,kBAAA,UAA4B;;;;iBA2B5B,6BAAA;;;;iBA6FA,cAAA;SAA8C;;;;;;iBAiD9C,oBAAA,2BAEP;;;;;;;;;;;iBA6DO,YAAA,YAAwB,oBAAoB,cAAc"}