@birdcc/lsp 0.0.1-alpha.0 → 0.1.0-beta.0

package/dist/utils.d.ts

@@ -0,0 +1,65 @@
+import { MessageType, type Connection, type Diagnostic, type Position, type Range } from "vscode-languageserver/node.js";
+/**
+ * Minimal 1-based source range interface accepted by shared LSP utilities.
+ * Structurally compatible with `SourceRange` from `@birdcc/parser` and
+ * `SymbolDefinition`/`SymbolReference` from `@birdcc/core`.
+ */
+export interface SourceRangeLike {
+    readonly line: number;
+    readonly column: number;
+    readonly endLine: number;
+    readonly endColumn: number;
+}
+/**
+ * Document-like object accepted by {@link getLineText}.
+ * Supports both `lineAt` (VS Code vscode.TextDocument) and `getText`
+ * (vscode-languageserver-textdocument TextDocument) interfaces.
+ */
+export interface GetLineTextDocument {
+    readonly lineCount: number;
+    lineAt?: (line: number) => {
+        readonly text: string;
+    };
+    getText?: (range?: {
+        readonly start: {
+            readonly line: number;
+            readonly character: number;
+        };
+        readonly end: {
+            readonly line: number;
+            readonly character: number;
+        };
+    }) => string;
+}
+/** Normalize a keyword or phrase into a canonical lowercase single-space key. */
+export declare const toCanonicalKey: (value: string) => string;
+/** Convert a 1-based {@link SourceRangeLike} into a 0-based LSP {@link Range}. */
+export declare const toLspRange: (range: SourceRangeLike) => Range;
+/** Check whether a 0-based LSP {@link Position} falls inside a 1-based {@link SourceRangeLike}. */
+export declare const isPositionInRange: (position: Position, range: SourceRangeLike) => boolean;
+/** Extract the text content of a single line from a document-like object. */
+export declare const getLineText: (document: GetLineTextDocument, line: number) => string;
+/** Send a typed `window/showMessage` notification. */
+export declare const showMessage: (connection: Connection, type: MessageType, message: string) => void;
+/** Send an Info-level `window/showMessage` notification. */
+export declare const showInfo: (connection: Connection, message: string) => void;
+/** Send a Warning-level `window/showMessage` notification. */
+export declare const showWarning: (connection: Connection, message: string) => void;
+/** Send an Info-level notification only once per `key`. */
+export declare const showInfoOnce: (connection: Connection, seen: Set<string>, key: string, message: string) => void;
+/** Publish diagnostics for a single URI. */
+export declare const publishDiagnostics: (connection: Connection, uri: string, diagnostics: Diagnostic[], version?: number) => void;
+/** Clear diagnostics for a single URI. */
+export declare const clearDiagnostics: (connection: Connection, uri: string) => void;
+/** Clear diagnostics for multiple URIs at once. */
+export declare const clearDiagnosticsMany: (connection: Connection, uris: Iterable<string>) => void;
+/** Minimal document store interface accepted by {@link withDocument}. */
+export interface DocumentStore<TDocument> {
+    get(uri: string): TDocument | undefined;
+}
+/**
+ * Guard helper that looks up a document by URI and runs `fn` only when found.
+ * Returns `fallback` when the document is not in the store.
+ */
+export declare const withDocument: <TDocument, TResult>(store: DocumentStore<TDocument>, uri: string, fallback: TResult, fn: (doc: TDocument) => Promise<TResult> | TResult) => Promise<TResult>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

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

package/dist/utils.js

@@ -0,0 +1,97 @@
+import { MessageType, } from "vscode-languageserver/node.js";
+// ---------------------------------------------------------------------------
+// String utilities
+// ---------------------------------------------------------------------------
+/** Normalize a keyword or phrase into a canonical lowercase single-space key. */
+export const toCanonicalKey = (value) => value.trim().toLowerCase().replace(/\s+/g, " ");
+// ---------------------------------------------------------------------------
+// Range / position utilities
+// ---------------------------------------------------------------------------
+/** Convert a 1-based {@link SourceRangeLike} into a 0-based LSP {@link Range}. */
+export const toLspRange = (range) => ({
+    start: {
+        line: Math.max(range.line - 1, 0),
+        character: Math.max(range.column - 1, 0),
+    },
+    end: {
+        line: Math.max(range.endLine - 1, 0),
+        character: Math.max(range.endColumn - 1, 0),
+    },
+});
+/** Check whether a 0-based LSP {@link Position} falls inside a 1-based {@link SourceRangeLike}. */
+export const isPositionInRange = (position, range) => {
+    const line = position.line + 1;
+    const character = position.character + 1;
+    if (line < range.line || line > range.endLine) {
+        return false;
+    }
+    if (line === range.line && character < range.column) {
+        return false;
+    }
+    if (line === range.endLine && character > range.endColumn) {
+        return false;
+    }
+    return true;
+};
+// ---------------------------------------------------------------------------
+// Document text helpers
+// ---------------------------------------------------------------------------
+/** Extract the text content of a single line from a document-like object. */
+export const getLineText = (document, line) => {
+    if (document.lineAt && typeof document.lineAt === "function") {
+        return document.lineAt(line).text;
+    }
+    if (document.getText && typeof document.getText === "function") {
+        const start = { line, character: 0 };
+        const end = line + 1 < document.lineCount
+            ? { line: line + 1, character: 0 }
+            : { line, character: Number.MAX_SAFE_INTEGER };
+        return document.getText({ start, end }).replace(/\r?\n$/, "");
+    }
+    return "";
+};
+// ---------------------------------------------------------------------------
+// LSP notification helpers
+// ---------------------------------------------------------------------------
+/** Send a typed `window/showMessage` notification. */
+export const showMessage = (connection, type, message) => {
+    connection.sendNotification("window/showMessage", { type, message });
+};
+/** Send an Info-level `window/showMessage` notification. */
+export const showInfo = (connection, message) => showMessage(connection, MessageType.Info, message);
+/** Send a Warning-level `window/showMessage` notification. */
+export const showWarning = (connection, message) => showMessage(connection, MessageType.Warning, message);
+/** Send an Info-level notification only once per `key`. */
+export const showInfoOnce = (connection, seen, key, message) => {
+    if (seen.has(key))
+        return;
+    seen.add(key);
+    showInfo(connection, message);
+};
+// ---------------------------------------------------------------------------
+// Diagnostics helpers
+// ---------------------------------------------------------------------------
+/** Publish diagnostics for a single URI. */
+export const publishDiagnostics = (connection, uri, diagnostics, version) => {
+    connection.sendDiagnostics({ uri, version, diagnostics });
+};
+/** Clear diagnostics for a single URI. */
+export const clearDiagnostics = (connection, uri) => {
+    connection.sendDiagnostics({ uri, diagnostics: [] });
+};
+/** Clear diagnostics for multiple URIs at once. */
+export const clearDiagnosticsMany = (connection, uris) => {
+    for (const uri of uris)
+        clearDiagnostics(connection, uri);
+};
+/**
+ * Guard helper that looks up a document by URI and runs `fn` only when found.
+ * Returns `fallback` when the document is not in the store.
+ */
+export const withDocument = async (store, uri, fallback, fn) => {
+    const doc = store.get(uri);
+    if (!doc)
+        return fallback;
+    return await fn(doc);
+};
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

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

package/package.json

@@ -1,7 +1,6 @@
 {
   "name": "@birdcc/lsp",
-  "version": "0.0.1-alpha.0",
-  "private": false,
+  "version": "0.1.0-beta.0",
   "type": "module",
   "license": "GPL-3.0-only",
   "author": {
@@ -9,21 +8,30 @@
     "email": "npm-dev@birdcc.link",
     "url": "https://github.com/bird-chinese-community/"
   },
+  "description": "Language Server Protocol implementation for BIRD2 configuration files.",
   "main": "./dist/index.js",
-  "types": "./src/index.ts",
+  "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "types": "./src/index.ts",
+      "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
     }
   },
+  "sideEffects": false,
+  "files": [
+    "dist/**",
+    "README.md",
+    "LICENSE"
+  ],
   "dependencies": {
-    "yaml": "^2.8.2",
+    "@birdcc/core": "0.1.0-beta.0",
+    "@birdcc/formatter": "0.1.0-beta.0",
+    "@birdcc/intel": "^0.0.1-2026-03-05.2",
+    "@birdcc/linter": "0.1.0-beta.0",
+    "@birdcc/parser": "0.1.0-beta.0",
     "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"
+    "yaml": "^2.8.2"
   },
   "repository": {
     "type": "git",
@@ -35,10 +43,13 @@
     "url": "https://github.com/bird-chinese-community/BIRD-LSP/issues"
   },
   "scripts": {
-    "build": "tsc -p tsconfig.json && node scripts/copy-hover-yaml.mjs",
+    "build": "tsc -p tsconfig.json && node scripts/copy-hover-yaml.mjs && pnpm run hover:coverage:check",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "lint": "oxlint --deny-warnings src test",
     "test": "vitest run",
+    "test:quick": "vitest run",
+    "hover:coverage": "node scripts/report-hover-coverage.mjs",
+    "hover:coverage:check": "node scripts/report-hover-coverage.mjs --check",
     "format": "oxfmt .",
     "coverage": "vitest run --coverage --coverage.provider=v8 --coverage.reporter=text-summary --coverage.reporter=json-summary"
   }

package/.oxfmtrc.json

@@ -1,16 +0,0 @@
-{
-  "$schema": "../../../node_modules/oxfmt/configuration_schema.json",
-  "ignorePatterns": [
-    "node_modules/*",
-    "package.json",
-    "dist/*",
-    ".turbo/*",
-    "target/*",
-    "*.lock",
-    "pnpm-*.yaml",
-    "*-lock.json"
-  ],
-  "printWidth": 80,
-  "tabWidth": 2,
-  "useTabs": false
-}