@junejs/server 1.0.0-dev.28 → 1.0.0-dev.29

package/dist/llms-links.d.ts

@@ -0,0 +1,6 @@
+import { u as RouteResolver } from "./pipeline-cCR6MGNK.js";
+import { LlmsLink } from "@junejs/core/discovery";
+//#region src/llms-links.d.ts
+declare function collectLlmsLinks(origin: string, routes: string[], resolve: RouteResolver): Promise<LlmsLink[]>;
+//#endregion
+export { collectLlmsLinks };

package/dist/llms-links.js

@@ -0,0 +1,35 @@
+//#region src/llms-links.ts
+const DEFAULT_SECTION = "Pages";
+const mdPath = (path) => path === "/" ? "/index.md" : `${path.replace(/\/+$/, "")}.md`;
+async function collectLlmsLinks(origin, routes, resolve) {
+	const links = [];
+	const seen = /* @__PURE__ */ new Set();
+	for (const route of routes) {
+		const resolved = await resolve(route);
+		if (!resolved || !("def" in resolved)) continue;
+		const { def } = resolved;
+		if (def.llms === false) continue;
+		const dynamic = route.includes("[");
+		const declared = typeof def.llms === "function" ? await def.llms() : def.llms;
+		const entries = declared ? Array.isArray(declared) ? declared : [declared] : dynamic ? [] : [{}];
+		const meta = typeof def.metadata === "object" ? def.metadata : void 0;
+		for (const entry of entries) {
+			const path = entry.path ?? (dynamic ? void 0 : route);
+			if (!path) continue;
+			const url = origin + (def.md === false ? path : mdPath(path));
+			if (seen.has(url)) continue;
+			seen.add(url);
+			const own = path === route;
+			links.push({
+				title: entry.title ?? (own ? meta?.title : void 0) ?? path,
+				url,
+				description: entry.description ?? (own ? meta?.description : void 0),
+				section: entry.section ?? DEFAULT_SECTION,
+				optional: entry.optional === true
+			});
+		}
+	}
+	return links;
+}
+//#endregion
+export { collectLlmsLinks };

package/dist/pipeline.js

@@ -1,4 +1,5 @@
 import { iconLetter } from "./icon-letter.js";
+import { collectLlmsLinks } from "./llms-links.js";
 import { webManifest } from "./web-manifest.js";
 import { SEGMENT_HEADER, TITLE_HEADER, encodeTitle, negotiate } from "./negotiate.js";
 import { ensureScope, runInScope, setRequestLocale } from "@junejs/db";
@@ -172,7 +173,11 @@ function createPipeline(cfg) {
 	}
 	async function discovery(url) {
 		switch (url.pathname) {
-			case "/llms.txt": return text(llmsTxt(url.origin, await cfg.routeList(), agent, docConfig.site), "text/markdown; charset=utf-8");
+			case "/llms.txt": {
+				const routes = await cfg.routeList();
+				const links = await collectLlmsLinks(url.origin, routes, cfg.resolve);
+				return text(llmsTxt(url.origin, routes, agent, docConfig.site, links), "text/markdown; charset=utf-8");
+			}
 			case "/robots.txt": return text(robotsTxt(url.origin), "text/plain; charset=utf-8");
 			case "/sitemap.xml": return text(sitemapXml(url.origin, await cfg.routeList(), cfg.i18n), "application/xml; charset=utf-8");
 			case "/.well-known/api-catalog": return text(JSON.stringify(apiCatalog(url.origin, agent)), "application/linkset+json");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@junejs/server",
-  "version": "1.0.0-dev.28",
+  "version": "1.0.0-dev.29",
   "description": "June host adapters + dev server. Host-coupled; depends on the pure @junejs/core contract layer.",
   "type": "module",
   "license": "MIT",
@@ -140,7 +140,7 @@
     "rolldown": "^1.1.0"
   },
   "peerDependencies": {
-    "@junejs/core": ">=0.2.0-dev.48",
+    "@junejs/core": ">=0.2.0-dev.50",
     "react": "^19.2.0",
     "react-dom": "^19.2.0",
     "react-server-dom-webpack": "19.2.7",

package/src/llms-links.ts

@@ -0,0 +1,51 @@
+// /llms.txt links, collected from the routes themselves. Each route may export
+// `llms` (see LlmsEntry in @junejs/core/route): a static route defaults to one link
+// under "Pages" built from its static metadata; a dynamic route — a [param]
+// template an agent can't fetch — lists each real page it serves, or is skipped.
+// Links point at the markdown projection (<path>.md) unless the route turned md off,
+// so an agent reads the page rather than its HTML (llmstxt.org's recommendation).
+import type { LlmsLink } from "@junejs/core/discovery";
+import type { LlmsEntry } from "@junejs/core/route";
+
+import type { RouteResolver } from "./pipeline";
+
+const DEFAULT_SECTION = "Pages";
+
+const mdPath = (path: string) => (path === "/" ? "/index.md" : `${path.replace(/\/+$/, "")}.md`);
+
+export async function collectLlmsLinks(origin: string, routes: string[], resolve: RouteResolver): Promise<LlmsLink[]> {
+  const links: LlmsLink[] = [];
+  const seen = new Set<string>();
+  for (const route of routes) {
+    // A dynamic template resolves against its own pattern ("/docs/[slug]" matches
+    // /docs/:slug), which is all we need: the route definition, not its data.
+    const resolved = await resolve(route);
+    if (!resolved || !("def" in resolved)) continue; // resource routes have no page to list
+    const { def } = resolved;
+    if (def.llms === false) continue;
+
+    const dynamic = route.includes("[");
+    const declared = typeof def.llms === "function" ? await def.llms() : def.llms;
+    const entries: LlmsEntry[] = declared ? (Array.isArray(declared) ? declared : [declared]) : dynamic ? [] : [{}];
+    // Static metadata only: a metadata FUNCTION needs loader data we don't run here.
+    const meta = typeof def.metadata === "object" ? def.metadata : undefined;
+
+    for (const entry of entries) {
+      const path = entry.path ?? (dynamic ? undefined : route);
+      if (!path) continue; // a dynamic entry must name its page
+      const url = origin + (def.md === false ? path : mdPath(path));
+      // dedupe on the FINAL url: "/a" and "/a/" both render /a.md, so they're one page
+      if (seen.has(url)) continue;
+      seen.add(url);
+      const own = path === route; // the route's own page → its metadata describes it
+      links.push({
+        title: entry.title ?? (own ? meta?.title : undefined) ?? path,
+        url,
+        description: entry.description ?? (own ? meta?.description : undefined),
+        section: entry.section ?? DEFAULT_SECTION,
+        optional: entry.optional === true,
+      });
+    }
+  }
+  return links;
+}

package/src/pipeline.ts

@@ -50,6 +50,7 @@ import {
 import type { Resources } from "@junejs/core/resources";
 
 import { iconLetter } from "./icon-letter";
+import { collectLlmsLinks } from "./llms-links";
 import { webManifest } from "./web-manifest";
 import { negotiate, TITLE_HEADER, SEGMENT_HEADER, encodeTitle } from "./negotiate";
 
@@ -480,11 +481,12 @@ export function createPipeline(cfg: PipelineConfig): Pipeline {
 
   async function discovery(url: URL): Promise<Response | null> {
     switch (url.pathname) {
-      case "/llms.txt":
-        return text(
-          llmsTxt(url.origin, await cfg.routeList(), agent, docConfig.site),
-          "text/markdown; charset=utf-8",
-        );
+      case "/llms.txt": {
+        const routes = await cfg.routeList();
+        // sections, descriptions, and Optional come from each route's `llms` export
+        const links = await collectLlmsLinks(url.origin, routes, cfg.resolve);
+        return text(llmsTxt(url.origin, routes, agent, docConfig.site, links), "text/markdown; charset=utf-8");
+      }
       case "/robots.txt":
         return text(robotsTxt(url.origin), "text/plain; charset=utf-8");
       case "/sitemap.xml":