@telorun/ide-support 0.5.0 → 0.7.0

package/dist/definition/build-definition.js

@@ -0,0 +1,98 @@
+import { parseToAst, } from "@telorun/analyzer";
+import { resolveNodeAtPosition } from "../completions/resolve-node.js";
+/** The module whose owner or partials includes `filePath`. */
+function moduleForFile(graph, filePath) {
+    for (const mod of graph.modules.values()) {
+        if (mod.owner.source === filePath)
+            return mod;
+        if (mod.partials.some((p) => p.source === filePath))
+            return mod;
+    }
+    return undefined;
+}
+/** First resource named `name` across `files`, located at its `metadata.name`
+ *  (or its first line as a fallback). Names are unique within a module scope, so
+ *  the first hit is the definition. */
+function locateResource(files, name) {
+    for (const file of files) {
+        for (let i = 0; i < file.manifests.length; i++) {
+            const manifest = file.manifests[i];
+            if (!manifest || manifest.metadata?.name !== name)
+                continue;
+            const pos = file.positions[i];
+            const range = pos?.positionIndex.get("metadata.name") ??
+                pos?.positionIndex.get("@key:metadata.name") ??
+                (pos ? { start: { line: pos.sourceLine, character: 0 }, end: { line: pos.sourceLine, character: 0 } } : undefined);
+            if (range)
+                return { uri: file.source, range };
+        }
+    }
+    return undefined;
+}
+/** The `exports.resources` list of a module's owner doc (empty when absent). */
+function exportedResources(mod) {
+    const doc = mod.owner.manifests.find((m) => m?.kind === "Telo.Library" || m?.kind === "Telo.Application");
+    const list = doc?.exports?.resources;
+    return Array.isArray(list) ? list.filter((e) => typeof e === "string") : [];
+}
+/** Follow `name` into `moduleSource` across the export boundary, honoring the
+ *  `exports.resources` gate and re-export chains (`app → api → domain → …`). A
+ *  terminal match is a locally-owned instance the module actually exports; a
+ *  re-export entry `InnerAlias.name` hops through that module's own import edge.
+ *  `seen` bounds cyclic import graphs. */
+function resolveExported(graph, moduleSource, name, seen = new Set()) {
+    if (seen.has(moduleSource))
+        return undefined;
+    seen.add(moduleSource);
+    const mod = graph.modules.get(moduleSource);
+    if (!mod)
+        return undefined;
+    const exports = exportedResources(mod);
+    // No `exports.resources` block → ungated (the module hasn't opted into the
+    // gate, same as `exports.kinds`): a plain name match keeps navigation working
+    // for modules that predate explicit exports.
+    if (exports.length === 0) {
+        return locateResource([mod.owner, ...mod.partials], name);
+    }
+    if (exports.includes(name)) {
+        const local = locateResource([mod.owner, ...mod.partials], name);
+        if (local)
+            return local;
+    }
+    const reexport = exports.find((e) => e.endsWith(`.${name}`));
+    if (!reexport)
+        return undefined;
+    const innerAlias = reexport.slice(0, reexport.length - name.length - 1);
+    const edge = graph.importEdges.get(mod.owner.source)?.get(innerAlias);
+    return edge ? resolveExported(graph, edge.targetSource, name, seen) : undefined;
+}
+/** Resolve the `!ref` under the cursor to its target resource's definition.
+ *
+ *  The ref grammar mirrors `resolveRefSentinels`: the tag's value is split on
+ *  the first dot — a bare name (or `Self.name`) is a local resource in the
+ *  current module; `Alias.name` is an exported instance of the module the import
+ *  `Alias` points at, followed transitively through re-exports and gated on each
+ *  module's `exports.resources`. Returns `undefined` when the cursor isn't on a
+ *  `!ref`, or the target can't be found (e.g. a scope-local name, an unexported
+ *  instance, or an import that failed to load). */
+export function buildDefinition(text, line, character, graph, currentFilePath, docs) {
+    const astDocs = docs ?? parseToAst(text);
+    const node = resolveNodeAtPosition(text, astDocs, line, character)?.node;
+    if (!node || node.kind !== "scalar" || node.tag !== "!ref")
+        return undefined;
+    // The scalar's range covers the ref target text (the value after `!ref`).
+    const source = text.slice(node.range[0], node.range[1]).trim();
+    if (!source)
+        return undefined;
+    const currentModule = moduleForFile(graph, currentFilePath) ?? graph.entry;
+    const dot = source.indexOf(".");
+    const alias = dot === -1 ? undefined : source.slice(0, dot);
+    const name = dot === -1 ? source : source.slice(dot + 1);
+    if (alias === undefined || alias === "Self") {
+        return locateResource([currentModule.owner, ...currentModule.partials], name);
+    }
+    const edge = graph.importEdges.get(currentModule.owner.source)?.get(alias);
+    if (!edge)
+        return undefined;
+    return resolveExported(graph, edge.targetSource, name);
+}

package/dist/definition/index.d.ts

@@ -0,0 +1,2 @@
+export { buildDefinition } from "./build-definition.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/definition/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/definition/index.js

@@ -0,0 +1 @@
+export { buildDefinition } from "./build-definition.js";

package/dist/hover/build-hover.d.ts

@@ -0,0 +1,4 @@
+import { type AnalysisRegistry, type AstDocument } from "@telorun/analyzer";
+import type { HoverResult } from "../types.js";
+export declare function buildHover(text: string, line: number, character: number, registry: AnalysisRegistry | undefined, docs?: AstDocument[]): HoverResult | undefined;
+//# sourceMappingURL=build-hover.d.ts.map

package/dist/hover/build-hover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-hover.d.ts","sourceRoot":"","sources":["../../src/hover/build-hover.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,WAAW,EACjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAoF/C,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,gBAAgB,GAAG,SAAS,EACtC,IAAI,CAAC,EAAE,WAAW,EAAE,GACnB,WAAW,GAAG,SAAS,CAOzB"}

package/dist/hover/build-hover.js

@@ -0,0 +1,125 @@
+import { parseToAst, } from "@telorun/analyzer";
+import { navigateSchema } from "../completions/detect-context.js";
+import { resolveNodeAtPosition, scalarString, } from "../completions/resolve-node.js";
+import { CAPABILITY_DOCS } from "../completions/valid-capabilities.js";
+/** Docs for the structural keys shared by every module doc, so hover is useful
+ *  even at the root, where there is no user-authored schema to navigate. */
+const STRUCTURAL_KEY_DOCS = {
+    kind: "The resource kind — `Alias.Name` for an imported kind, or a `Telo.*` root kind.",
+    metadata: "Resource identity: `name` (kebab-case, dot-free) and optional `namespace`.",
+    imports: "Dependency map: PascalCase alias → `namespace/name@version` source string or object.",
+    targets: "Boot sequence run after init — references to `Runnable`/`Service` resources or inline invoke steps.",
+    variables: "Typed inputs bound from host env vars (`env:` + JSON-Schema `type:`).",
+    secrets: "Secret inputs bound from host env vars (`env:` + `type:`).",
+    ports: "Inbound ports the app listens on, each bound to a host env var (Application only).",
+    exports: "What importers may reference: `kinds` (kind gate) and `resources` (instance singletons).",
+    include: "Partial files loaded into this module scope (paths / globs).",
+    capability: "The lifecycle role of the kind this definition registers.",
+    schema: "JSON Schema for the kind's config fields, with `x-telo-*` annotations.",
+    extends: "Alias-form kind this definition specializes (abstract contract or concrete parent).",
+    base: "Construction mapping (`super(...)`) over `self` for a concrete-`extends` definition.",
+    controllers: "Controller locator (`pkg:npm`) implementing this kind.",
+};
+/** The kind value of the map that directly encloses `keyName` in the value slot. */
+function typeName(t) {
+    if (typeof t === "string")
+        return t;
+    if (t && typeof t === "object" && typeof t.title === "string")
+        return t.title;
+    return undefined;
+}
+function kindHover(kind, def) {
+    if (!def)
+        return `\`${kind}\``;
+    const lines = [`### ${kind}`];
+    const role = def.capability ? `\`${def.capability}\`` : "resource";
+    const module = def.metadata?.module ? ` · module \`${def.metadata.module}\`` : "";
+    lines.push(`${role}${module}`);
+    const schema = def.schema;
+    const desc = schema?.description ?? schema?.title;
+    if (typeof desc === "string" && desc)
+        lines.push("", desc);
+    if (def.extends)
+        lines.push("", `Extends \`${def.extends}\``);
+    const input = typeName(def.inputType);
+    const output = typeName(def.outputType);
+    if (input)
+        lines.push(`Input \`${input}\``);
+    if (output)
+        lines.push(`Output \`${output}\``);
+    return lines.join("\n");
+}
+function fieldHover(keyName, field) {
+    const lines = [];
+    const type = Array.isArray(field.type) ? field.type.join(" | ") : field.type;
+    const head = type ? `**${keyName}**: \`${type}\`` : `**${keyName}**`;
+    lines.push(head);
+    if (typeof field.description === "string" && field.description) {
+        lines.push("", field.description);
+    }
+    const ref = field["x-telo-ref"];
+    if (typeof ref === "string")
+        lines.push("", `Reference → \`${ref}\``);
+    if (Array.isArray(field.enum) && field.enum.length > 0) {
+        lines.push("", `Allowed: ${field.enum.map((v) => `\`${v}\``).join(", ")}`);
+    }
+    if (field.default !== undefined)
+        lines.push(`Default: \`${JSON.stringify(field.default)}\``);
+    return lines.length > 0 ? lines.join("\n") : `**${keyName}**`;
+}
+/** Field schema at the nearest enclosing resource, or undefined when the scope
+ *  can't be resolved (no kind-bearing ancestor, or the path doesn't navigate). */
+function fieldSchemaFor(resourceKind, relativePath, registry) {
+    if (!resourceKind || !registry)
+        return undefined;
+    const def = registry.resolveDefinition(resourceKind);
+    if (!def?.schema)
+        return undefined;
+    return navigateSchema(def.schema, relativePath);
+}
+export function buildHover(text, line, character, registry, docs) {
+    const astDocs = docs ?? parseToAst(text);
+    const resolved = resolveNodeAtPosition(text, astDocs, line, character);
+    if (!resolved)
+        return undefined;
+    if (resolved.slot === "value")
+        return hoverForValue(resolved, registry);
+    return hoverForKey(resolved, registry);
+}
+function hoverForValue(resolved, registry) {
+    const key = resolved.path[resolved.path.length - 1];
+    const value = scalarString(resolved.node);
+    const range = resolved.replaceRange;
+    if (key === "kind" && value) {
+        return { contents: kindHover(value, registry?.resolveDefinition(value)), range };
+    }
+    if (key === "capability" && resolved.docKind === "Telo.Definition" && value) {
+        const doc = CAPABILITY_DOCS[value];
+        return doc ? { contents: `**${value}**\n\n${doc}`, range } : undefined;
+    }
+    // Field value: describe the field via the enclosing resource's schema. Works
+    // when the value sits directly under a kind-bearing map (`siblingKind`); the
+    // field path relative to that map is just the key.
+    if (key) {
+        const field = fieldSchemaFor(resolved.siblingKind, [key], registry);
+        if (field)
+            return { contents: fieldHover(key, field), range };
+    }
+    return undefined;
+}
+function hoverForKey(resolved, registry) {
+    const keyName = scalarString(resolved.node);
+    if (!keyName)
+        return undefined;
+    const range = resolved.replaceRange;
+    const resourceKind = resolved.resourceKind ?? resolved.docKind;
+    const relativePath = [...resolved.path.slice(resolved.resourceDepth ?? 0), keyName];
+    const field = fieldSchemaFor(resourceKind, relativePath, registry);
+    if (field)
+        return { contents: fieldHover(keyName, field), range };
+    const structural = STRUCTURAL_KEY_DOCS[keyName];
+    if (structural && relativePath.length === 1) {
+        return { contents: `**${keyName}**\n\n${structural}`, range };
+    }
+    return undefined;
+}

package/dist/hover/index.d.ts

@@ -0,0 +1,2 @@
+export { buildHover } from "./build-hover.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hover/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/hover/index.js

@@ -0,0 +1 @@
+export { buildHover } from "./build-hover.js";

package/dist/index.d.ts

@@ -1,4 +1,7 @@
 export * from "./types.js";
 export * from "./completions/index.js";
 export * from "./diagnostics/index.js";
+export * from "./hover/index.js";
+export * from "./semantic-tokens/index.js";
+export * from "./definition/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC"}

package/dist/index.js

@@ -1,3 +1,6 @@
 export * from "./types.js";
 export * from "./completions/index.js";
 export * from "./diagnostics/index.js";
+export * from "./hover/index.js";
+export * from "./semantic-tokens/index.js";
+export * from "./definition/index.js";

package/dist/semantic-tokens/build-semantic-tokens.d.ts

@@ -0,0 +1,12 @@
+import { type AnalysisRegistry, type AstDocument } from "@telorun/analyzer";
+import type { SemanticToken } from "../types.js";
+/** Registry-aware semantic tokens: a `kind:` value that resolves to a known
+ *  definition is a `type`; a `capability:` value is an `interface`; a `!ref`
+ *  target is a `variable`. Everything else (structure, CEL, tags) is left to the
+ *  TextMate grammar. Ref targets are colored here rather than in the grammar
+ *  because a `!ref` after a `key:` is tokenized by the bundled YAML grammar
+ *  before a Telo pattern can claim it — the AST sees it unambiguously. An
+ *  unresolved kind gets no token, so a typo stays uncolored — a quiet signal
+ *  that pairs with the analyzer's `UNDEFINED_KIND` diagnostic. */
+export declare function buildSemanticTokens(text: string, registry: AnalysisRegistry | undefined, docs?: AstDocument[]): SemanticToken[];
+//# sourceMappingURL=build-semantic-tokens.d.ts.map

package/dist/semantic-tokens/build-semantic-tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-semantic-tokens.d.ts","sourceRoot":"","sources":["../../src/semantic-tokens/build-semantic-tokens.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAEjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAMjD;;;;;;;kEAOkE;AAClE,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,gBAAgB,GAAG,SAAS,EACtC,IAAI,CAAC,EAAE,WAAW,EAAE,GACnB,aAAa,EAAE,CAqCjB"}

package/dist/semantic-tokens/build-semantic-tokens.js

@@ -0,0 +1,55 @@
+import { buildLineOffsets, offsetToPosition, parseToAst, } from "@telorun/analyzer";
+import { scalarString } from "../completions/resolve-node.js";
+import { CAPABILITY_VALUES } from "../completions/valid-capabilities.js";
+const CAPABILITIES = new Set(CAPABILITY_VALUES);
+/** Registry-aware semantic tokens: a `kind:` value that resolves to a known
+ *  definition is a `type`; a `capability:` value is an `interface`; a `!ref`
+ *  target is a `variable`. Everything else (structure, CEL, tags) is left to the
+ *  TextMate grammar. Ref targets are colored here rather than in the grammar
+ *  because a `!ref` after a `key:` is tokenized by the bundled YAML grammar
+ *  before a Telo pattern can claim it — the AST sees it unambiguously. An
+ *  unresolved kind gets no token, so a typo stays uncolored — a quiet signal
+ *  that pairs with the analyzer's `UNDEFINED_KIND` diagnostic. */
+export function buildSemanticTokens(text, registry, docs) {
+    const astDocs = docs ?? parseToAst(text);
+    const lineOffsets = buildLineOffsets(text);
+    const tokens = [];
+    const emit = (node, type) => {
+        if (!node)
+            return;
+        const start = offsetToPosition(node.range[0], lineOffsets);
+        const end = offsetToPosition(node.range[1], lineOffsets);
+        // Kind / capability values never span lines; a clamped single-line token.
+        if (start.line !== end.line)
+            return;
+        tokens.push({ line: start.line, character: start.character, length: end.character - start.character, type });
+    };
+    const walk = (node) => {
+        if (node.kind === "map") {
+            for (const pair of node.entries) {
+                const key = scalarString(pair.key);
+                const value = scalarString(pair.value);
+                if (key === "kind" && value && registry?.resolveDefinition(value)) {
+                    emit(pair.value, "type");
+                }
+                else if (key === "capability" && value && CAPABILITIES.has(value)) {
+                    emit(pair.value, "interface");
+                }
+                if (pair.value)
+                    walk(pair.value);
+            }
+        }
+        else if (node.kind === "seq") {
+            for (const item of node.items)
+                walk(item);
+        }
+        else if (node.kind === "scalar" && node.tag === "!ref") {
+            emit(node, "variable");
+        }
+    };
+    for (const doc of astDocs) {
+        if (doc.root)
+            walk(doc.root);
+    }
+    return tokens;
+}

package/dist/semantic-tokens/index.d.ts

@@ -0,0 +1,2 @@
+export { buildSemanticTokens } from "./build-semantic-tokens.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/semantic-tokens/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/semantic-tokens/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/semantic-tokens/index.js

@@ -0,0 +1 @@
+export { buildSemanticTokens } from "./build-semantic-tokens.js";

package/dist/types.d.ts

@@ -1,7 +1,12 @@
 export { AnalysisRegistry, DiagnosticSeverity } from "@telorun/analyzer";
 export type { Position, Range, AnalysisDiagnostic, PositionIndex, } from "@telorun/analyzer";
-import type { AnalysisRegistry, DiagnosticSeverity, PositionIndex, Range } from "@telorun/analyzer";
+import type { AnalysisRegistry, DiagnosticSeverity, Position, PositionIndex, Range } from "@telorun/analyzer";
 export type CompletionKind = "class" | "enumMember" | "property" | "folder" | "module" | "value";
+/** A source span the host replaces wholesale when a completion is accepted. */
+export interface ReplaceRange {
+    start: Position;
+    end: Position;
+}
 export interface CompletionResult {
     label: string;
     kind: CompletionKind;
@@ -12,22 +17,62 @@ export interface CompletionResult {
     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;
+    /** When set, the host replaces this whole source range with the accepted
+     *  value — the full span of the existing node, not just the prefix up to the
+     *  cursor. This overwrites any suffix after the cursor (`Sql.Co|nnection` +
+     *  `Sql.Connection` → no leftover `nnection`) and cleanly replaces values
+     *  containing non-word characters (`/`, `@`, `.`). A zero-width range is a
+     *  pure insert. */
+    replaceRange?: ReplaceRange;
+}
+/** Rendered hover for the symbol under the cursor. `contents` is GitHub-flavored
+ *  markdown; `range` (when present) is the source span the host underlines. */
+export interface HoverResult {
+    contents: string;
+    range?: ReplaceRange;
+}
+/** Semantic token type names emitted by `buildSemanticTokens`. Kept to the
+ *  standard VS Code / LSP set so hosts register them against a stock legend and
+ *  every theme colors them without extra configuration. `type` marks a resolved
+ *  resource kind; `interface` marks a capability value; `variable` marks a
+ *  `!ref` target. */
+export type SemanticTokenType = "type" | "interface" | "variable";
+/** The legend a host registers before mapping `buildSemanticTokens` output. The
+ *  numeric token-type of each `SemanticToken` is its index in this array. */
+export declare const SEMANTIC_TOKEN_LEGEND: readonly SemanticTokenType[];
+/** One absolute-positioned semantic token. Every Telo semantic token is
+ *  single-line (kinds and capabilities never wrap), so a `{line, char, length}`
+ *  triple is sufficient; the host encodes it into its own builder. */
+export interface SemanticToken {
+    line: number;
+    character: number;
+    length: number;
+    type: SemanticTokenType;
+}
+/** Where a `!ref` target is defined — for go-to-definition. `uri` is the
+ *  target file's canonical source (absolute path for local files, an http/oci
+ *  URL for a registry import); `range` spans the target resource's
+ *  `metadata.name` (falling back to its first line). */
+export interface DefinitionResult {
+    uri: string;
+    range: Range;
 }
-export interface RegistryModule {
-    namespace: string;
-    name: string;
-    version: string;
+/** A candidate module ref surfaced by the hub's `/refs` lexical autocomplete.
+ *  Identity is the location ref, never `namespace/name` — an OCI module has no
+ *  addressable `namespace/name`. `latestVersion` seeds a pinned `ref@version`
+ *  insert so a picked completion is directly usable. */
+export interface HubRef {
+    ref: string;
+    latestVersion: 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
+ *  federated telo hub 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`. */
+ *  currently-edited manifest before calling `buildCompletions`. Hub lookups are
+ *  ref-keyed: the hub aggregates modules across every transport (OCI, HTTP,
+ *  direct URL), so completion speaks its `/refs` + `/module/versions` verbs
+ *  rather than any single registry. */
 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.
@@ -36,12 +81,15 @@ export interface IdeEnvironmentAdapter {
     /** True iff `<relPath>/telo.yaml` exists relative to the manifest dir.
      *  Used to mark directories that are valid 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[]>;
+    /** Fuzzy lexical ref autocomplete against the configured telo hub
+     *  (`GET /refs?q=`). The query is matched as a substring over every
+     *  registered ref, so a bare token (`youtrack`) hits the same ref as its full
+     *  `oci://…` form. Best-effort — hosts swallow network errors and return []. */
+    searchRefs(query: string): Promise<HubRef[]>;
+    /** All tracked versions for a location ref, newest first
+     *  (`GET /module/versions?ref=`). The browser cannot call OCI `tags/list`;
+     *  the hub holds them from ingest. */
+    listVersionsForRef(ref: 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,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;kEAC8D;IAC9D,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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -1,3 +1,6 @@
 // Runtime values (classes, enums) — consumers who need `new AnalysisRegistry()`
 // or `DiagnosticSeverity.Error` import from here.
 export { AnalysisRegistry, DiagnosticSeverity } from "@telorun/analyzer";
+/** The legend a host registers before mapping `buildSemanticTokens` output. The
+ *  numeric token-type of each `SemanticToken` is its index in this array. */
+export const SEMANTIC_TOKEN_LEGEND = ["type", "interface", "variable"];

package/package.json

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