@telorun/ide-support 0.3.0 → 0.4.1

package/dist/completions/build.d.ts

@@ -1,4 +1,4 @@
 import type { AnalysisRegistry } from "@telorun/analyzer";
-import type { CompletionResult } from "../types.js";
-export declare function buildCompletions(text: string, line: number, character: number, registry: AnalysisRegistry | undefined): CompletionResult[];
+import type { CompletionResult, IdeEnvironmentAdapter } from "../types.js";
+export declare function buildCompletions(text: string, line: number, character: number, registry: AnalysisRegistry | undefined, adapter?: IdeEnvironmentAdapter): Promise<CompletionResult[]>;
 //# sourceMappingURL=build.d.ts.map

package/dist/completions/build.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/completions/build.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AA0BpD,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,gBAAgB,GAAG,SAAS,GACrC,gBAAgB,EAAE,CAMpB"}
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/completions/build.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AA2B3E,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,gBAAgB,GAAG,SAAS,EACtC,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAY7B"}

package/dist/completions/build.js

@@ -1,4 +1,5 @@
 import { detectContext } from "./detect-context.js";
+import { importSourceCompletions } from "./import-source.js";
 import { propKeyCompletions } from "./prop-keys.js";
 import { CAPABILITY_VALUES } from "./valid-capabilities.js";
 function kindCompletions(registry) {
@@ -18,7 +19,7 @@ function capabilityCompletions() {
         detail: "Telo capability",
     }));
 }
-export function buildCompletions(text, line, character, registry) {
+export async function buildCompletions(text, line, character, registry, adapter) {
     const ctx = detectContext(text, line, character);
     if (!ctx)
         return [];
@@ -26,5 +27,11 @@ export function buildCompletions(text, line, character, registry) {
         return kindCompletions(registry);
     if (ctx.type === "capability")
         return capabilityCompletions();
+    if (ctx.type === "field-value") {
+        if (ctx.docKind === "Telo.Import" && ctx.field === "source") {
+            return importSourceCompletions(ctx.prefix, ctx.valueStartColumn, adapter);
+        }
+        return [];
+    }
     return propKeyCompletions(ctx.docKind, ctx.yamlPath, ctx.existingKeys, registry);
 }

package/dist/completions/detect-context.d.ts

@@ -7,6 +7,14 @@ export type CompletionCtx = {
     docKind: string;
     yamlPath: string[];
     existingKeys: Set<string>;
+} | {
+    type: "field-value";
+    docKind: string;
+    field: string;
+    /** Text from the start of the value to the cursor. */
+    prefix: string;
+    /** 0-based column where the value starts (right after `<field>:` + whitespace). */
+    valueStartColumn: number;
 };
 export declare function findDocBounds(lines: string[], cursorLine: number): {
     start: number;

package/dist/completions/detect-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"detect-context.d.ts","sourceRoot":"","sources":["../../src/completions/detect-context.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,GACtB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CAAE,CAAC;AAEzF,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAgBjG;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMlG;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAOxF;AAED,4EAA4E;AAC5E,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EAAE,EACf,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,GACnB,MAAM,EAAE,CA2BV;AAED,8EAA8E;AAC9E,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EAAE,EACf,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,GACb,GAAG,CAAC,MAAM,CAAC,CAab;AAED,2FAA2F;AAC3F,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,IAAI,EAAE,MAAM,EAAE,GACb,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,CAgBjC;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAYrG;AAED,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAChB,aAAa,GAAG,SAAS,CAuC3B"}
+{"version":3,"file":"detect-context.d.ts","sourceRoot":"","sources":["../../src/completions/detect-context.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,GACtB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CAAE,GACpF;IACE,IAAI,EAAE,aAAa,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,mFAAmF;IACnF,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEN,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAgBjG;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMlG;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAOxF;AAED,4EAA4E;AAC5E,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EAAE,EACf,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,GACnB,MAAM,EAAE,CA2BV;AAED,8EAA8E;AAC9E,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EAAE,EACf,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,GACb,GAAG,CAAC,MAAM,CAAC,CAab;AAED,2FAA2F;AAC3F,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC3B,IAAI,EAAE,MAAM,EAAE,GACb,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,CAgBjC;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAYrG;AAED,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAChB,aAAa,GAAG,SAAS,CAqD3B"}

package/dist/completions/detect-context.js

@@ -135,6 +135,19 @@ export function detectContext(text, line, character) {
     }
     if (!docKind)
         return undefined;
+    // Field-value completion: `source: <prefix>` on a top-level Telo.Import field.
+    // The prefix runs from after `source:`+whitespace up to the cursor — that's
+    // what consumers complete against (filesystem paths or registry ids).
+    if (docKind === "Telo.Import") {
+        const sourceMatch = currentLine.match(/^(source:\s*)(\S*)$/);
+        if (sourceMatch) {
+            const valueStartColumn = sourceMatch[1].length;
+            if (character >= valueStartColumn) {
+                const prefix = currentLine.slice(valueStartColumn, character);
+                return { type: "field-value", docKind, field: "source", prefix, valueStartColumn };
+            }
+        }
+    }
     const trimmed = currentLine.trim();
     // Only trigger when the line looks like a key being typed (or is blank)
     const isKeyLine = trimmed === "" || /^[a-zA-Z_][a-zA-Z0-9_]*:?$/.test(trimmed);

package/dist/completions/import-source.d.ts

@@ -0,0 +1,17 @@
+import type { CompletionResult, IdeEnvironmentAdapter } from "../types.js";
+/**
+ * Completions for the `source:` field of a `Telo.Import`.
+ *
+ * Branches by prefix shape:
+ *   ""                         → relative dirs under the manifest dir, plus `./` / `../` seeds.
+ *   "./..", "../", "/..."      → subdirs of the typed path (any subdir; existing manifest gets a hint).
+ *   "<word>"                   → registry search by free-text.
+ *   "<ns>/<name>@<partial>"    → version list for that module.
+ *   "http(s)://", "file://"    → no suggestions (opaque URLs).
+ *
+ * `valueStartColumn` is forwarded onto every result so the host can replace
+ * the whole typed value, not just the trailing word (Monaco / VSCode word
+ * boundaries don't cross `/` or `@`).
+ */
+export declare function importSourceCompletions(prefix: string, valueStartColumn: number, adapter: IdeEnvironmentAdapter | undefined): Promise<CompletionResult[]>;
+//# sourceMappingURL=import-source.d.ts.map

package/dist/completions/import-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-source.d.ts","sourceRoot":"","sources":["../../src/completions/import-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAW3E;;;;;;;;;;;;;GAaG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,MAAM,EACd,gBAAgB,EAAE,MAAM,EACxB,OAAO,EAAE,qBAAqB,GAAG,SAAS,GACzC,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAuB7B"}

package/dist/completions/import-source.js

@@ -0,0 +1,146 @@
+/** Maximum registry hits to surface in a single completion request.
+ *  Keeps the popover scannable when a broad `q=` query matches the catalog. */
+const REGISTRY_LIMIT = 50;
+/** Caps the number of directory entries we probe with `hasManifest` per
+ *  request. Each probe is a host-side filesystem stat; the popover would not
+ *  show more than ~50 entries anyway, so probing further only adds latency. */
+const PATH_PROBE_LIMIT = 50;
+/**
+ * Completions for the `source:` field of a `Telo.Import`.
+ *
+ * Branches by prefix shape:
+ *   ""                         → relative dirs under the manifest dir, plus `./` / `../` seeds.
+ *   "./..", "../", "/..."      → subdirs of the typed path (any subdir; existing manifest gets a hint).
+ *   "<word>"                   → registry search by free-text.
+ *   "<ns>/<name>@<partial>"    → version list for that module.
+ *   "http(s)://", "file://"    → no suggestions (opaque URLs).
+ *
+ * `valueStartColumn` is forwarded onto every result so the host can replace
+ * the whole typed value, not just the trailing word (Monaco / VSCode word
+ * boundaries don't cross `/` or `@`).
+ */
+export async function importSourceCompletions(prefix, valueStartColumn, adapter) {
+    if (!adapter)
+        return [];
+    if (prefix.startsWith("http://") ||
+        prefix.startsWith("https://") ||
+        prefix.startsWith("file://")) {
+        return [];
+    }
+    const isRelativeShape = prefix === "" || prefix.startsWith(".") || prefix.startsWith("/");
+    if (isRelativeShape) {
+        return relativePathCompletions(prefix, valueStartColumn, adapter);
+    }
+    const atIdx = prefix.indexOf("@");
+    if (atIdx > 0) {
+        return versionCompletions(prefix, atIdx, valueStartColumn, adapter);
+    }
+    return registrySearchCompletions(prefix, valueStartColumn, adapter);
+}
+async function relativePathCompletions(prefix, valueStartColumn, adapter) {
+    // Empty prefix → seed `./` and `../` so the user gets traction; otherwise
+    // we'd return an unfiltered dump of the manifest directory which is rarely
+    // what the user wants for a `Telo.Import`.
+    if (prefix === "") {
+        return [
+            {
+                label: "./",
+                kind: "folder",
+                insertText: "./",
+                sortText: "0_./",
+                replaceFromColumn: valueStartColumn,
+            },
+            {
+                label: "../",
+                kind: "folder",
+                insertText: "../",
+                sortText: "0_../",
+                replaceFromColumn: valueStartColumn,
+            },
+        ];
+    }
+    // Split the typed prefix at the last `/`: everything up to it is the
+    // directory we list, the trailing chunk is what the user is filtering on.
+    const lastSlash = prefix.lastIndexOf("/");
+    const dirPart = lastSlash >= 0 ? prefix.slice(0, lastSlash + 1) : "";
+    const namePart = lastSlash >= 0 ? prefix.slice(lastSlash + 1) : prefix;
+    // If the user hasn't typed a slash yet (e.g. just `.` or `..`), nothing
+    // to list — let them keep typing until they pass `/`.
+    if (dirPart === "")
+        return [];
+    const dirs = await adapter.listDirectories(dirPart);
+    const matches = dirs
+        .filter((name) => name.startsWith(namePart))
+        .sort()
+        .slice(0, PATH_PROBE_LIMIT);
+    // Probe every candidate in parallel. Sequential `await` here makes a wide
+    // directory (e.g. `modules/` with dozens of children) feel sluggish — Promise.all
+    // fans the host's filesystem stats out concurrently so total latency is bounded
+    // by the slowest single probe rather than their sum.
+    return Promise.all(matches.map(async (name) => {
+        const fullPath = dirPart + name;
+        const isModule = await adapter.hasManifest(fullPath);
+        return {
+            label: name,
+            kind: "folder",
+            detail: isModule ? "telo module" : "folder",
+            insertText: fullPath,
+            filterText: fullPath,
+            replaceFromColumn: valueStartColumn,
+            // Modules sort above plain folders so they surface first when the user
+            // is browsing a `modules/` tree mixed with non-Telo siblings.
+            sortText: isModule ? `0_${name}` : `1_${name}`,
+        };
+    }));
+}
+async function registrySearchCompletions(prefix, valueStartColumn, adapter) {
+    // The registry's `q` filter ILIKEs against name / namespace / description —
+    // it doesn't know about the `<namespace>/<name>` shape. Once the user has
+    // typed a `/`, sending the literal `std/htt` as `q` matches nothing because
+    // the slash is not in any of those columns. Split here so `q` carries just
+    // the bit that looks like a name, and apply the namespace constraint
+    // client-side.
+    const slashIdx = prefix.indexOf("/");
+    const namespacePart = slashIdx >= 0 ? prefix.slice(0, slashIdx) : "";
+    const namePart = slashIdx >= 0 ? prefix.slice(slashIdx + 1) : prefix;
+    const hits = await adapter.searchRegistry(namePart);
+    const filtered = namespacePart
+        ? hits.filter((h) => h.namespace.startsWith(namespacePart))
+        : hits;
+    return filtered.slice(0, REGISTRY_LIMIT).map((m) => {
+        const id = `${m.namespace}/${m.name}@${m.version}`;
+        return {
+            label: id,
+            kind: "module",
+            detail: m.description ?? "registry module",
+            insertText: id,
+            filterText: id,
+            replaceFromColumn: valueStartColumn,
+        };
+    });
+}
+async function versionCompletions(prefix, atIdx, valueStartColumn, adapter) {
+    const beforeAt = prefix.slice(0, atIdx);
+    const partialVersion = prefix.slice(atIdx + 1);
+    const slashIdx = beforeAt.indexOf("/");
+    if (slashIdx <= 0 || slashIdx === beforeAt.length - 1)
+        return [];
+    const namespace = beforeAt.slice(0, slashIdx);
+    const name = beforeAt.slice(slashIdx + 1);
+    const versions = await adapter.listRegistryVersions(namespace, name);
+    const matches = versions.filter((v) => v.startsWith(partialVersion));
+    return matches.map((version, idx) => {
+        const id = `${namespace}/${name}@${version}`;
+        return {
+            label: id,
+            kind: "value",
+            detail: idx === 0 ? "latest" : `v${version}`,
+            insertText: id,
+            filterText: id,
+            replaceFromColumn: valueStartColumn,
+            // Preserve registry's ordering (newest first) so the latest version is
+            // suggested at the top regardless of lexical comparison.
+            sortText: String(idx).padStart(4, "0"),
+        };
+    });
+}

package/dist/types.d.ts

@@ -1,7 +1,7 @@
 export { AnalysisRegistry, DiagnosticSeverity } from "@telorun/analyzer";
 export type { Position, Range, AnalysisDiagnostic, PositionIndex, } from "@telorun/analyzer";
 import type { AnalysisRegistry, DiagnosticSeverity, PositionIndex, Range } from "@telorun/analyzer";
-export type CompletionKind = "class" | "enumMember" | "property";
+export type CompletionKind = "class" | "enumMember" | "property" | "folder" | "module" | "value";
 export interface CompletionResult {
     label: string;
     kind: CompletionKind;
@@ -11,6 +11,37 @@ export interface CompletionResult {
     snippet?: boolean;
     preselect?: boolean;
     sortText?: string;
+    filterText?: string;
+    /** When set, the host should replace text from this 0-based column on the
+     *  cursor's line up to the cursor. Required when the completion value
+     *  contains non-word characters (`/`, `@`, `.`) that the host's default
+     *  word boundary would not include in the replaced range. */
+    replaceFromColumn?: number;
+}
+export interface RegistryModule {
+    namespace: string;
+    name: string;
+    version: string;
+    description?: string;
+}
+/** Host-supplied bridge that lets ide-support reach the filesystem and the
+ *  module registry without depending on Node, Tauri, or vscode APIs. Each
+ *  host (VSCode extension, Telo editor) builds an adapter scoped to the
+ *  currently-edited manifest before calling `buildCompletions`. */
+export interface IdeEnvironmentAdapter {
+    /** Subdirectory names within `relPath` (resolved against the manifest's
+     *  directory). Returns [] if the path doesn't exist or isn't a directory.
+     *  Never throws — hosts swallow ENOENT and similar. */
+    listDirectories(relPath: string): Promise<string[]>;
+    /** True iff `<relPath>/telo.yaml` exists relative to the manifest dir.
+     *  Used to mark directories that are valid `Telo.Import` targets. */
+    hasManifest(relPath: string): Promise<boolean>;
+    /** Free-text search against the configured module registry. Matches against
+     *  name, namespace, and description. Empty `query` should return the full
+     *  (capped) catalog. */
+    searchRegistry(query: string): Promise<RegistryModule[]>;
+    /** All published versions for a module, newest first. */
+    listRegistryVersions(namespace: string, name: string): Promise<string[]>;
 }
 export interface NormalizedDiagnostic {
     range: Range;

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;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"}
+{"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,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEjG,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;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;iEAG6D;IAC7D,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;mEAGmE;AACnE,MAAM,WAAW,qBAAqB;IACpC;;2DAEuD;IACvD,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACpD;yEACqE;IACrE,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/C;;4BAEwB;IACxB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IACzD,yDAAyD;IACzD,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CAC1E;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.3.0",
+  "version": "0.4.1",
   "description": "Editor-host-agnostic IDE support (completions, diagnostic normalization) for Telo manifests.",
   "keywords": [
     "telo",
@@ -36,7 +36,7 @@
     "src/**"
   ],
   "dependencies": {
-    "@telorun/analyzer": "0.9.0"
+    "@telorun/analyzer": "0.10.1"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",

package/src/completions/build.ts

@@ -1,6 +1,7 @@
 import type { AnalysisRegistry } from "@telorun/analyzer";
-import type { CompletionResult } from "../types.js";
+import type { CompletionResult, IdeEnvironmentAdapter } from "../types.js";
 import { detectContext } from "./detect-context.js";
+import { importSourceCompletions } from "./import-source.js";
 import { propKeyCompletions } from "./prop-keys.js";
 import { CAPABILITY_VALUES } from "./valid-capabilities.js";
 
@@ -25,15 +26,22 @@ function capabilityCompletions(): CompletionResult[] {
   }));
 }
 
-export function buildCompletions(
+export async function buildCompletions(
   text: string,
   line: number,
   character: number,
   registry: AnalysisRegistry | undefined,
-): CompletionResult[] {
+  adapter?: IdeEnvironmentAdapter,
+): Promise<CompletionResult[]> {
   const ctx = detectContext(text, line, character);
   if (!ctx) return [];
   if (ctx.type === "kind") return kindCompletions(registry);
   if (ctx.type === "capability") return capabilityCompletions();
+  if (ctx.type === "field-value") {
+    if (ctx.docKind === "Telo.Import" && ctx.field === "source") {
+      return importSourceCompletions(ctx.prefix, ctx.valueStartColumn, adapter);
+    }
+    return [];
+  }
   return propKeyCompletions(ctx.docKind, ctx.yamlPath, ctx.existingKeys, registry);
 }

package/src/completions/detect-context.ts

@@ -1,7 +1,16 @@
 export type CompletionCtx =
   | { type: "kind" }
   | { type: "capability" }
-  | { type: "prop-key"; docKind: string; yamlPath: string[]; existingKeys: Set<string> };
+  | { type: "prop-key"; docKind: string; yamlPath: string[]; existingKeys: Set<string> }
+  | {
+      type: "field-value";
+      docKind: string;
+      field: string;
+      /** Text from the start of the value to the cursor. */
+      prefix: string;
+      /** 0-based column where the value starts (right after `<field>:` + whitespace). */
+      valueStartColumn: number;
+    };
 
 export function findDocBounds(lines: string[], cursorLine: number): { start: number; end: number } {
   let start = 0;
@@ -162,6 +171,20 @@ export function detectContext(
 
   if (!docKind) return undefined;
 
+  // Field-value completion: `source: <prefix>` on a top-level Telo.Import field.
+  // The prefix runs from after `source:`+whitespace up to the cursor — that's
+  // what consumers complete against (filesystem paths or registry ids).
+  if (docKind === "Telo.Import") {
+    const sourceMatch = currentLine.match(/^(source:\s*)(\S*)$/);
+    if (sourceMatch) {
+      const valueStartColumn = sourceMatch[1].length;
+      if (character >= valueStartColumn) {
+        const prefix = currentLine.slice(valueStartColumn, character);
+        return { type: "field-value", docKind, field: "source", prefix, valueStartColumn };
+      }
+    }
+  }
+
   const trimmed = currentLine.trim();
 
   // Only trigger when the line looks like a key being typed (or is blank)

package/src/completions/import-source.ts

@@ -0,0 +1,184 @@
+import type { CompletionResult, IdeEnvironmentAdapter } from "../types.js";
+
+/** Maximum registry hits to surface in a single completion request.
+ *  Keeps the popover scannable when a broad `q=` query matches the catalog. */
+const REGISTRY_LIMIT = 50;
+
+/** Caps the number of directory entries we probe with `hasManifest` per
+ *  request. Each probe is a host-side filesystem stat; the popover would not
+ *  show more than ~50 entries anyway, so probing further only adds latency. */
+const PATH_PROBE_LIMIT = 50;
+
+/**
+ * Completions for the `source:` field of a `Telo.Import`.
+ *
+ * Branches by prefix shape:
+ *   ""                         → relative dirs under the manifest dir, plus `./` / `../` seeds.
+ *   "./..", "../", "/..."      → subdirs of the typed path (any subdir; existing manifest gets a hint).
+ *   "<word>"                   → registry search by free-text.
+ *   "<ns>/<name>@<partial>"    → version list for that module.
+ *   "http(s)://", "file://"    → no suggestions (opaque URLs).
+ *
+ * `valueStartColumn` is forwarded onto every result so the host can replace
+ * the whole typed value, not just the trailing word (Monaco / VSCode word
+ * boundaries don't cross `/` or `@`).
+ */
+export async function importSourceCompletions(
+  prefix: string,
+  valueStartColumn: number,
+  adapter: IdeEnvironmentAdapter | undefined,
+): Promise<CompletionResult[]> {
+  if (!adapter) return [];
+
+  if (
+    prefix.startsWith("http://") ||
+    prefix.startsWith("https://") ||
+    prefix.startsWith("file://")
+  ) {
+    return [];
+  }
+
+  const isRelativeShape =
+    prefix === "" || prefix.startsWith(".") || prefix.startsWith("/");
+  if (isRelativeShape) {
+    return relativePathCompletions(prefix, valueStartColumn, adapter);
+  }
+
+  const atIdx = prefix.indexOf("@");
+  if (atIdx > 0) {
+    return versionCompletions(prefix, atIdx, valueStartColumn, adapter);
+  }
+
+  return registrySearchCompletions(prefix, valueStartColumn, adapter);
+}
+
+async function relativePathCompletions(
+  prefix: string,
+  valueStartColumn: number,
+  adapter: IdeEnvironmentAdapter,
+): Promise<CompletionResult[]> {
+  // Empty prefix → seed `./` and `../` so the user gets traction; otherwise
+  // we'd return an unfiltered dump of the manifest directory which is rarely
+  // what the user wants for a `Telo.Import`.
+  if (prefix === "") {
+    return [
+      {
+        label: "./",
+        kind: "folder",
+        insertText: "./",
+        sortText: "0_./",
+        replaceFromColumn: valueStartColumn,
+      },
+      {
+        label: "../",
+        kind: "folder",
+        insertText: "../",
+        sortText: "0_../",
+        replaceFromColumn: valueStartColumn,
+      },
+    ];
+  }
+
+  // Split the typed prefix at the last `/`: everything up to it is the
+  // directory we list, the trailing chunk is what the user is filtering on.
+  const lastSlash = prefix.lastIndexOf("/");
+  const dirPart = lastSlash >= 0 ? prefix.slice(0, lastSlash + 1) : "";
+  const namePart = lastSlash >= 0 ? prefix.slice(lastSlash + 1) : prefix;
+
+  // If the user hasn't typed a slash yet (e.g. just `.` or `..`), nothing
+  // to list — let them keep typing until they pass `/`.
+  if (dirPart === "") return [];
+
+  const dirs = await adapter.listDirectories(dirPart);
+  const matches = dirs
+    .filter((name) => name.startsWith(namePart))
+    .sort()
+    .slice(0, PATH_PROBE_LIMIT);
+
+  // Probe every candidate in parallel. Sequential `await` here makes a wide
+  // directory (e.g. `modules/` with dozens of children) feel sluggish — Promise.all
+  // fans the host's filesystem stats out concurrently so total latency is bounded
+  // by the slowest single probe rather than their sum.
+  return Promise.all(
+    matches.map(async (name) => {
+      const fullPath = dirPart + name;
+      const isModule = await adapter.hasManifest(fullPath);
+      return {
+        label: name,
+        kind: "folder",
+        detail: isModule ? "telo module" : "folder",
+        insertText: fullPath,
+        filterText: fullPath,
+        replaceFromColumn: valueStartColumn,
+        // Modules sort above plain folders so they surface first when the user
+        // is browsing a `modules/` tree mixed with non-Telo siblings.
+        sortText: isModule ? `0_${name}` : `1_${name}`,
+      } satisfies CompletionResult;
+    }),
+  );
+}
+
+async function registrySearchCompletions(
+  prefix: string,
+  valueStartColumn: number,
+  adapter: IdeEnvironmentAdapter,
+): Promise<CompletionResult[]> {
+  // The registry's `q` filter ILIKEs against name / namespace / description —
+  // it doesn't know about the `<namespace>/<name>` shape. Once the user has
+  // typed a `/`, sending the literal `std/htt` as `q` matches nothing because
+  // the slash is not in any of those columns. Split here so `q` carries just
+  // the bit that looks like a name, and apply the namespace constraint
+  // client-side.
+  const slashIdx = prefix.indexOf("/");
+  const namespacePart = slashIdx >= 0 ? prefix.slice(0, slashIdx) : "";
+  const namePart = slashIdx >= 0 ? prefix.slice(slashIdx + 1) : prefix;
+
+  const hits = await adapter.searchRegistry(namePart);
+  const filtered = namespacePart
+    ? hits.filter((h) => h.namespace.startsWith(namespacePart))
+    : hits;
+
+  return filtered.slice(0, REGISTRY_LIMIT).map((m) => {
+    const id = `${m.namespace}/${m.name}@${m.version}`;
+    return {
+      label: id,
+      kind: "module",
+      detail: m.description ?? "registry module",
+      insertText: id,
+      filterText: id,
+      replaceFromColumn: valueStartColumn,
+    };
+  });
+}
+
+async function versionCompletions(
+  prefix: string,
+  atIdx: number,
+  valueStartColumn: number,
+  adapter: IdeEnvironmentAdapter,
+): Promise<CompletionResult[]> {
+  const beforeAt = prefix.slice(0, atIdx);
+  const partialVersion = prefix.slice(atIdx + 1);
+  const slashIdx = beforeAt.indexOf("/");
+  if (slashIdx <= 0 || slashIdx === beforeAt.length - 1) return [];
+
+  const namespace = beforeAt.slice(0, slashIdx);
+  const name = beforeAt.slice(slashIdx + 1);
+  const versions = await adapter.listRegistryVersions(namespace, name);
+
+  const matches = versions.filter((v) => v.startsWith(partialVersion));
+  return matches.map((version, idx) => {
+    const id = `${namespace}/${name}@${version}`;
+    return {
+      label: id,
+      kind: "value",
+      detail: idx === 0 ? "latest" : `v${version}`,
+      insertText: id,
+      filterText: id,
+      replaceFromColumn: valueStartColumn,
+      // Preserve registry's ordering (newest first) so the latest version is
+      // suggested at the top regardless of lexical comparison.
+      sortText: String(idx).padStart(4, "0"),
+    };
+  });
+}

package/src/types.ts

@@ -12,7 +12,7 @@ export type {
 
 import type { AnalysisRegistry, DiagnosticSeverity, PositionIndex, Range } from "@telorun/analyzer";
 
-export type CompletionKind = "class" | "enumMember" | "property";
+export type CompletionKind = "class" | "enumMember" | "property" | "folder" | "module" | "value";
 
 export interface CompletionResult {
   label: string;
@@ -23,6 +23,39 @@ export interface CompletionResult {
   snippet?: boolean;
   preselect?: boolean;
   sortText?: string;
+  filterText?: string;
+  /** When set, the host should replace text from this 0-based column on the
+   *  cursor's line up to the cursor. Required when the completion value
+   *  contains non-word characters (`/`, `@`, `.`) that the host's default
+   *  word boundary would not include in the replaced range. */
+  replaceFromColumn?: number;
+}
+
+export interface RegistryModule {
+  namespace: string;
+  name: string;
+  version: string;
+  description?: string;
+}
+
+/** Host-supplied bridge that lets ide-support reach the filesystem and the
+ *  module registry without depending on Node, Tauri, or vscode APIs. Each
+ *  host (VSCode extension, Telo editor) builds an adapter scoped to the
+ *  currently-edited manifest before calling `buildCompletions`. */
+export interface IdeEnvironmentAdapter {
+  /** Subdirectory names within `relPath` (resolved against the manifest's
+   *  directory). Returns [] if the path doesn't exist or isn't a directory.
+   *  Never throws — hosts swallow ENOENT and similar. */
+  listDirectories(relPath: string): Promise<string[]>;
+  /** True iff `<relPath>/telo.yaml` exists relative to the manifest dir.
+   *  Used to mark directories that are valid `Telo.Import` targets. */
+  hasManifest(relPath: string): Promise<boolean>;
+  /** Free-text search against the configured module registry. Matches against
+   *  name, namespace, and description. Empty `query` should return the full
+   *  (capped) catalog. */
+  searchRegistry(query: string): Promise<RegistryModule[]>;
+  /** All published versions for a module, newest first. */
+  listRegistryVersions(namespace: string, name: string): Promise<string[]>;
 }
 
 export interface NormalizedDiagnostic {