feat: add completions API and scanning logic

Implement a new completions system that scans markdown files for dice notation and headings. The server now exposes a `/__COMPLETIONS.json` endpoint and automatically recomputes the completion index when files are added, updated, or deleted.
2026-07-06 16:50:45 +08:00
parent 307a3c8320
commit 8284f5caee
5 changed files with 195 additions and 0 deletions
@@ -0,0 +1,55 @@
+/**
+ * Link completion source — extracts markdown headings from all .md files.
+ *
+ * Produces two entries per heading section, plus one for the file itself.
+ * Uses github-slugger to match marked-gfm-heading-id's generated IDs.
+ */
+
+import Slugger from "github-slugger";
+import type { CompletionSource, LinkCompletion } from "../types.js";
+
+export const linksSource: CompletionSource = {
+  key: "links",
+
+  scan(index) {
+    const items: LinkCompletion[] = [];
+
+    for (const [filePath, content] of Object.entries(index)) {
+      if (!filePath.endsWith(".md")) continue;
+
+      // Strip .md extension for the router-friendly path
+      const basePath = filePath.replace(/\.md$/, "");
+      const fileName = fileNameFromPath(basePath);
+      const slugger = new Slugger();
+
+      // Add the file itself as a link (whole article)
+      items.push({
+        path: basePath,
+        label: fileName,
+        section: null,
+      });
+
+      // Parse headings for section-scoped links
+      const headingRegex = /^(#{1,6})\s+(.+)$/gm;
+      let match: RegExpExecArray | null;
+
+      while ((match = headingRegex.exec(content)) !== null) {
+        const title = match[2].trim();
+        const id = slugger.slug(title.toLowerCase());
+
+        items.push({
+          path: basePath,
+          label: `${fileName} § ${title}`,
+          section: id,
+        });
+      }
+    }
+
+    return items;
+  },
+};
+
+function fileNameFromPath(path: string): string {
+  const parts = path.split("/").filter(Boolean);
+  return parts[parts.length - 1] || path;
+}