@birdcc/lsp 0.0.1-alpha.0

package/dist/symbol-utils.js

@@ -0,0 +1,84 @@
+const addToMapList = (map, key, value) => {
+    const existing = map.get(key);
+    if (existing) {
+        existing.push(value);
+        return;
+    }
+    map.set(key, [value]);
+};
+export const containsPosition = (range, position) => {
+    const line = position.line + 1;
+    const column = position.character + 1;
+    if (line < range.line || line > range.endLine) {
+        return false;
+    }
+    if (line === range.line && column < range.column) {
+        return false;
+    }
+    if (line === range.endLine && column > range.endColumn) {
+        return false;
+    }
+    return true;
+};
+export const toLocation = (symbol) => ({
+    uri: symbol.uri,
+    range: {
+        start: {
+            line: Math.max(0, symbol.line - 1),
+            character: Math.max(0, symbol.column - 1),
+        },
+        end: {
+            line: Math.max(0, symbol.endLine - 1),
+            character: Math.max(0, symbol.endColumn - 1),
+        },
+    },
+});
+export const extractWordAtPosition = (text, position) => {
+    const lineText = text.split(/\r?\n/)[position.line] ?? "";
+    if (position.character < 0 || position.character > lineText.length) {
+        return "";
+    }
+    let start = position.character;
+    while (start > 0 && /[A-Za-z0-9_]/.test(lineText[start - 1] ?? "")) {
+        start -= 1;
+    }
+    let end = position.character;
+    while (end < lineText.length && /[A-Za-z0-9_]/.test(lineText[end] ?? "")) {
+        end += 1;
+    }
+    return lineText.slice(start, end).trim();
+};
+export const dedupeLocations = (locations) => {
+    const seen = new Set();
+    const output = [];
+    for (const location of locations) {
+        const key = [
+            location.uri,
+            location.range.start.line,
+            location.range.start.character,
+            location.range.end.line,
+            location.range.end.character,
+        ].join(":");
+        if (seen.has(key)) {
+            continue;
+        }
+        seen.add(key);
+        output.push(location);
+    }
+    return output;
+};
+export const createSymbolLookupIndex = (definitions, references) => {
+    const definitionsByName = new Map();
+    const referencesByName = new Map();
+    for (const definition of definitions) {
+        addToMapList(definitionsByName, definition.name.toLowerCase(), definition);
+    }
+    for (const reference of references) {
+        addToMapList(referencesByName, reference.name.toLowerCase(), reference);
+    }
+    return {
+        definitionsByName,
+        referencesByName,
+    };
+};
+//# sourceMappingURL=symbol-utils.js.map

package/dist/symbol-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbol-utils.js","sourceRoot":"","sources":["../src/symbol-utils.ts"],"names":[],"mappings":"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"}

package/dist/validation.d.ts

@@ -0,0 +1,21 @@
+export interface ValidationDocument {
+    uri: string;
+    version: number;
+    getText(): string;
+}
+export interface ValidationPublishPayload<TDiagnostic> {
+    uri: string;
+    version?: number;
+    diagnostics: TDiagnostic[];
+}
+export interface ValidationSchedulerOptions<TDocument extends ValidationDocument, TDiagnostic> {
+    debounceMs: number;
+    validate(document: TDocument): Promise<TDiagnostic[]>;
+    publish(payload: ValidationPublishPayload<TDiagnostic>): void;
+}
+export interface ValidationScheduler<TDocument extends ValidationDocument> {
+    schedule(document: TDocument): void;
+    close(uri: string): void;
+}
+export declare const createValidationScheduler: <TDocument extends ValidationDocument, TDiagnostic>(options: ValidationSchedulerOptions<TDocument, TDiagnostic>) => ValidationScheduler<TDocument>;
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,IAAI,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,wBAAwB,CAAC,WAAW;IACnD,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,WAAW,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,0BAA0B,CACzC,SAAS,SAAS,kBAAkB,EACpC,WAAW;IAEX,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,QAAQ,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACtD,OAAO,CAAC,OAAO,EAAE,wBAAwB,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC;CAC/D;AAED,MAAM,WAAW,mBAAmB,CAAC,SAAS,SAAS,kBAAkB;IACvE,QAAQ,CAAC,QAAQ,EAAE,SAAS,GAAG,IAAI,CAAC;IACpC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,eAAO,MAAM,yBAAyB,GACpC,SAAS,SAAS,kBAAkB,EACpC,WAAW,EAEX,SAAS,0BAA0B,CAAC,SAAS,EAAE,WAAW,CAAC,KAC1D,mBAAmB,CAAC,SAAS,CAqD/B,CAAC"}

package/dist/validation.js

@@ -0,0 +1,47 @@
+export const createValidationScheduler = (options) => {
+    const pendingTimers = new Map();
+    const latestTicketByUri = new Map();
+    const latestVersionByUri = new Map();
+    let nextTicket = 0;
+    const clearPending = (uri) => {
+        const pendingTimer = pendingTimers.get(uri);
+        if (!pendingTimer) {
+            return;
+        }
+        clearTimeout(pendingTimer);
+        pendingTimers.delete(uri);
+    };
+    const runValidation = async (document) => {
+        const uri = document.uri;
+        const ticket = ++nextTicket;
+        latestTicketByUri.set(uri, ticket);
+        latestVersionByUri.set(uri, document.version);
+        const diagnostics = await options.validate(document);
+        if (latestTicketByUri.get(uri) !== ticket) {
+            return;
+        }
+        options.publish({ uri, version: document.version, diagnostics });
+    };
+    return {
+        schedule: (document) => {
+            clearPending(document.uri);
+            const timer = setTimeout(() => {
+                pendingTimers.delete(document.uri);
+                void runValidation(document);
+            }, options.debounceMs);
+            pendingTimers.set(document.uri, timer);
+        },
+        close: (uri) => {
+            clearPending(uri);
+            latestTicketByUri.delete(uri);
+            const version = latestVersionByUri.get(uri);
+            latestVersionByUri.delete(uri);
+            options.publish({
+                uri,
+                version,
+                diagnostics: [],
+            });
+        },
+    };
+};
+//# sourceMappingURL=validation.js.map

package/dist/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AA0BA,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAIvC,OAA2D,EAC3B,EAAE;IAClC,MAAM,aAAa,GAAG,IAAI,GAAG,EAAyC,CAAC;IACvE,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAkB,CAAC;IACpD,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAAkB,CAAC;IACrD,IAAI,UAAU,GAAG,CAAC,CAAC;IAEnB,MAAM,YAAY,GAAG,CAAC,GAAW,EAAQ,EAAE;QACzC,MAAM,YAAY,GAAG,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5C,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QAED,YAAY,CAAC,YAAY,CAAC,CAAC;QAC3B,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC,CAAC;IAEF,MAAM,aAAa,GAAG,KAAK,EAAE,QAAmB,EAAiB,EAAE;QACjE,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC;QACzB,MAAM,MAAM,GAAG,EAAE,UAAU,CAAC;QAC5B,iBAAiB,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACnC,kBAAkB,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;QAE9C,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACrD,IAAI,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,MAAM,EAAE,CAAC;YAC1C,OAAO;QACT,CAAC;QAED,OAAO,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;IACnE,CAAC,CAAC;IAEF,OAAO;QACL,QAAQ,EAAE,CAAC,QAAmB,EAAQ,EAAE;YACtC,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;YAE3B,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC5B,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;gBACnC,KAAK,aAAa,CAAC,QAAQ,CAAC,CAAC;YAC/B,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;YAEvB,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACzC,CAAC;QACD,KAAK,EAAE,CAAC,GAAW,EAAQ,EAAE;YAC3B,YAAY,CAAC,GAAG,CAAC,CAAC;YAClB,iBAAiB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC9B,MAAM,OAAO,GAAG,kBAAkB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC5C,kBAAkB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC/B,OAAO,CAAC,OAAO,CAAC;gBACd,GAAG;gBACH,OAAO;gBACP,WAAW,EAAE,EAAE;aAChB,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@birdcc/lsp",
+  "version": "0.0.1-alpha.0",
+  "private": false,
+  "type": "module",
+  "license": "GPL-3.0-only",
+  "author": {
+    "name": "BIRD Chinese Community",
+    "email": "npm-dev@birdcc.link",
+    "url": "https://github.com/bird-chinese-community/"
+  },
+  "main": "./dist/index.js",
+  "types": "./src/index.ts",
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "yaml": "^2.8.2",
+    "vscode-languageserver": "^9.0.1",
+    "vscode-languageserver-textdocument": "^1.0.12",
+    "@birdcc/linter": "0.0.1-alpha.0",
+    "@birdcc/core": "0.0.1-alpha.0",
+    "@birdcc/parser": "0.0.1-alpha.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/bird-chinese-community/BIRD-LSP",
+    "directory": "packages/@birdcc/lsp"
+  },
+  "homepage": "https://github.com/bird-chinese-community/BIRD-LSP/blob/main/packages/%40birdcc/lsp/README.md",
+  "bugs": {
+    "url": "https://github.com/bird-chinese-community/BIRD-LSP/issues"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json && node scripts/copy-hover-yaml.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "oxlint --deny-warnings src test",
+    "test": "vitest run",
+    "format": "oxfmt .",
+    "coverage": "vitest run --coverage --coverage.provider=v8 --coverage.reporter=text-summary --coverage.reporter=json-summary"
+  }
+}

package/scripts/copy-hover-yaml.mjs

@@ -0,0 +1,14 @@
+import { copyFile, mkdir } from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const packageRoot = path.resolve(__dirname, "..");
+
+const sourcePath = path.join(packageRoot, "src", "hover-docs.yaml");
+const targetDir = path.join(packageRoot, "dist");
+const targetPath = path.join(targetDir, "hover-docs.yaml");
+
+await mkdir(targetDir, { recursive: true });
+await copyFile(sourcePath, targetPath);

package/src/completion.ts

@@ -0,0 +1,223 @@
+import {
+  CompletionItemKind,
+  InsertTextFormat,
+  type CompletionItem,
+} from "vscode-languageserver/node.js";
+import type { ParsedBirdDocument } from "@birdcc/parser";
+import { declarationMetadata, KEYWORD_DOCS } from "./shared.js";
+
+const COMPLETION_KEYWORDS = [
+  "protocol",
+  "template",
+  "filter",
+  "function",
+  "define",
+  "include",
+  "import",
+  "export",
+  "neighbor",
+  "local as",
+  "router id",
+  "table",
+  "ipv4",
+  "ipv6",
+];
+
+interface CompletionSnippet {
+  label: string;
+  detail: string;
+  documentation: string;
+  insertText: string;
+}
+
+const COMPLETION_SNIPPETS: CompletionSnippet[] = [
+  {
+    label: 'include "..."',
+    detail: "BIRD snippet",
+    documentation: "Insert include statement.",
+    insertText: 'include "${1:path/to/file.conf}";',
+  },
+  {
+    label: "define NAME = value;",
+    detail: "BIRD snippet",
+    documentation: "Insert define statement.",
+    insertText: "define ${1:NAME} = ${2:value};",
+  },
+  {
+    label: "router id 1.1.1.1;",
+    detail: "BIRD snippet",
+    documentation: "Insert router id statement.",
+    insertText: "router id ${1:1.1.1.1};",
+  },
+  {
+    label: "protocol bgp ...",
+    detail: "BIRD snippet",
+    documentation: "Insert minimal BGP protocol block.",
+    insertText:
+      "protocol bgp ${1:name} {\n  neighbor ${2:192.0.2.1} as ${3:65001};\n  local as ${4:65000};\n}",
+  },
+];
+
+export interface CompletionContextOptions {
+  linePrefix?: string;
+  additionalDeclarations?: ParsedBirdDocument["program"]["declarations"];
+}
+
+const isFromTemplateContext = (linePrefix: string): boolean =>
+  /\bfrom\s+[A-Za-z_][A-Za-z0-9_]*$/i.test(linePrefix) ||
+  /\bfrom\s*$/i.test(linePrefix);
+
+const isIncludePathContext = (linePrefix: string): boolean =>
+  /\binclude\s+["'][^"']*$/i.test(linePrefix);
+
+const isFilterContext = (linePrefix: string): boolean =>
+  /\b(?:import|export)\s+filter\s+[A-Za-z_][A-Za-z0-9_]*$/i.test(linePrefix) ||
+  /\b(?:import|export)\s+filter\s*$/i.test(linePrefix);
+
+const isTableContext = (linePrefix: string): boolean =>
+  /\btable\s+[A-Za-z_][A-Za-z0-9_]*$/i.test(linePrefix) ||
+  /\btable\s*$/i.test(linePrefix);
+
+const allDeclarations = (
+  parsed: ParsedBirdDocument,
+  options: CompletionContextOptions,
+): ParsedBirdDocument["program"]["declarations"] => {
+  const additional = options.additionalDeclarations ?? [];
+  if (additional.length === 0) {
+    return parsed.program.declarations;
+  }
+
+  return [...parsed.program.declarations, ...additional];
+};
+
+const keywordCompletionItems = (): CompletionItem[] =>
+  COMPLETION_KEYWORDS.map((keyword) => ({
+    label: keyword,
+    kind: CompletionItemKind.Keyword,
+    detail: "BIRD keyword",
+    documentation: KEYWORD_DOCS[keyword] ?? "",
+  }));
+
+const snippetCompletionItems = (): CompletionItem[] =>
+  COMPLETION_SNIPPETS.map((snippet) => ({
+    label: snippet.label,
+    kind: CompletionItemKind.Snippet,
+    detail: snippet.detail,
+    documentation: snippet.documentation,
+    insertText: snippet.insertText,
+    insertTextFormat: InsertTextFormat.Snippet,
+  }));
+
+const includePathCompletionItems = (
+  declarations: ParsedBirdDocument["program"]["declarations"],
+  options: { quoteWrapped: boolean },
+): CompletionItem[] => {
+  const paths = new Set<string>();
+
+  for (const declaration of declarations) {
+    if (declaration.kind !== "include") {
+      continue;
+    }
+
+    if (declaration.path.length > 0) {
+      paths.add(declaration.path);
+    }
+  }
+
+  return Array.from(paths).map((path) => ({
+    label: path,
+    kind: CompletionItemKind.File,
+    detail: "include path",
+    insertText: options.quoteWrapped ? path : `"${path}"`,
+  }));
+};
+
+const collectDeclarationCompletionItems = (
+  declarations: ParsedBirdDocument["program"]["declarations"],
+  predicate: (
+    declaration: ParsedBirdDocument["program"]["declarations"][number],
+  ) => boolean,
+): CompletionItem[] => {
+  const items: CompletionItem[] = [];
+  const seen = new Set<string>();
+
+  for (const declaration of declarations) {
+    if (!predicate(declaration)) {
+      continue;
+    }
+
+    const metadata = declarationMetadata(declaration);
+    if (!metadata?.completionLabel || seen.has(metadata.completionLabel)) {
+      continue;
+    }
+
+    seen.add(metadata.completionLabel);
+    items.push({
+      label: metadata.completionLabel,
+      kind: metadata.completionKind ?? CompletionItemKind.Reference,
+      detail: metadata.completionDetail ?? metadata.detail,
+    });
+  }
+
+  return items;
+};
+
+const templateCompletionItems = (
+  declarations: ParsedBirdDocument["program"]["declarations"],
+): CompletionItem[] =>
+  collectDeclarationCompletionItems(
+    declarations,
+    (declaration) => declaration.kind === "template",
+  );
+
+const filterCompletionItems = (
+  declarations: ParsedBirdDocument["program"]["declarations"],
+): CompletionItem[] =>
+  collectDeclarationCompletionItems(
+    declarations,
+    (declaration) => declaration.kind === "filter",
+  );
+
+const tableCompletionItems = (
+  declarations: ParsedBirdDocument["program"]["declarations"],
+): CompletionItem[] =>
+  collectDeclarationCompletionItems(
+    declarations,
+    (declaration) => declaration.kind === "table",
+  );
+
+const declarationCompletionItems = (
+  declarations: ParsedBirdDocument["program"]["declarations"],
+): CompletionItem[] => {
+  return collectDeclarationCompletionItems(declarations, () => true);
+};
+
+export const createCompletionItemsFromParsed = (
+  parsed: ParsedBirdDocument,
+  options: CompletionContextOptions = {},
+): CompletionItem[] => {
+  const linePrefix = options.linePrefix ?? "";
+  const declarations = allDeclarations(parsed, options);
+
+  if (isIncludePathContext(linePrefix)) {
+    return includePathCompletionItems(declarations, { quoteWrapped: true });
+  }
+
+  if (isFromTemplateContext(linePrefix)) {
+    return templateCompletionItems(declarations);
+  }
+
+  if (isFilterContext(linePrefix)) {
+    return filterCompletionItems(declarations);
+  }
+
+  if (isTableContext(linePrefix)) {
+    return tableCompletionItems(declarations);
+  }
+
+  return [
+    ...keywordCompletionItems(),
+    ...snippetCompletionItems(),
+    ...declarationCompletionItems(declarations),
+  ];
+};

package/src/definition.ts

@@ -0,0 +1,50 @@
+import type { SymbolTable } from "@birdcc/core";
+import type { Location, Position } from "vscode-languageserver/node.js";
+import {
+  containsPosition,
+  createSymbolLookupIndex,
+  dedupeLocations,
+  extractWordAtPosition,
+  toLocation,
+} from "./symbol-utils.js";
+
+/** Resolves symbol definition locations from a merged cross-file symbol table. */
+export const createDefinitionLocations = (
+  symbolTable: SymbolTable,
+  uri: string,
+  position: Position,
+  sourceText: string,
+): Location[] => {
+  const index = createSymbolLookupIndex(
+    symbolTable.definitions,
+    symbolTable.references,
+  );
+
+  const reference = symbolTable.references.find(
+    (item) => item.uri === uri && containsPosition(item, position),
+  );
+
+  if (reference) {
+    return dedupeLocations(
+      (index.definitionsByName.get(reference.name.toLowerCase()) ?? [])
+        .filter((definition) => definition.kind === reference.kind)
+        .map(toLocation),
+    );
+  }
+
+  const definition = symbolTable.definitions.find(
+    (item) => item.uri === uri && containsPosition(item, position),
+  );
+  if (definition) {
+    return [toLocation(definition)];
+  }
+
+  const name = extractWordAtPosition(sourceText, position);
+  if (!name) {
+    return [];
+  }
+
+  return dedupeLocations(
+    (index.definitionsByName.get(name.toLowerCase()) ?? []).map(toLocation),
+  );
+};

package/src/diagnostic.ts

@@ -0,0 +1,48 @@
+import {
+  DiagnosticSeverity,
+  type Diagnostic,
+} from "vscode-languageserver/node.js";
+import type { BirdDiagnostic } from "@birdcc/core";
+
+const toLspSeverity = (
+  severity: BirdDiagnostic["severity"],
+): DiagnosticSeverity => {
+  if (severity === "error") {
+    return DiagnosticSeverity.Error;
+  }
+
+  if (severity === "warning") {
+    return DiagnosticSeverity.Warning;
+  }
+
+  return DiagnosticSeverity.Information;
+};
+
+/** Maps Bird diagnostic schema into LSP Diagnostic schema. */
+export const toLspDiagnostic = (diagnostic: BirdDiagnostic): Diagnostic => ({
+  code: diagnostic.code,
+  message: diagnostic.message,
+  severity: toLspSeverity(diagnostic.severity),
+  source: diagnostic.source,
+  range: {
+    start: {
+      line: Math.max(diagnostic.range.line - 1, 0),
+      character: Math.max(diagnostic.range.column - 1, 0),
+    },
+    end: {
+      line: Math.max(diagnostic.range.endLine - 1, 0),
+      character: Math.max(diagnostic.range.endColumn - 1, 0),
+    },
+  },
+});
+
+export const toInternalErrorDiagnostic = (error: unknown): Diagnostic => ({
+  code: "lsp/internal-error",
+  message: error instanceof Error ? error.message : String(error),
+  severity: DiagnosticSeverity.Error,
+  source: "lsp",
+  range: {
+    start: { line: 0, character: 0 },
+    end: { line: 0, character: 1 },
+  },
+});

package/src/document-symbol.ts

@@ -0,0 +1,27 @@
+import type { DocumentSymbol } from "vscode-languageserver/node.js";
+import type { ParsedBirdDocument } from "@birdcc/parser";
+import { declarationMetadata, toLspRange } from "./shared.js";
+
+export const createDocumentSymbolsFromParsed = (
+  parsed: ParsedBirdDocument,
+): DocumentSymbol[] => {
+  const symbols: DocumentSymbol[] = [];
+
+  for (const declaration of parsed.program.declarations) {
+    const metadata = declarationMetadata(declaration);
+    if (!metadata) {
+      continue;
+    }
+
+    symbols.push({
+      name: metadata.symbolName,
+      detail: metadata.detail,
+      kind: metadata.symbolKind,
+      range: toLspRange(declaration),
+      selectionRange: toLspRange(metadata.selectionRange),
+      children: [],
+    });
+  }
+
+  return symbols;
+};