@telorun/ide-support 0.2.6 → 0.3.0

package/dist/diagnostics/find-positions.d.ts

@@ -0,0 +1,19 @@
+import type { LoadedGraph, PositionIndex } from "@telorun/analyzer";
+/** Diagnostic location lookup: which file owns the diagnostic's resource,
+ *  and what positions does that file's parse expose. Encapsulates the
+ *  routing both the editor and the vscode/CLI hosts previously wrote
+ *  inline against per-manifest metadata fields.
+ *
+ *  Resolution order:
+ *    1. `data.resource.{kind,name}` → search every LoadedFile in the graph
+ *       for the doc with matching kind+name. Returns that file's source +
+ *       its positions for the matching doc index.
+ *    2. `data.filePath` → match the owning LoadedFile by canonical source.
+ *
+ *  Returns `undefined` if the diagnostic carries no usable identity. */
+export declare function findPositions(graph: LoadedGraph, diagnosticData: unknown): {
+    file: string;
+    positionIndex?: PositionIndex;
+    sourceLine?: number;
+} | undefined;
+//# sourceMappingURL=find-positions.d.ts.map

package/dist/diagnostics/find-positions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-positions.d.ts","sourceRoot":"","sources":["../../src/diagnostics/find-positions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEpE;;;;;;;;;;;wEAWwE;AACxE,wBAAgB,aAAa,CAC3B,KAAK,EAAE,WAAW,EAClB,cAAc,EAAE,OAAO,GAErB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,aAAa,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GACpE,SAAS,CAiBZ"}

package/dist/diagnostics/find-positions.js

@@ -0,0 +1,65 @@
+/** Diagnostic location lookup: which file owns the diagnostic's resource,
+ *  and what positions does that file's parse expose. Encapsulates the
+ *  routing both the editor and the vscode/CLI hosts previously wrote
+ *  inline against per-manifest metadata fields.
+ *
+ *  Resolution order:
+ *    1. `data.resource.{kind,name}` → search every LoadedFile in the graph
+ *       for the doc with matching kind+name. Returns that file's source +
+ *       its positions for the matching doc index.
+ *    2. `data.filePath` → match the owning LoadedFile by canonical source.
+ *
+ *  Returns `undefined` if the diagnostic carries no usable identity. */
+export function findPositions(graph, diagnosticData) {
+    const data = diagnosticData;
+    if (!data)
+        return undefined;
+    if (data.resource?.kind && data.resource.name) {
+        const result = findByResource(graph, data.resource.kind, data.resource.name);
+        if (result)
+            return result;
+    }
+    if (data.filePath) {
+        const result = findByFile(graph, data.filePath);
+        if (result)
+            return result;
+    }
+    return undefined;
+}
+function findByResource(graph, kind, name) {
+    for (const mod of graph.modules.values()) {
+        for (const file of [mod.owner, ...mod.partials]) {
+            for (let i = 0; i < file.manifests.length; i++) {
+                const m = file.manifests[i];
+                if (!m)
+                    continue;
+                if (m.kind !== kind)
+                    continue;
+                if (m.metadata?.name !== name)
+                    continue;
+                const pos = file.positions[i];
+                return {
+                    file: file.source,
+                    positionIndex: pos?.positionIndex,
+                    sourceLine: pos?.sourceLine,
+                };
+            }
+        }
+    }
+    return undefined;
+}
+function findByFile(graph, filePath) {
+    for (const mod of graph.modules.values()) {
+        for (const file of [mod.owner, ...mod.partials]) {
+            if (file.source === filePath) {
+                const pos = file.positions[0];
+                return {
+                    file: file.source,
+                    positionIndex: pos?.positionIndex,
+                    sourceLine: pos?.sourceLine,
+                };
+            }
+        }
+    }
+    return undefined;
+}

package/dist/diagnostics/index.d.ts

@@ -1,3 +1,4 @@
+export { findPositions } from "./find-positions.js";
 export { normalizeDiagnostic } from "./normalize.js";
 export { resolveRange } from "./range-resolver.js";
 export { resolveSeverity } from "./severity.js";

package/dist/diagnostics/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/diagnostics/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/diagnostics/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/dist/diagnostics/index.js

@@ -1,3 +1,4 @@
+export { findPositions } from "./find-positions.js";
 export { normalizeDiagnostic } from "./normalize.js";
 export { resolveRange } from "./range-resolver.js";
 export { resolveSeverity } from "./severity.js";

package/dist/diagnostics/normalize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../src/diagnostics/normalize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAI3E;;;;;;oEAMoE;AACpE,wBAAgB,mBAAmB,CACjC,CAAC,EAAE,kBAAkB,EACrB,GAAG,EAAE,iBAAiB,GACrB,oBAAoB,CActB"}
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../src/diagnostics/normalize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAI3E;;;;;;oEAMoE;AACpE,wBAAgB,mBAAmB,CACjC,CAAC,EAAE,kBAAkB,EACrB,GAAG,EAAE,iBAAiB,GACrB,oBAAoB,CAetB"}

package/dist/diagnostics/normalize.js

@@ -19,5 +19,6 @@ export function normalizeDiagnostic(d, ctx) {
         source: d.source ?? "telo",
         message: d.message,
         ...(suggestions ? { suggestions } : {}),
+        ...(d.data !== undefined ? { data: d.data } : {}),
     };
 }

package/dist/types.d.ts

@@ -22,6 +22,11 @@ export interface NormalizedDiagnostic {
         kind: "replace-kind";
         replacement: string;
     }>;
+    /** Preserved verbatim from the source `AnalysisDiagnostic`. Carries
+     *  resource/path stamps that downstream UIs (popovers, "at <path>" hints,
+     *  CodeAction wiring) read after normalization. Opaque on purpose so this
+     *  module doesn't pin a shape that the analyzer evolves over time. */
+    data?: unknown;
 }
 export interface DiagnosticContext {
     registry: AnalysisRegistry;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAGzE,YAAY,EACV,QAAQ,EACR,KAAK,EACL,kBAAkB,EAClB,aAAa,GACd,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAEpG,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,YAAY,GAAG,UAAU,CAAC;AAEjE,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,cAAc,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpE;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAGzE,YAAY,EACV,QAAQ,EACR,KAAK,EACL,kBAAkB,EAClB,aAAa,GACd,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAEpG,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,YAAY,GAAG,UAAU,CAAC;AAEjE,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,cAAc,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnE;;;0EAGsE;IACtE,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@telorun/ide-support",
-  "version": "0.2.6",
+  "version": "0.3.0",
   "description": "Editor-host-agnostic IDE support (completions, diagnostic normalization) for Telo manifests.",
   "keywords": [
     "telo",
@@ -36,7 +36,7 @@
     "src/**"
   ],
   "dependencies": {
-    "@telorun/analyzer": "0.8.0"
+    "@telorun/analyzer": "0.9.0"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",

package/src/diagnostics/find-positions.ts

@@ -0,0 +1,80 @@
+import type { LoadedGraph, PositionIndex } from "@telorun/analyzer";
+
+/** Diagnostic location lookup: which file owns the diagnostic's resource,
+ *  and what positions does that file's parse expose. Encapsulates the
+ *  routing both the editor and the vscode/CLI hosts previously wrote
+ *  inline against per-manifest metadata fields.
+ *
+ *  Resolution order:
+ *    1. `data.resource.{kind,name}` → search every LoadedFile in the graph
+ *       for the doc with matching kind+name. Returns that file's source +
+ *       its positions for the matching doc index.
+ *    2. `data.filePath` → match the owning LoadedFile by canonical source.
+ *
+ *  Returns `undefined` if the diagnostic carries no usable identity. */
+export function findPositions(
+  graph: LoadedGraph,
+  diagnosticData: unknown,
+):
+  | { file: string; positionIndex?: PositionIndex; sourceLine?: number }
+  | undefined {
+  const data = diagnosticData as
+    | { resource?: { kind?: string; name?: string }; filePath?: string }
+    | undefined;
+  if (!data) return undefined;
+
+  if (data.resource?.kind && data.resource.name) {
+    const result = findByResource(graph, data.resource.kind, data.resource.name);
+    if (result) return result;
+  }
+
+  if (data.filePath) {
+    const result = findByFile(graph, data.filePath);
+    if (result) return result;
+  }
+
+  return undefined;
+}
+
+function findByResource(
+  graph: LoadedGraph,
+  kind: string,
+  name: string,
+): { file: string; positionIndex?: PositionIndex; sourceLine?: number } | undefined {
+  for (const mod of graph.modules.values()) {
+    for (const file of [mod.owner, ...mod.partials]) {
+      for (let i = 0; i < file.manifests.length; i++) {
+        const m = file.manifests[i];
+        if (!m) continue;
+        if (m.kind !== kind) continue;
+        if (m.metadata?.name !== name) continue;
+        const pos = file.positions[i];
+        return {
+          file: file.source,
+          positionIndex: pos?.positionIndex,
+          sourceLine: pos?.sourceLine,
+        };
+      }
+    }
+  }
+  return undefined;
+}
+
+function findByFile(
+  graph: LoadedGraph,
+  filePath: string,
+): { file: string; positionIndex?: PositionIndex; sourceLine?: number } | undefined {
+  for (const mod of graph.modules.values()) {
+    for (const file of [mod.owner, ...mod.partials]) {
+      if (file.source === filePath) {
+        const pos = file.positions[0];
+        return {
+          file: file.source,
+          positionIndex: pos?.positionIndex,
+          sourceLine: pos?.sourceLine,
+        };
+      }
+    }
+  }
+  return undefined;
+}

package/src/diagnostics/index.ts

@@ -1,3 +1,4 @@
+export { findPositions } from "./find-positions.js";
 export { normalizeDiagnostic } from "./normalize.js";
 export { resolveRange } from "./range-resolver.js";
 export { resolveSeverity } from "./severity.js";

package/src/diagnostics/normalize.ts

@@ -26,5 +26,6 @@ export function normalizeDiagnostic(
     source: d.source ?? "telo",
     message: d.message,
     ...(suggestions ? { suggestions } : {}),
+    ...(d.data !== undefined ? { data: d.data } : {}),
   };
 }

package/src/types.ts

@@ -32,6 +32,11 @@ export interface NormalizedDiagnostic {
   source: string;
   message: string;
   suggestions?: Array<{ kind: "replace-kind"; replacement: string }>;
+  /** Preserved verbatim from the source `AnalysisDiagnostic`. Carries
+   *  resource/path stamps that downstream UIs (popovers, "at <path>" hints,
+   *  CodeAction wiring) read after normalization. Opaque on purpose so this
+   *  module doesn't pin a shape that the analyzer evolves over time. */
+  data?: unknown;
 }
 
 export interface DiagnosticContext {