fix: llms links

Author: lambdalisue

data/docs.ts

@@ -81,7 +81,8 @@ export const siteMetadata = {
     "Probitas is a scenario-based testing framework for Deno that enables declarative, readable integration tests for APIs, databases, message queues, and other backend services.",
   github: "https://github.com/jsr-probitas/probitas",
   jsr: "https://jsr.io/@probitas/probitas",
-  baseUrl: "https://jsr-probitas.github.io/documents",
+  baseUrl: Deno.env.get("BASE_URL") ??
+    "https://jsr-probitas.github.io/documents",
 };
 
 /**

lib/api-markdown.ts

@@ -34,6 +34,7 @@ import {
   formatMethodSignature,
   formatTypeAliasSignature,
 } from "./signature-formatters.ts";
+import { siteMetadata } from "../data/docs.ts";
 
 // ============================================================================
 // Type Reference Collector
@@ -61,7 +62,7 @@ class TypeReferenceCollector {
     localTypes: Set<string>,
     typeToPackage: Map<string, string>,
     currentPackage: string,
-    baseUrl = "https://jsr-probitas.github.io/documents",
+    baseUrl = siteMetadata.baseUrl,
   ) {
     this.localTypes = localTypes;
     this.typeToPackage = typeToPackage;
@@ -525,7 +526,7 @@ export function generateApiMarkdown(
   const lines: string[] = [];
   const {
     allPackages = [],
-    baseUrl = "https://jsr-probitas.github.io/documents",
+    baseUrl = siteMetadata.baseUrl,
     updatedAt,
   } = options;
 

lib/llms.ts

@@ -39,6 +39,9 @@ async function getPackageDescription(packageName: string): Promise<string> {
 export async function generateLlmsTxt(): Promise<string> {
   const groups = await getPackageGroups();
 
+  const resolveDocMarkdownPath = (path: string): string =>
+    path.endsWith("/") ? `${path}index.md` : `${path}.md`;
+
   const lines: string[] = [
     `# ${siteMetadata.name}`,
     "",
@@ -47,7 +50,9 @@ export async function generateLlmsTxt(): Promise<string> {
     "## Documentation",
     "",
     ...docPages.map((doc) =>
-      `- [${doc.title}](${basePath}${doc.path}index.md): ${doc.description}`
+      `- [${doc.title}](${basePath}${
+        resolveDocMarkdownPath(doc.path)
+      }): ${doc.description}`
     ),
     "",
     "## API Reference",

tests/internal_link_check_test.ts

@@ -5,6 +5,7 @@ import {
   Element,
 } from "https://deno.land/x/deno_dom@v0.1.47/deno-dom-wasm.ts";
 import { dirname, fromFileUrl, resolve } from "jsr:@std/path@^1.0.1";
+import { basePath, siteMetadata } from "../data/docs.ts";
 
 const SRC_ROOT = fromFileUrl(import.meta.resolve("../"));
 const SITE_ROOT = resolve(SRC_ROOT, "dist");
@@ -55,13 +56,39 @@ function isTargetLink(link: string): boolean {
 function normalizeLink(link: string, htmlMode: boolean): Link {
   const [path, fragment = null] = link.split("#");
   const cleanPath = path.split("?")[0];
+  const basePaths = new Set<string>();
+  if (basePath) {
+    basePaths.add(basePath);
+  }
+  try {
+    const { pathname } = new URL(siteMetadata.baseUrl);
+    if (pathname && pathname !== "/") {
+      basePaths.add(pathname);
+    }
+  } catch {
+    // Ignore invalid baseUrl; basePaths will rely on BASE_PATH.
+  }
+  let normalizedPath = cleanPath;
+  for (const candidate of basePaths) {
+    const normalizedCandidate = candidate.endsWith("/")
+      ? candidate.slice(0, -1)
+      : candidate;
+    if (
+      normalizedCandidate &&
+      normalizedPath.startsWith(normalizedCandidate)
+    ) {
+      const nextPath = normalizedPath.slice(normalizedCandidate.length);
+      normalizedPath = nextPath || "/";
+      break;
+    }
+  }
   if (!cleanPath) {
     return ["", fragment];
   }
-  if (htmlMode && cleanPath.endsWith("/")) {
-    return [`${cleanPath}index.html`, fragment];
+  if (htmlMode && normalizedPath.endsWith("/")) {
+    return [`${normalizedPath}index.html`, fragment];
   }
-  return [cleanPath, fragment];
+  return [normalizedPath, fragment];
 }
 
 function readFile(filePath: string): File {