@gusnips/vite 0.8.43 → 0.8.44

package/README.md

@@ -63,6 +63,87 @@ Four rules in there are load-bearing:
   points back at the others, which is why you pass the full list to every page rather than "the
   other two".
 
+## Discovery files
+
+```ts
+import { jsonLd } from "@gusnips/vite";
+
+jsonLd({ "@type": "SoftwareApplication", name: "Example" });
+// A <script type="application/ld+json"> tag containing the object.
+```
+
+Pass the result to `bakeHead` as `headExtra`. `jsonLd` escapes HTML control text while keeping
+valid JSON. `faqJsonLd` uses the same serializer. You supply the schema.org fields, including
+`SoftwareApplication` for an app or `WebAPI` for a public API. A local command is not a public API.
+
+```ts
+import { llmsTxt, mcpDiscoveryJson, writeDist } from "@gusnips/vite";
+
+await writeDist(
+  "dist",
+  "llms.txt",
+  llmsTxt({
+    title: "Example",
+    summary: "Read and update tasks.",
+    sections: [
+      {
+        title: "Reference",
+        links: [{ title: "Connect", url: "https://example.com/docs/mcp" }],
+      },
+    ],
+  }),
+);
+
+await writeDist(
+  "dist",
+  "llms-full.txt",
+  llmsTxt({
+    title: "Example reference",
+    body: referenceMarkdown,
+  }),
+);
+
+await writeDist(
+  "dist",
+  ".well-known/mcp.json",
+  mcpDiscoveryJson({
+    name: "Example",
+    homepage: "https://example.com",
+    documentation: "https://example.com/docs/mcp",
+    llmsTxt: "https://example.com/llms.txt",
+    llmsFullTxt: "https://example.com/llms-full.txt",
+    servers: [
+      {
+        name: "tasks",
+        transport: "streamable-http",
+        url: "https://api.example.com/mcp",
+        authentication: [
+          {
+            type: "oauth2",
+            protectedResourceMetadata:
+              "https://api.example.com/.well-known/oauth-protected-resource/mcp",
+          },
+        ],
+        tools: ["list_tasks", "update_task"],
+      },
+    ],
+  }),
+);
+```
+
+Build `referenceMarkdown` from your existing docs. The formatter adds no content or access rules.
+Each server lists only its own tools, as names or objects with `name`, `title`, `description`,
+`inputSchema` and `annotations`. Supplied schemas and annotations are kept unchanged.
+
+For a local server, use `transport: "stdio"`, `command` and optional `args` instead of `url`.
+`authentication` is a list of accepted methods: `oauth2` with `protectedResourceMetadata`, `api-key`
+with `in` (`header` or `environment`), `name` and optional `prefix`, `session` with a `description`,
+or `none` for public access. Methods can also include `description` and `documentation`.
+
+`/.well-known/mcp.json` is discovery metadata, not a universal MCP standard or a client config.
+It does not replace the live server's `tools/list`. These files do not promise search rankings or
+support in a particular client.
+
 ## Rendering
 
 ```ts

package/dist/discovery.d.ts

@@ -0,0 +1,76 @@
+/** Static discovery files. Content, addresses and access rules stay in the app. */
+export interface LlmsLink {
+    title: string;
+    url: string;
+    description?: string;
+}
+export interface LlmsSection {
+    title: string;
+    links: readonly LlmsLink[];
+}
+export interface LlmsTxtOptions {
+    title: string;
+    /** A short description, written as a blockquote. */
+    summary?: string;
+    /** Markdown kept as supplied. Use this for the text in llms-full.txt. */
+    body?: string;
+    sections?: readonly LlmsSection[];
+}
+/** llms.txt or llms-full.txt, as Markdown with a trailing newline. */
+export declare function llmsTxt({ title, summary, body, sections }: LlmsTxtOptions): string;
+/** Declare each accepted method. This is documentation, not an access check. */
+export type McpDiscoveryAuthentication = ({
+    type: "oauth2";
+    protectedResourceMetadata: string;
+} | {
+    type: "api-key";
+    in: "header" | "environment";
+    name: string;
+    prefix?: string;
+} | {
+    type: "none";
+} | {
+    type: "session";
+    description: string;
+}) & {
+    description?: string;
+    documentation?: string;
+};
+/** A tool as this server exposes it, not the combined catalog of every server. */
+export interface McpDiscoveryTool {
+    name: string;
+    title?: string;
+    description?: string;
+    inputSchema?: object;
+    annotations?: object;
+}
+export type McpDiscoveryServer = {
+    name: string;
+    /** Several entries mean the server accepts any one of these methods. */
+    authentication: readonly McpDiscoveryAuthentication[];
+    tools?: readonly (string | McpDiscoveryTool)[];
+} & ({
+    transport: "streamable-http";
+    url: string;
+} | {
+    transport: "stdio";
+    command: string;
+    args?: readonly string[];
+});
+export interface McpDiscoveryDocument {
+    name: string;
+    description?: string;
+    homepage: string;
+    documentation: string;
+    llmsTxt?: string;
+    llmsFullTxt?: string;
+    openApi?: string;
+    servers: readonly McpDiscoveryServer[];
+}
+/**
+ * /.well-known/mcp.json, as JSON with a trailing newline. This is a discovery convention,
+ * not a standard client configuration or a replacement for MCP tools/list.
+ * No transport, access rule or tool is inferred, and supplied schemas and annotations are kept.
+ */
+export declare function mcpDiscoveryJson(document: McpDiscoveryDocument): string;
+//# sourceMappingURL=discovery.d.ts.map

package/dist/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../src/discovery.ts"],"names":[],"mappings":"AAAA,mFAAmF;AAEnF,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;CACnC;AAED,sEAAsE;AACtE,wBAAgB,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,QAAa,EAAE,EAAE,cAAc,GAAG,MAAM,CAuBvF;AAED,gFAAgF;AAChF,MAAM,MAAM,0BAA0B,GAAG,CACrC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,yBAAyB,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,EAAE,EAAE,QAAQ,GAAG,aAAa,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAChF;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAC3C,GAAG;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAErD,kFAAkF;AAClF,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,cAAc,EAAE,SAAS,0BAA0B,EAAE,CAAC;IACtD,KAAK,CAAC,EAAE,SAAS,CAAC,MAAM,GAAG,gBAAgB,CAAC,EAAE,CAAC;CAChD,GAAG,CACA;IAAE,SAAS,EAAE,iBAAiB,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC7C;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CACpE,CAAC;AAEF,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACxC;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,MAAM,CAWvE"}

package/dist/discovery.js

@@ -0,0 +1,37 @@
+/** Static discovery files. Content, addresses and access rules stay in the app. */
+/** llms.txt or llms-full.txt, as Markdown with a trailing newline. */
+export function llmsTxt({ title, summary, body, sections = [] }) {
+    if (title.trim() === "")
+        throw new Error("llms: `title` is empty. Name the site or package.");
+    const parts = [`# ${title}`];
+    if (summary)
+        parts.push(summary
+            .split(/\r?\n/)
+            .map((line) => `> ${line}`)
+            .join("\n"));
+    if (body)
+        parts.push(body);
+    for (const section of sections) {
+        parts.push(`## ${section.title}`);
+        parts.push(section.links
+            .map((link) => `- [${link.title}](${link.url})${link.description ? `: ${link.description}` : ""}`)
+            .join("\n"));
+    }
+    return `${parts.join("\n\n").trimEnd()}\n`;
+}
+/**
+ * /.well-known/mcp.json, as JSON with a trailing newline. This is a discovery convention,
+ * not a standard client configuration or a replacement for MCP tools/list.
+ * No transport, access rule or tool is inferred, and supplied schemas and annotations are kept.
+ */
+export function mcpDiscoveryJson(document) {
+    if (document.name.trim() === "")
+        throw new Error("mcp discovery: `name` is empty. Name the site or package.");
+    if (document.servers.length === 0)
+        throw new Error("mcp discovery: `servers` is empty. List the servers this file describes.");
+    for (const server of document.servers)
+        if (server.authentication.length === 0)
+            throw new Error(`mcp discovery: "${server.name}" has no authentication entry. Declare how access works, including type "none" when it is public.`);
+    return `${JSON.stringify(document, null, 2)}\n`;
+}
+//# sourceMappingURL=discovery.js.map

package/dist/discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../src/discovery.ts"],"names":[],"mappings":"AAAA,mFAAmF;AAsBnF,sEAAsE;AACtE,MAAM,UAAU,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,GAAG,EAAE,EAAkB;IAC7E,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IAC9F,MAAM,KAAK,GAAG,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC;IAC7B,IAAI,OAAO;QACT,KAAK,CAAC,IAAI,CACR,OAAO;aACJ,KAAK,CAAC,OAAO,CAAC;aACd,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC;aAC1B,IAAI,CAAC,IAAI,CAAC,CACd,CAAC;IACJ,IAAI,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QAClC,KAAK,CAAC,IAAI,CACR,OAAO,CAAC,KAAK;aACV,GAAG,CACF,CAAC,IAAI,EAAE,EAAE,CACP,MAAM,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CACrF;aACA,IAAI,CAAC,IAAI,CAAC,CACd,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,IAAI,CAAC;AAC7C,CAAC;AAwCD;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAA8B;IAC7D,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE;QAC7B,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAC/E,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,0EAA0E,CAAC,CAAC;IAC9F,KAAK,MAAM,MAAM,IAAI,QAAQ,CAAC,OAAO;QACnC,IAAI,MAAM,CAAC,cAAc,CAAC,MAAM,KAAK,CAAC;YACpC,MAAM,IAAI,KAAK,CACb,mBAAmB,MAAM,CAAC,IAAI,mGAAmG,CAClI,CAAC;IACN,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;AAClD,CAAC"}

package/dist/head.d.ts

@@ -83,14 +83,14 @@ export interface FaqEntry {
     answer: string;
 }
 /**
- * FAQ structured data for `headExtra`, with the script-closing sequence escaped.
+ * Structured data for `headExtra`. The caller owns the schema and its claims.
  *
- * A `</script>` inside an answer ends the element early and ships the rest of the JSON as markup.
- * `<\/` is the same string to a JSON parser and inert to an HTML one, so every `</` becomes `<\/`
- * and `<!--` becomes `<\!--`. `JSON.stringify` never emits `<` outside a string, since the
- * structural characters are all brackets, quotes and digits. The replacement only ever touches
- * copy.
+ * Escape every less-than character as JSON, not HTML: `</script>` can close the element, and
+ * `<!--<script>` can make the HTML parser swallow the real closing tag. Escaping only a slash
+ * misses that second case; adding a backslash before `!` makes the JSON invalid.
  */
+export declare function jsonLd(data: object): string;
+/** FAQ structured data from the same strings the page renders. */
 export declare function faqJsonLd(faqs: readonly FaqEntry[]): string;
 /**
  * One page's `<head>` and body, written into the built template.

package/dist/head.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"head.d.ts","sourceRoot":"","sources":["../src/head.ts"],"names":[],"mappings":"AAiBA,0FAA0F;AAC1F,eAAO,MAAM,UAAU,4BAA0B,CAAC;AA0FlD,yFAAyF;AACzF,MAAM,WAAW,SAAS;IACxB;yBACqB;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,QAAQ;IACvB,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;;OAMG;IACH,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wIAAwI;IACxI,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;gDAC4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;IAClC;;;;;;;;;;;;OAYG;IACH,IAAI,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACxC;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG5C;AAED;;mFAEmF;AACnF,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,QAAQ,EAAE,GAAG,MAAM,CAY3D;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,MAAM,CAuHjE;AAED,MAAM,WAAW,cAAc;IAC7B,wFAAwF;IACxF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;uDACmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAsBD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,cAAmB,GAC1B,IAAI,CAgEN"}
+{"version":3,"file":"head.d.ts","sourceRoot":"","sources":["../src/head.ts"],"names":[],"mappings":"AAiBA,0FAA0F;AAC1F,eAAO,MAAM,UAAU,4BAA0B,CAAC;AA0FlD,yFAAyF;AACzF,MAAM,WAAW,SAAS;IACxB;yBACqB;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,QAAQ;IACvB,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;;OAMG;IACH,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wIAAwI;IACxI,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;gDAC4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;IAClC;;;;;;;;;;;;OAYG;IACH,IAAI,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACxC;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG5C;AAED;;mFAEmF;AACnF,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG3C;AAED,kEAAkE;AAClE,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,QAAQ,EAAE,GAAG,MAAM,CAU3D;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,MAAM,CAuHjE;AAED,MAAM,WAAW,cAAc;IAC7B,wFAAwF;IACxF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;uDACmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAsBD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,cAAmB,GAC1B,IAAI,CAgEN"}

package/dist/head.js

@@ -113,16 +113,19 @@ export function ogLocale(tag) {
     return TERRITORY[tag] ?? tag.replace("-", "_");
 }
 /**
- * FAQ structured data for `headExtra`, with the script-closing sequence escaped.
+ * Structured data for `headExtra`. The caller owns the schema and its claims.
  *
- * A `</script>` inside an answer ends the element early and ships the rest of the JSON as markup.
- * `<\/` is the same string to a JSON parser and inert to an HTML one, so every `</` becomes `<\/`
- * and `<!--` becomes `<\!--`. `JSON.stringify` never emits `<` outside a string, since the
- * structural characters are all brackets, quotes and digits. The replacement only ever touches
- * copy.
+ * Escape every less-than character as JSON, not HTML: `</script>` can close the element, and
+ * `<!--<script>` can make the HTML parser swallow the real closing tag. Escaping only a slash
+ * misses that second case; adding a backslash before `!` makes the JSON invalid.
  */
+export function jsonLd(data) {
+    const json = JSON.stringify(data).replace(/</g, "\\u003c");
+    return `<script type="application/ld+json">${json}</script>`;
+}
+/** FAQ structured data from the same strings the page renders. */
 export function faqJsonLd(faqs) {
-    const data = {
+    return jsonLd({
         "@context": "https://schema.org",
         "@type": "FAQPage",
         mainEntity: faqs.map((faq) => ({
@@ -130,9 +133,7 @@ export function faqJsonLd(faqs) {
             name: faq.question,
             acceptedAnswer: { "@type": "Answer", text: faq.answer },
         })),
-    };
-    const json = JSON.stringify(data).replace(/<\//g, "<\\/").replace(/<!--/g, "<\\!--");
-    return `<script type="application/ld+json">${json}</script>`;
+    });
 }
 /**
  * One page's `<head>` and body, written into the built template.

package/dist/head.js.map

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

package/dist/index.d.ts

@@ -18,8 +18,9 @@
  * and a repo that only wants a sitemap all install exactly what they use.
  */
 export { resolveKey } from "./catalog.ts";
+export { llmsTxt, mcpDiscoveryJson, type LlmsLink, type LlmsSection, type LlmsTxtOptions, type McpDiscoveryAuthentication, type McpDiscoveryDocument, type McpDiscoveryServer, type McpDiscoveryTool, } from "./discovery.ts";
 export { escapeAttr } from "./escape.ts";
-export { assertRendered, bakeHead, EMPTY_ROOT, faqJsonLd, ogLocale, type Alternate, type FaqEntry, type HeadTags, type RenderedChecks, } from "./head.ts";
+export { assertRendered, bakeHead, EMPTY_ROOT, faqJsonLd, jsonLd, ogLocale, type Alternate, type FaqEntry, type HeadTags, type RenderedChecks, } from "./head.ts";
 export { assertOgImages, loadRenderer, loadTemplate, writeDist, writeOgCards, type OgCard, type WriteOgCardsOptions, } from "./node.ts";
 export { webManifest, writeIconSet, type ManifestIcon, type PackIco, type RenderIcon, type WebManifestOptions, type WriteIconSetOptions, } from "./icons.ts";
 export { describeOverflow, fitText, OG_CANVAS, type FitOptions, type FitResult, type OgOverflow, } from "./og.ts";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAK1C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EACL,cAAc,EACd,QAAQ,EACR,UAAU,EACV,SAAS,EACT,QAAQ,EACR,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,cAAc,GACpB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,KAAK,MAAM,EACX,KAAK,mBAAmB,GACzB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,WAAW,EACX,YAAY,EACZ,KAAK,YAAY,EACjB,KAAK,OAAO,EACZ,KAAK,UAAU,EACf,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GACzB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,gBAAgB,EAChB,OAAO,EACP,SAAS,EACT,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,UAAU,GAChB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAK5E,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EACL,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,UAAU,EACV,UAAU,EACV,UAAU,EACV,cAAc,EACd,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,YAAY,GAClB,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EACL,OAAO,EACP,gBAAgB,EAChB,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,0BAA0B,EAC/B,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,GACtB,MAAM,gBAAgB,CAAC;AAKxB,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EACL,cAAc,EACd,QAAQ,EACR,UAAU,EACV,SAAS,EACT,MAAM,EACN,QAAQ,EACR,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,cAAc,GACpB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,KAAK,MAAM,EACX,KAAK,mBAAmB,GACzB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,WAAW,EACX,YAAY,EACZ,KAAK,YAAY,EACjB,KAAK,OAAO,EACZ,KAAK,UAAU,EACf,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GACzB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,gBAAgB,EAChB,OAAO,EACP,SAAS,EACT,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,UAAU,GAChB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAK5E,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EACL,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,UAAU,EACV,UAAU,EACV,UAAU,EACV,cAAc,EACd,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,YAAY,GAClB,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -18,12 +18,13 @@
  * and a repo that only wants a sitemap all install exactly what they use.
  */
 export { resolveKey } from "./catalog.js";
+export { llmsTxt, mcpDiscoveryJson, } from "./discovery.js";
 // `headExtra` takes raw markup, so the moment an adopter builds a tag out of its own copy it
 // needs the same escaping every tag this package writes already gets. Exported rather than
 // re-invented per app: an adopter's hand-rolled copy is one that can drift from ours, and the
 // first one to need it was building a `<link title="…">` out of a translated page title.
 export { escapeAttr } from "./escape.js";
-export { assertRendered, bakeHead, EMPTY_ROOT, faqJsonLd, ogLocale, } from "./head.js";
+export { assertRendered, bakeHead, EMPTY_ROOT, faqJsonLd, jsonLd, ogLocale, } from "./head.js";
 export { assertOgImages, loadRenderer, loadTemplate, writeDist, writeOgCards, } from "./node.js";
 export { webManifest, writeIconSet, } from "./icons.js";
 export { describeOverflow, fitText, OG_CANVAS, } from "./og.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,6FAA6F;AAC7F,2FAA2F;AAC3F,8FAA8F;AAC9F,yFAAyF;AACzF,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EACL,cAAc,EACd,QAAQ,EACR,UAAU,EACV,SAAS,EACT,QAAQ,GAKT,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,YAAY,GAGb,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,WAAW,EACX,YAAY,GAMb,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,gBAAgB,EAChB,OAAO,EACP,SAAS,GAIV,MAAM,SAAS,CAAC;AACjB,0FAA0F;AAC1F,OAAO,EAAE,cAAc,EAA8B,MAAM,gBAAgB,CAAC;AAM5E,OAAO,EACL,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,UAAU,EACV,UAAU,EACV,UAAU,EACV,cAAc,GAIf,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EACL,OAAO,EACP,gBAAgB,GAQjB,MAAM,gBAAgB,CAAC;AACxB,6FAA6F;AAC7F,2FAA2F;AAC3F,8FAA8F;AAC9F,yFAAyF;AACzF,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EACL,cAAc,EACd,QAAQ,EACR,UAAU,EACV,SAAS,EACT,MAAM,EACN,QAAQ,GAKT,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,YAAY,GAGb,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,WAAW,EACX,YAAY,GAMb,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,gBAAgB,EAChB,OAAO,EACP,SAAS,GAIV,MAAM,SAAS,CAAC;AACjB,0FAA0F;AAC1F,OAAO,EAAE,cAAc,EAA8B,MAAM,gBAAgB,CAAC;AAM5E,OAAO,EACL,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,UAAU,EACV,UAAU,EACV,UAAU,EACV,cAAc,GAIf,MAAM,cAAc,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gusnips/vite",
-  "version": "0.8.43",
+  "version": "0.8.44",
   "description": "The build-time half of a prerendered Vite SPA: head baking, sitemap, robots, the prerender driver, a shared vite preset, and the translation catalog check.",
   "type": "module",
   "license": "MIT",

package/src/discovery.test.ts

@@ -0,0 +1,120 @@
+import { describe, expect, it } from "vitest";
+import { llmsTxt, mcpDiscoveryJson, type McpDiscoveryDocument } from "./discovery.ts";
+
+describe("llmsTxt", () => {
+  it("writes the title, summary and links in the supplied order", () => {
+    expect(
+      llmsTxt({
+        title: "Example",
+        summary: "Read and update tasks.\nSign in before making changes.",
+        sections: [
+          {
+            title: "Reference",
+            links: [
+              {
+                title: "Connect",
+                url: "https://example.com/docs/mcp",
+                description: "Set up access.",
+              },
+              { title: "Full reference", url: "https://example.com/llms-full.txt" },
+            ],
+          },
+        ],
+      }),
+    ).toBe(
+      "# Example\n\n" +
+        "> Read and update tasks.\n> Sign in before making changes.\n\n" +
+        "## Reference\n\n" +
+        "- [Connect](https://example.com/docs/mcp): Set up access.\n" +
+        "- [Full reference](https://example.com/llms-full.txt)\n",
+    );
+  });
+
+  it("keeps app-owned Markdown and writes exactly one final newline", () => {
+    const body = '## Tools\n\n```json\n{"name":"list_tasks"}\n```\n\n';
+    expect(llmsTxt({ title: "Example", body })).toBe(`# Example\n\n${body.trimEnd()}\n`);
+    expect(llmsTxt({ title: "Example" })).toBe("# Example\n");
+  });
+
+  it("refuses an empty title", () => {
+    expect(() => llmsTxt({ title: " " })).toThrow(/title.*empty.*Name/);
+  });
+});
+
+const DOCUMENT: McpDiscoveryDocument = {
+  name: "Example",
+  homepage: "https://example.com",
+  documentation: "https://example.com/docs/mcp",
+  llmsTxt: "https://example.com/llms.txt",
+  llmsFullTxt: "https://example.com/llms-full.txt",
+  openApi: "https://api.example.com/openapi.json",
+  servers: [
+    {
+      name: "full",
+      transport: "streamable-http",
+      url: "https://api.example.com/mcp",
+      authentication: [
+        {
+          type: "oauth2",
+          protectedResourceMetadata:
+            "https://api.example.com/.well-known/oauth-protected-resource/mcp",
+        },
+        { type: "api-key", in: "header", name: "Authorization", prefix: "Bearer " },
+      ],
+      tools: [
+        {
+          name: "update_task",
+          title: "Update a task",
+          description: "Change a task's title.",
+          inputSchema: {
+            type: "object",
+            properties: { id: { type: "string" }, title: { type: "string", minLength: 1 } },
+            required: ["id", "title"],
+            additionalProperties: false,
+          },
+          annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true },
+        },
+      ],
+    },
+    {
+      name: "read-only",
+      transport: "streamable-http",
+      url: "https://api.example.com/mcp/read",
+      authentication: [{ type: "none" }],
+      tools: ["list_tasks"],
+    },
+    {
+      name: "local",
+      transport: "stdio",
+      command: "bunx",
+      args: ["example-mcp"],
+      authentication: [
+        { type: "session", description: "Connect the local app before you run a tool." },
+        { type: "api-key", in: "environment", name: "EXAMPLE_API_KEY" },
+      ],
+    },
+  ],
+};
+
+describe("mcpDiscoveryJson", () => {
+  it("keeps per-server transports, access methods and full tool cards unchanged", () => {
+    const output = mcpDiscoveryJson(DOCUMENT);
+    expect(JSON.parse(output)).toEqual(DOCUMENT);
+    expect(output.startsWith('{\n  "name": "Example",')).toBe(true);
+    expect(output.endsWith("\n")).toBe(true);
+    expect(output.endsWith("\n\n")).toBe(false);
+    expect(output).not.toContain('"url": "stdio');
+    expect(output).not.toContain('"tools": []');
+  });
+
+  it("refuses empty names, server lists or access declarations", () => {
+    expect(() => mcpDiscoveryJson({ ...DOCUMENT, name: " " })).toThrow(/name.*empty/);
+    expect(() => mcpDiscoveryJson({ ...DOCUMENT, servers: [] })).toThrow(/servers.*empty/);
+    expect(() =>
+      mcpDiscoveryJson({
+        ...DOCUMENT,
+        servers: [{ name: "local", transport: "stdio", command: "bunx", authentication: [] }],
+      }),
+    ).toThrow(/local.*no authentication.*Declare/);
+  });
+});

package/src/discovery.ts

@@ -0,0 +1,103 @@
+/** Static discovery files. Content, addresses and access rules stay in the app. */
+
+export interface LlmsLink {
+  title: string;
+  url: string;
+  description?: string;
+}
+
+export interface LlmsSection {
+  title: string;
+  links: readonly LlmsLink[];
+}
+
+export interface LlmsTxtOptions {
+  title: string;
+  /** A short description, written as a blockquote. */
+  summary?: string;
+  /** Markdown kept as supplied. Use this for the text in llms-full.txt. */
+  body?: string;
+  sections?: readonly LlmsSection[];
+}
+
+/** llms.txt or llms-full.txt, as Markdown with a trailing newline. */
+export function llmsTxt({ title, summary, body, sections = [] }: LlmsTxtOptions): string {
+  if (title.trim() === "") throw new Error("llms: `title` is empty. Name the site or package.");
+  const parts = [`# ${title}`];
+  if (summary)
+    parts.push(
+      summary
+        .split(/\r?\n/)
+        .map((line) => `> ${line}`)
+        .join("\n"),
+    );
+  if (body) parts.push(body);
+  for (const section of sections) {
+    parts.push(`## ${section.title}`);
+    parts.push(
+      section.links
+        .map(
+          (link) =>
+            `- [${link.title}](${link.url})${link.description ? `: ${link.description}` : ""}`,
+        )
+        .join("\n"),
+    );
+  }
+  return `${parts.join("\n\n").trimEnd()}\n`;
+}
+
+/** Declare each accepted method. This is documentation, not an access check. */
+export type McpDiscoveryAuthentication = (
+  | { type: "oauth2"; protectedResourceMetadata: string }
+  | { type: "api-key"; in: "header" | "environment"; name: string; prefix?: string }
+  | { type: "none" }
+  | { type: "session"; description: string }
+) & { description?: string; documentation?: string };
+
+/** A tool as this server exposes it, not the combined catalog of every server. */
+export interface McpDiscoveryTool {
+  name: string;
+  title?: string;
+  description?: string;
+  inputSchema?: object;
+  annotations?: object;
+}
+
+export type McpDiscoveryServer = {
+  name: string;
+  /** Several entries mean the server accepts any one of these methods. */
+  authentication: readonly McpDiscoveryAuthentication[];
+  tools?: readonly (string | McpDiscoveryTool)[];
+} & (
+  | { transport: "streamable-http"; url: string }
+  | { transport: "stdio"; command: string; args?: readonly string[] }
+);
+
+export interface McpDiscoveryDocument {
+  name: string;
+  description?: string;
+  homepage: string;
+  documentation: string;
+  llmsTxt?: string;
+  llmsFullTxt?: string;
+  openApi?: string;
+  servers: readonly McpDiscoveryServer[];
+}
+
+/**
+ * /.well-known/mcp.json, as JSON with a trailing newline. This is a discovery convention,
+ * not a standard client configuration or a replacement for MCP tools/list.
+ * No transport, access rule or tool is inferred, and supplied schemas and annotations are kept.
+ */
+export function mcpDiscoveryJson(document: McpDiscoveryDocument): string {
+  if (document.name.trim() === "")
+    throw new Error("mcp discovery: `name` is empty. Name the site or package.");
+  if (document.servers.length === 0)
+    throw new Error("mcp discovery: `servers` is empty. List the servers this file describes.");
+  for (const server of document.servers)
+    if (server.authentication.length === 0)
+      throw new Error(
+        `mcp discovery: "${server.name}" has no authentication entry. Declare how access works, including type "none" when it is public.`,
+      );
+  return `${JSON.stringify(document, null, 2)}\n`;
+}

package/src/head.test.ts

@@ -1,6 +1,6 @@
 import { describe, expect, it } from "vitest";
 import { PRERENDERED_ROUTE_ATTR } from "@gusnips/react";
-import { assertRendered, bakeHead, faqJsonLd, ogLocale } from "./head.ts";
+import { assertRendered, bakeHead, faqJsonLd, jsonLd, ogLocale } from "./head.ts";
 
 /**
  * Every failure `bakeHead` has is invisible until somebody reads a search result months later
@@ -433,6 +433,37 @@ describe("assertRendered", () => {
   });
 });
 
+describe("jsonLd", () => {
+  it("keeps the caller's schema and fields", () => {
+    const data = {
+      "@context": "https://schema.org",
+      "@graph": [
+        {
+          "@type": "SoftwareApplication",
+          name: "Example",
+          applicationCategory: "DeveloperApplication",
+        },
+        { "@type": "WebAPI", name: "Example API", documentation: "https://example.com/docs" },
+      ],
+    };
+    const script = jsonLd(data);
+    expect(script.startsWith('<script type="application/ld+json">')).toBe(true);
+    expect(JSON.parse(script.replace(/^<script[^>]*>/, "").replace(/<\/script>$/, ""))).toEqual(
+      data,
+    );
+  });
+
+  it("round-trips HTML parser control text without exposing markup", () => {
+    const data = { name: '</ScRiPt><img src=x onerror="x"> <!-- <script> $$ \\u003c' };
+    const script = jsonLd(data);
+    const inner = script.replace(/^<script[^>]*>/, "").replace(/<\/script>$/, "");
+    expect(inner).not.toContain("<");
+    expect(JSON.parse(inner)).toEqual(data);
+    expect(script.match(/<script/g)).toHaveLength(1);
+    expect(script.match(/<\/script>/g)).toHaveLength(1);
+  });
+});
+
 describe("faqJsonLd", () => {
   // One donor's template carried four questions where the page renders seven: the fix is to
   // generate the block from the same strings, not to keep a second copy beside them.
@@ -448,15 +479,12 @@ describe("faqJsonLd", () => {
     expect(script.match(/"@type":"Question"/g)).toHaveLength(2);
   });
 
-  // A `</script>` inside an answer ends the element early and ships the rest of the JSON as
-  // markup. `<\/` is the same string to a JSON parser and inert to an HTML one.
   it("escapes a script-closing sequence inside an answer", () => {
     const script = faqJsonLd([
       { question: "What if I write code?", answer: "Wrap it: </script> ends the block." },
     ]);
     expect(script).not.toContain("</script> ends");
-    expect(script).toContain("<\\/script> ends");
-    // …and what it emits still parses, back to the original copy.
+    expect(script).toContain("\\u003c/script> ends");
     const json = script.replace(/^<script[^>]*>/, "").replace(/<\/script>$/, "");
     const parsed = JSON.parse(json) as {
       mainEntity: Array<{ acceptedAnswer: { text: string } }>;
@@ -464,11 +492,13 @@ describe("faqJsonLd", () => {
     expect(parsed.mainEntity[0]?.acceptedAnswer.text).toBe("Wrap it: </script> ends the block.");
   });
 
-  // The positive control for the direction that flatters: an answer WITH markup must fail this
-  // test if the escaping ever stops running, not pass because the assertion went missing.
-  it("leaves no raw `</` sequence anywhere in the block", () => {
-    const script = faqJsonLd([{ question: "q", answer: "a </b> b <!-- c" }]);
-    const inner = script.replace(/<script[^>]*>/g, "").replace(/<\/script>/g, "");
-    expect(inner).not.toMatch(/<\//);
+  it("keeps comments valid JSON and inert to the HTML parser", () => {
+    const answer = "a </b> b <!-- <script> c";
+    const script = faqJsonLd([{ question: "q", answer }]);
+    const inner = script.replace(/^<script[^>]*>/, "").replace(/<\/script>$/, "");
+    expect(inner).not.toContain("<");
+    expect(JSON.parse(inner)).toMatchObject({
+      mainEntity: [{ acceptedAnswer: { text: answer } }],
+    });
   });
 });

package/src/head.ts

@@ -193,16 +193,20 @@ export interface FaqEntry {
 }
 
 /**
- * FAQ structured data for `headExtra`, with the script-closing sequence escaped.
+ * Structured data for `headExtra`. The caller owns the schema and its claims.
  *
- * A `</script>` inside an answer ends the element early and ships the rest of the JSON as markup.
- * `<\/` is the same string to a JSON parser and inert to an HTML one, so every `</` becomes `<\/`
- * and `<!--` becomes `<\!--`. `JSON.stringify` never emits `<` outside a string, since the
- * structural characters are all brackets, quotes and digits. The replacement only ever touches
- * copy.
+ * Escape every less-than character as JSON, not HTML: `</script>` can close the element, and
+ * `<!--<script>` can make the HTML parser swallow the real closing tag. Escaping only a slash
+ * misses that second case; adding a backslash before `!` makes the JSON invalid.
  */
+export function jsonLd(data: object): string {
+  const json = JSON.stringify(data).replace(/</g, "\\u003c");
+  return `<script type="application/ld+json">${json}</script>`;
+}
+
+/** FAQ structured data from the same strings the page renders. */
 export function faqJsonLd(faqs: readonly FaqEntry[]): string {
-  const data = {
+  return jsonLd({
     "@context": "https://schema.org",
     "@type": "FAQPage",
     mainEntity: faqs.map((faq) => ({
@@ -210,9 +214,7 @@ export function faqJsonLd(faqs: readonly FaqEntry[]): string {
       name: faq.question,
       acceptedAnswer: { "@type": "Answer", text: faq.answer },
     })),
-  };
-  const json = JSON.stringify(data).replace(/<\//g, "<\\/").replace(/<!--/g, "<\\!--");
-  return `<script type="application/ld+json">${json}</script>`;
+  });
 }
 
 /**

package/src/index.ts

@@ -18,6 +18,17 @@
  * and a repo that only wants a sitemap all install exactly what they use.
  */
 export { resolveKey } from "./catalog.ts";
+export {
+  llmsTxt,
+  mcpDiscoveryJson,
+  type LlmsLink,
+  type LlmsSection,
+  type LlmsTxtOptions,
+  type McpDiscoveryAuthentication,
+  type McpDiscoveryDocument,
+  type McpDiscoveryServer,
+  type McpDiscoveryTool,
+} from "./discovery.ts";
 // `headExtra` takes raw markup, so the moment an adopter builds a tag out of its own copy it
 // needs the same escaping every tag this package writes already gets. Exported rather than
 // re-invented per app: an adopter's hand-rolled copy is one that can drift from ours, and the
@@ -28,6 +39,7 @@ export {
   bakeHead,
   EMPTY_ROOT,
   faqJsonLd,
+  jsonLd,
   ogLocale,
   type Alternate,
   type FaqEntry,