@birdcc/lsp 0.0.1-alpha.0

package/dist/hover-docs.js

@@ -0,0 +1,141 @@
+import { readFileSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { parse } from "yaml";
+const normalizeAnchor = (value) => {
+    if (typeof value !== "string") {
+        return undefined;
+    }
+    const normalized = value.trim().replace(/^#/, "");
+    return normalized.length > 0 ? normalized : undefined;
+};
+const loadHoverDocYaml = () => {
+    const hoverDocsPath = path.join(path.dirname(fileURLToPath(import.meta.url)), "hover-docs.yaml");
+    const raw = readFileSync(hoverDocsPath, "utf8");
+    const parsed = parse(raw);
+    if (!parsed || !Array.isArray(parsed.entries) || !parsed.baseUrls) {
+        throw new Error("Invalid hover docs yaml structure");
+    }
+    return parsed;
+};
+const isDiffType = (value) => value === "same" ||
+    value === "added" ||
+    value === "modified" ||
+    value === "removed";
+const isVersionTag = (value) => value === "v2+" || value === "v3+" || value === "v2" || value === "v2-v3";
+const hoverDocSource = loadHoverDocYaml();
+const VERSION_BASE_URLS = {
+    v2: hoverDocSource.baseUrls.v2,
+    v3: hoverDocSource.baseUrls.v3,
+};
+const toCanonicalEntry = (entry) => {
+    const keyword = entry.keyword.trim().toLowerCase();
+    if (keyword.length === 0) {
+        throw new Error("Hover keyword must not be empty");
+    }
+    if (!isDiffType(entry.diff)) {
+        throw new Error(`Invalid diff type for keyword '${keyword}'`);
+    }
+    if (!isVersionTag(entry.version)) {
+        throw new Error(`Invalid version tag for keyword '${keyword}'`);
+    }
+    const anchor = normalizeAnchor(entry.anchor);
+    const anchors = entry.anchors
+        ? {
+            ...(normalizeAnchor(entry.anchors.v2)
+                ? { v2: normalizeAnchor(entry.anchors.v2) }
+                : {}),
+            ...(normalizeAnchor(entry.anchors.v3)
+                ? { v3: normalizeAnchor(entry.anchors.v3) }
+                : {}),
+        }
+        : undefined;
+    if ((entry.version === "v2+" ||
+        entry.version === "v3+" ||
+        entry.version === "v2") &&
+        !anchor) {
+        throw new Error(`Keyword '${keyword}' requires a single anchor for version '${entry.version}'`);
+    }
+    if (entry.version === "v2-v3" &&
+        !anchor &&
+        (!anchors || Object.keys(anchors).length === 0)) {
+        throw new Error(`Keyword '${keyword}' requires anchor or anchors for version 'v2-v3'`);
+    }
+    return {
+        ...entry,
+        keyword,
+        anchor,
+        anchors,
+    };
+};
+const normalizedEntries = hoverDocSource.entries.map(toCanonicalEntry);
+const dedupedEntries = [];
+const seenKeywords = new Set();
+for (const entry of normalizedEntries) {
+    if (seenKeywords.has(entry.keyword)) {
+        continue;
+    }
+    seenKeywords.add(entry.keyword);
+    dedupedEntries.push(entry);
+}
+const buildDocUrl = (version, anchor) => {
+    const baseUrl = VERSION_BASE_URLS[version];
+    if (!anchor || anchor.length === 0) {
+        return baseUrl;
+    }
+    return `${baseUrl}#${anchor}`;
+};
+const buildDocsSection = (entry) => {
+    const lines = [];
+    if (entry.version === "v2+") {
+        lines.push(`- [BIRD v2.18 / v3.2.0](${buildDocUrl("v2", entry.anchor)})`);
+    }
+    else if (entry.version === "v3+") {
+        lines.push(`- [BIRD v3.2.0](${buildDocUrl("v3", entry.anchor)})`);
+    }
+    else if (entry.version === "v2") {
+        lines.push(`- [BIRD v2.18](${buildDocUrl("v2", entry.anchor)})`);
+    }
+    else {
+        const v2Anchor = entry.anchors?.v2 ?? entry.anchor;
+        const v3Anchor = entry.anchors?.v3 ?? entry.anchor;
+        if (v2Anchor) {
+            lines.push(`- [BIRD v2.18](${buildDocUrl("v2", v2Anchor)})`);
+        }
+        if (v3Anchor) {
+            lines.push(`- [BIRD v3.2.0](${buildDocUrl("v3", v3Anchor)})`);
+        }
+    }
+    return lines.join("\n");
+};
+const buildNotesSection = (entry) => {
+    if (!entry.notes) {
+        return "";
+    }
+    const lines = [];
+    if (entry.notes.v2) {
+        lines.push(`- v2: ${entry.notes.v2}`);
+    }
+    if (entry.notes.v3) {
+        lines.push(`- v3: ${entry.notes.v3}`);
+    }
+    if (lines.length === 0) {
+        return "";
+    }
+    return `\n\nNotes:\n${lines.join("\n")}`;
+};
+const toHoverMarkdown = (entry) => {
+    return ([
+        `### ${entry.description}`,
+        "",
+        entry.detail,
+        "",
+        `Diff: \`${entry.diff}\``,
+        `Version: \`${entry.version}\``,
+        "Docs:",
+        buildDocsSection(entry),
+    ].join("\n") + buildNotesSection(entry));
+};
+export const HOVER_KEYWORD_DOCS = Object.fromEntries(dedupedEntries.map((entry) => [entry.keyword, toHoverMarkdown(entry)]));
+export const HOVER_KEYWORDS = Object.freeze(dedupedEntries.map((entry) => entry.keyword));
+//# sourceMappingURL=hover-docs.js.map

package/dist/hover-docs.js.map

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