@birdcc/lsp 0.0.1-alpha.0

package/README.md

@@ -0,0 +1,343 @@
+<div align="center">
+
+# 🕊 BIRD Config LSP (@birdcc/lsp)
+
+</div>
+
+[![npm version](https://img.shields.io/badge/version-0.1.0--alpha-blue)](https://www.npmjs.com/package/@birdcc/lsp) [![License: GPL-3.0](https://img.shields.io/badge/License-GPL--3.0--only-green.svg)](https://www.gnu.org/licenses/gpl-3.0) [![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-3178c6?logo=typescript)](https://www.typescriptlang.org/) [![VSCode-languageserver](https://img.shields.io/badge/vscode--languageserver-powered-9f5ec2)](https://github.com/microsoft/vscode-languageserver-node)
+
+> [Overview](#overview) · [Features](#features) · [Installation](#installation) · [Usage](#usage) · [Editor Integration](#editor-integration) · [API Reference](#api-reference) · [Architecture](#architecture)
+
+## Overview
+
+**@birdcc/lsp** is the Language Server Protocol implementation for BIRD2 configuration files, delivering real-time diagnostics, intelligent code completion, hover tooltips, and more for editor integration.
+
+| Package | Version | Description |
+| ------- | ------- | ----------- |
+| `@birdcc/lsp` | 0.1.0 | LSP server implementation with real-time diagnostics |
+
+---
+
+## Features
+
+### LSP Capabilities
+
+- **Incremental Synchronization** — `TextDocumentSyncKind.Incremental` for efficient handling of large files
+- **Real-time Diagnostics** — Automatic validation on document open and modification
+- **Code Completion** — Auto-completion for keywords, symbols, and snippets
+- **Hover Information** — Type information and documentation on hover
+- **Go to Definition** — Navigate to symbol definitions
+- **Find References** — Find all references to a symbol
+- **Document Symbols** — Outline view for quick navigation
+
+### Protocol Features
+
+- **Standard LSP** — Full protocol support powered by `vscode-languageserver`
+- **Diagnostic Push** — Server-initiated diagnostic updates
+- **Workspace Folders** — Multi-root workspace support
+
+---
+
+## Installation
+
+```bash
+# Using pnpm (recommended)
+pnpm add @birdcc/lsp
+
+# Using npm
+npm install @birdcc/lsp
+
+# Using yarn
+yarn add @birdcc/lsp
+```
+
+---
+
+## Usage
+
+### Start LSP Server
+
+```bash
+# stdio mode (for editor integration)
+npx birdcc lsp --stdio
+```
+
+### Programmatic Usage
+
+```typescript
+import { startLspServer, toLspDiagnostic } from "@birdcc/lsp";
+import type { BirdDiagnostic } from "@birdcc/core";
+
+// Start the LSP server
+startLspServer();
+
+// Convert internal diagnostic to LSP format
+const lspDiagnostic = toLspDiagnostic(birdDiagnostic);
+```
+
+---
+
+## Editor Integration
+
+### Visual Studio Code
+
+```json
+// settings.json
+{
+  "bird-lsp.enable": true,
+  "bird-lsp.path": "./node_modules/.bin/birdcc",
+  "bird-lsp.validateWithBird": true
+}
+```
+
+### Neovim
+
+```lua
+-- init.lua with nvim-lspconfig
+local lspconfig = require("lspconfig")
+local configs = require("lspconfig.configs")
+
+if not configs.birdcc then
+  configs.birdcc = {
+    default_config = {
+      cmd = { "npx", "birdcc", "lsp", "--stdio" },
+      filetypes = { "bird", "conf" },
+      root_dir = lspconfig.util.root_pattern(".git", "bird.conf"),
+      single_file_support = true,
+    },
+  }
+end
+
+lspconfig.birdcc.setup({})
+```
+
+### Helix
+
+```toml
+# ~/.config/helix/languages.toml
+[[language]]
+name = "bird"
+file-types = ["conf"]
+roots = [".git", "bird.conf"]
+language-servers = ["birdcc"]
+
+[language-server.birdcc]
+command = "npx"
+args = ["birdcc", "lsp", "--stdio"]
+```
+
+---
+
+## API Reference
+
+### Exports
+
+```typescript
+import {
+  startLspServer,
+  toLspDiagnostic,
+  createConnection,
+} from "@birdcc/lsp";
+```
+
+### `startLspServer(): void`
+
+Start the LSP server with stdio transport.
+
+### `toLspDiagnostic(diagnostic: BirdDiagnostic): Diagnostic`
+
+Convert a BIRD diagnostic to LSP Diagnostic format.
+
+### Types
+
+```typescript
+interface LspOptions {
+  connection?: Connection;
+  documents?: TextDocuments<TextDocument>;
+}
+```
+
+---
+
+## Architecture
+
+### System Overview
+
+```mermaid
+flowchart TB
+    subgraph "Editor Layer"
+        E1[VS Code]
+        E2[Neovim]
+        E3[Vim]
+        E4[Helix]
+    end
+
+    subgraph "LSP Protocol"
+        LSP[LSP Protocol<br/>JSON-RPC]
+    end
+
+    subgraph "LSP Server"
+        S[@birdcc/lsp<br/>LSP Server]
+        SYNC[Document Sync<br/>Incremental]
+        DIAG[Diagnostics Handler]
+        COMP[Completion Provider]
+        HOVER[Hover Provider]
+        DEF[Definition Provider]
+    end
+
+    subgraph "Service Layer"
+        LINTER[@birdcc/linter<br/>32+ Rules]
+        FORMATTER[@birdcc/formatter<br/>dprint/builtin]
+    end
+
+    subgraph "Core Layer"
+        CORE[@birdcc/core<br/>Symbol Table]
+    end
+
+    subgraph "Parser Layer"
+        PARSER[@birdcc/parser<br/>Tree-sitter]
+    end
+
+    E1 --> LSP
+    E2 --> LSP
+    E3 --> LSP
+    E4 --> LSP
+    LSP --> S
+    S --> SYNC
+    S --> DIAG
+    S --> COMP
+    S --> HOVER
+    S --> DEF
+    DIAG --> LINTER
+    COMP --> CORE
+    HOVER --> CORE
+    DEF --> CORE
+    LINTER --> CORE
+    FORMATTER --> PARSER
+    CORE --> PARSER
+
+    style S fill:#e3f2fd
+    style LSP fill:#f3e5f5
+```
+
+### Request Handling Flow
+
+```mermaid
+sequenceDiagram
+    participant Editor as Editor
+    participant LSP as LSP Connection
+    participant Server as @birdcc/lsp
+    participant Services as Services
+    participant Core as @birdcc/core
+
+    Editor->>LSP: Initialize Request
+    LSP->>Server: onInitialize()
+    Server-->>LSP: ServerCapabilities
+    LSP-->>Editor: Initialize Result
+
+    Editor->>LSP: textDocument/didOpen
+    LSP->>Server: onDidOpen()
+    Server->>Services: validate(document)
+    Services->>Core: buildCoreSnapshot()
+    Core-->>Services: snapshot
+    Services-->>Server: diagnostics
+    Server->>LSP: publishDiagnostics
+    LSP->>Editor: Diagnostics
+
+    Editor->>LSP: textDocument/completion
+    LSP->>Server: onCompletion()
+    Server->>Core: getSymbols()
+    Core-->>Server: symbols[]
+    Server-->>LSP: CompletionItem[]
+    LSP-->>Editor: Completions
+
+    Editor->>LSP: textDocument/hover
+    LSP->>Server: onHover()
+    Server->>Core: resolveSymbol()
+    Core-->>Server: symbol info
+    Server-->>LSP: Hover
+    LSP-->>Editor: Tooltip
+```
+
+### Document Synchronization
+
+```mermaid
+flowchart LR
+    subgraph "Editor"
+        E[Document Changes]
+    end
+
+    subgraph "LSP Server"
+        S[Text Documents Manager]
+        AST[AST Cache]
+        SYM[Symbol Cache]
+    end
+
+    subgraph "Validation"
+        V[Validator]
+        D[Diagnostics Engine]
+    end
+
+    E -->|didChange| S
+    E -->|didOpen| S
+    E -->|didClose| S
+    S -->|parse| AST
+    AST -->|analyze| SYM
+    SYM -->|validate| V
+    V -->|report| D
+    D -->|publish| E
+
+    style S fill:#e3f2fd
+    style AST fill:#e8f5e9
+    style SYM fill:#fff3e0
+```
+
+### Server Capabilities
+
+| Capability | Status |
+| ---------- | ------ |
+| `textDocumentSync` | Incremental |
+| `documentSymbolProvider` | ✅ |
+| `hoverProvider` | ✅ |
+| `definitionProvider` | ✅ |
+| `referencesProvider` | ✅ |
+| `completionProvider` | ✅ |
+
+---
+
+## Related Packages
+
+| Package | Description |
+| ------- | ----------- |
+| [@birdcc/parser](../parser/) | Tree-sitter grammar and parser |
+| [@birdcc/core](../core/) | Semantic analysis engine |
+| [@birdcc/linter](../linter/) | 32+ lint rules |
+| [@birdcc/formatter](../formatter/) | Code formatting engine |
+| [@birdcc/cli](../cli/) | Command-line interface |
+
+---
+
+### 📖 Documentation
+
+- [BIRD Official Documentation](https://bird.network.cz/)
+- [BIRD2 User Manual](https://bird.network.cz/doc/bird.html)
+- [LSP Specification](https://microsoft.github.io/language-server-protocol/)
+- [GitHub Project](https://github.com/bird-chinese-community/BIRD-LSP)
+
+---
+
+## 📝 License
+
+This project is licensed under the [GPL-3.0 License](https://github.com/bird-chinese-community/BIRD-LSP/blob/main/LICENSE).
+
+---
+
+<p align="center">
+  <sub>Built with ❤️ by the BIRD Chinese Community (BIRDCC)</sub>
+</p>
+
+<p align="center">
+  <a href="https://github.com/bird-chinese-community/BIRD-LSP">🕊 GitHub</a> ·
+  <a href="https://marketplace.visualstudio.com/items?itemName=birdcc.bird2-lsp">🛒 Marketplace</a> ·
+  <a href="https://github.com/bird-chinese-community/BIRD-LSP/issues">🐛 Report Issues</a>
+</p>

package/dist/completion.d.ts

@@ -0,0 +1,8 @@
+import { type CompletionItem } from "vscode-languageserver/node.js";
+import type { ParsedBirdDocument } from "@birdcc/parser";
+export interface CompletionContextOptions {
+    linePrefix?: string;
+    additionalDeclarations?: ParsedBirdDocument["program"]["declarations"];
+}
+export declare const createCompletionItemsFromParsed: (parsed: ParsedBirdDocument, options?: CompletionContextOptions) => CompletionItem[];
+//# sourceMappingURL=completion.d.ts.map

package/dist/completion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.d.ts","sourceRoot":"","sources":["../src/completion.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAuDzD,MAAM,WAAW,wBAAwB;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sBAAsB,CAAC,EAAE,kBAAkB,CAAC,SAAS,CAAC,CAAC,cAAc,CAAC,CAAC;CACxE;AAmID,eAAO,MAAM,+BAA+B,GAC1C,QAAQ,kBAAkB,EAC1B,UAAS,wBAA6B,KACrC,cAAc,EAyBhB,CAAC"}

package/dist/completion.js

@@ -0,0 +1,137 @@
+import { CompletionItemKind, InsertTextFormat, } from "vscode-languageserver/node.js";
+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",
+];
+const COMPLETION_SNIPPETS = [
+    {
+        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}",
+    },
+];
+const isFromTemplateContext = (linePrefix) => /\bfrom\s+[A-Za-z_][A-Za-z0-9_]*$/i.test(linePrefix) ||
+    /\bfrom\s*$/i.test(linePrefix);
+const isIncludePathContext = (linePrefix) => /\binclude\s+["'][^"']*$/i.test(linePrefix);
+const isFilterContext = (linePrefix) => /\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) => /\btable\s+[A-Za-z_][A-Za-z0-9_]*$/i.test(linePrefix) ||
+    /\btable\s*$/i.test(linePrefix);
+const allDeclarations = (parsed, options) => {
+    const additional = options.additionalDeclarations ?? [];
+    if (additional.length === 0) {
+        return parsed.program.declarations;
+    }
+    return [...parsed.program.declarations, ...additional];
+};
+const keywordCompletionItems = () => COMPLETION_KEYWORDS.map((keyword) => ({
+    label: keyword,
+    kind: CompletionItemKind.Keyword,
+    detail: "BIRD keyword",
+    documentation: KEYWORD_DOCS[keyword] ?? "",
+}));
+const snippetCompletionItems = () => 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, options) => {
+    const paths = new Set();
+    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, predicate) => {
+    const items = [];
+    const seen = new Set();
+    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) => collectDeclarationCompletionItems(declarations, (declaration) => declaration.kind === "template");
+const filterCompletionItems = (declarations) => collectDeclarationCompletionItems(declarations, (declaration) => declaration.kind === "filter");
+const tableCompletionItems = (declarations) => collectDeclarationCompletionItems(declarations, (declaration) => declaration.kind === "table");
+const declarationCompletionItems = (declarations) => {
+    return collectDeclarationCompletionItems(declarations, () => true);
+};
+export const createCompletionItemsFromParsed = (parsed, options = {}) => {
+    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),
+    ];
+};
+//# sourceMappingURL=completion.js.map

package/dist/completion.js.map

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

package/dist/definition.d.ts

@@ -0,0 +1,5 @@
+import type { SymbolTable } from "@birdcc/core";
+import type { Location, Position } from "vscode-languageserver/node.js";
+/** Resolves symbol definition locations from a merged cross-file symbol table. */
+export declare const createDefinitionLocations: (symbolTable: SymbolTable, uri: string, position: Position, sourceText: string) => Location[];
+//# sourceMappingURL=definition.d.ts.map

package/dist/definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../src/definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AASxE,kFAAkF;AAClF,eAAO,MAAM,yBAAyB,GACpC,aAAa,WAAW,EACxB,KAAK,MAAM,EACX,UAAU,QAAQ,EAClB,YAAY,MAAM,KACjB,QAAQ,EAiCV,CAAC"}

package/dist/definition.js

@@ -0,0 +1,21 @@
+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, uri, position, sourceText) => {
+    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));
+};
+//# sourceMappingURL=definition.js.map

package/dist/definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.js","sourceRoot":"","sources":["../src/definition.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EACvB,eAAe,EACf,qBAAqB,EACrB,UAAU,GACX,MAAM,mBAAmB,CAAC;AAE3B,kFAAkF;AAClF,MAAM,CAAC,MAAM,yBAAyB,GAAG,CACvC,WAAwB,EACxB,GAAW,EACX,QAAkB,EAClB,UAAkB,EACN,EAAE;IACd,MAAM,KAAK,GAAG,uBAAuB,CACnC,WAAW,CAAC,WAAW,EACvB,WAAW,CAAC,UAAU,CACvB,CAAC;IAEF,MAAM,SAAS,GAAG,WAAW,CAAC,UAAU,CAAC,IAAI,CAC3C,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,KAAK,GAAG,IAAI,gBAAgB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAC/D,CAAC;IAEF,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,eAAe,CACpB,CAAC,KAAK,CAAC,iBAAiB,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;aAC9D,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,KAAK,SAAS,CAAC,IAAI,CAAC;aAC1D,GAAG,CAAC,UAAU,CAAC,CACnB,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,WAAW,CAAC,WAAW,CAAC,IAAI,CAC7C,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,KAAK,GAAG,IAAI,gBAAgB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAC/D,CAAC;IACF,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC;IAClC,CAAC;IAED,MAAM,IAAI,GAAG,qBAAqB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACzD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,eAAe,CACpB,CAAC,KAAK,CAAC,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CACxE,CAAC;AACJ,CAAC,CAAC"}

package/dist/diagnostic.d.ts

@@ -0,0 +1,6 @@
+import { type Diagnostic } from "vscode-languageserver/node.js";
+import type { BirdDiagnostic } from "@birdcc/core";
+/** Maps Bird diagnostic schema into LSP Diagnostic schema. */
+export declare const toLspDiagnostic: (diagnostic: BirdDiagnostic) => Diagnostic;
+export declare const toInternalErrorDiagnostic: (error: unknown) => Diagnostic;
+//# sourceMappingURL=diagnostic.d.ts.map

package/dist/diagnostic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostic.d.ts","sourceRoot":"","sources":["../src/diagnostic.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,UAAU,EAChB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAgBnD,8DAA8D;AAC9D,eAAO,MAAM,eAAe,GAAI,YAAY,cAAc,KAAG,UAe3D,CAAC;AAEH,eAAO,MAAM,yBAAyB,GAAI,OAAO,OAAO,KAAG,UASzD,CAAC"}

package/dist/diagnostic.js

@@ -0,0 +1,38 @@
+import { DiagnosticSeverity, } from "vscode-languageserver/node.js";
+const toLspSeverity = (severity) => {
+    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) => ({
+    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) => ({
+    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 },
+    },
+});
+//# sourceMappingURL=diagnostic.js.map

package/dist/diagnostic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostic.js","sourceRoot":"","sources":["../src/diagnostic.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,GAEnB,MAAM,+BAA+B,CAAC;AAGvC,MAAM,aAAa,GAAG,CACpB,QAAoC,EAChB,EAAE;IACtB,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QACzB,OAAO,kBAAkB,CAAC,KAAK,CAAC;IAClC,CAAC;IAED,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,kBAAkB,CAAC,OAAO,CAAC;IACpC,CAAC;IAED,OAAO,kBAAkB,CAAC,WAAW,CAAC;AACxC,CAAC,CAAC;AAEF,8DAA8D;AAC9D,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,UAA0B,EAAc,EAAE,CAAC,CAAC;IAC1E,IAAI,EAAE,UAAU,CAAC,IAAI;IACrB,OAAO,EAAE,UAAU,CAAC,OAAO;IAC3B,QAAQ,EAAE,aAAa,CAAC,UAAU,CAAC,QAAQ,CAAC;IAC5C,MAAM,EAAE,UAAU,CAAC,MAAM;IACzB,KAAK,EAAE;QACL,KAAK,EAAE;YACL,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC,CAAC;YAC5C,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,CAAC;SACpD;QACD,GAAG,EAAE;YACH,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC,CAAC;YAC/C,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC,CAAC;SACvD;KACF;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,KAAc,EAAc,EAAE,CAAC,CAAC;IACxE,IAAI,EAAE,oBAAoB;IAC1B,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;IAC/D,QAAQ,EAAE,kBAAkB,CAAC,KAAK;IAClC,MAAM,EAAE,KAAK;IACb,KAAK,EAAE;QACL,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE;QAChC,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE;KAC/B;CACF,CAAC,CAAC"}

package/dist/document-symbol.d.ts

@@ -0,0 +1,4 @@
+import type { DocumentSymbol } from "vscode-languageserver/node.js";
+import type { ParsedBirdDocument } from "@birdcc/parser";
+export declare const createDocumentSymbolsFromParsed: (parsed: ParsedBirdDocument) => DocumentSymbol[];
+//# sourceMappingURL=document-symbol.d.ts.map

package/dist/document-symbol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-symbol.d.ts","sourceRoot":"","sources":["../src/document-symbol.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAGzD,eAAO,MAAM,+BAA+B,GAC1C,QAAQ,kBAAkB,KACzB,cAAc,EAoBhB,CAAC"}

package/dist/document-symbol.js

@@ -0,0 +1,20 @@
+import { declarationMetadata, toLspRange } from "./shared.js";
+export const createDocumentSymbolsFromParsed = (parsed) => {
+    const symbols = [];
+    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;
+};
+//# sourceMappingURL=document-symbol.js.map

package/dist/document-symbol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-symbol.js","sourceRoot":"","sources":["../src/document-symbol.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9D,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAC7C,MAA0B,EACR,EAAE;IACpB,MAAM,OAAO,GAAqB,EAAE,CAAC;IAErC,KAAK,MAAM,WAAW,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;QACtD,MAAM,QAAQ,GAAG,mBAAmB,CAAC,WAAW,CAAC,CAAC;QAClD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,SAAS;QACX,CAAC;QAED,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,QAAQ,CAAC,UAAU;YACzB,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,IAAI,EAAE,QAAQ,CAAC,UAAU;YACzB,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC;YAC9B,cAAc,EAAE,UAAU,CAAC,QAAQ,CAAC,cAAc,CAAC;YACnD,QAAQ,EAAE,EAAE;SACb,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC"}

package/dist/hover-docs.d.ts

@@ -0,0 +1,5 @@
+export type HoverDocDiffType = "same" | "added" | "modified" | "removed";
+export type HoverDocVersionTag = "v2+" | "v3+" | "v2" | "v2-v3";
+export declare const HOVER_KEYWORD_DOCS: Record<string, string>;
+export declare const HOVER_KEYWORDS: readonly string[];
+//# sourceMappingURL=hover-docs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hover-docs.d.ts","sourceRoot":"","sources":["../src/hover-docs.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC;AACzE,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,KAAK,GAAG,IAAI,GAAG,OAAO,CAAC;AAiNhE,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAErD,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,SAAS,MAAM,EAE3C,CAAC"}