| 1 | import type { APIRoute, GetStaticPaths } from "astro"; |
| 2 | import { getCollection } from "astro:content"; |
| 3 | |
| 4 | import { AGENTS, AGENTS_WITH_TOKEN, type AgentSetup } from "../data/agents"; |
| 5 | import { DIAGRAMS } from "../diagrams"; |
| 6 | import { toMarkdown } from "../diagrams/engine"; |
| 7 | |
| 8 | /** A diagram, as the text it is drawn from. */ |
| 9 | function diagramMarkdown(name: string): string { |
| 10 | const spec = DIAGRAMS[name]; |
| 11 | if (!spec) throw new Error(`No diagram named "${name}".`); |
| 12 | return toMarkdown(spec); |
| 13 | } |
| 14 | |
| 15 | /** The agent toggle, as plain Markdown: each agent's snippet under its name. */ |
| 16 | function agentsMarkdown(agents: AgentSetup[]): string { |
| 17 | return agents |
| 18 | .map((agent) => { |
| 19 | const where = agent.file ? ` (in \`${agent.file}\`)` : ""; |
| 20 | const then = agent.then ? `\n\n${agent.then}` : ""; |
| 21 | const fence = "```"; |
| 22 | return `**${agent.label}**${where}:\n\n${fence}${agent.lang}\n${agent.code}\n${fence}${then}`; |
| 23 | }) |
| 24 | .join("\n\n"); |
| 25 | } |
| 26 | |
| 27 | /** |
| 28 | * Every page as Markdown, at its path plus `.md`, for "Copy page" and for |
| 29 | * agents that read the docs: the title, what it is about, then the page. |
| 30 | */ |
| 31 | export const getStaticPaths: GetStaticPaths = async () => { |
| 32 | const pages = await getCollection("docs"); |
| 33 | return pages.map((page) => ({ |
| 34 | params: { slug: page.id === "" ? "index" : page.id }, |
| 35 | props: { page }, |
| 36 | })); |
| 37 | }; |
| 38 | |
| 39 | export const GET: APIRoute = ({ props }) => { |
| 40 | const { page } = props as { page: Awaited<ReturnType<typeof getCollection<"docs">>>[number] }; |
| 41 | const { title, description } = page.data; |
| 42 | // MDX pages keep their markup; strip imports and leave the rest readable. |
| 43 | const body = (page.body ?? "") |
| 44 | .replace(/^import .*$/gm, "") |
| 45 | // Tabs read as each tab's content under its label in bold. |
| 46 | .replace(/^[ \t]*<\/?Tabs[^>]*>[ \t]*\n?/gm, "") |
| 47 | .replace(/^[ \t]*<\/TabItem>[ \t]*$/gm, "") |
| 48 | .replace(/^([ \t]*)<TabItem label="([^"]+)"[^>]*>[ \t]*$/gm, "$1**$2**\n") |
| 49 | .replace(/^([ \t]*)<AgentSetup( variant="token")? \/>$/gm, (_match, indent: string, token?: string) => |
| 50 | agentsMarkdown(token ? AGENTS_WITH_TOKEN : AGENTS) |
| 51 | .split("\n") |
| 52 | .map((line) => (line ? indent + line : line)) |
| 53 | .join("\n"), |
| 54 | ) |
| 55 | // A diagram reads as its boxes and arrows, or its numbered steps. |
| 56 | .replace(/^([ \t]*)<Diagram name="([^"]+)" \/>$/gm, (_match, indent: string, name: string) => |
| 57 | diagramMarkdown(name) |
| 58 | .split("\n") |
| 59 | .map((line) => (line ? indent + line : line)) |
| 60 | .join("\n"), |
| 61 | ) |
| 62 | .trim(); |
| 63 | const text = `# ${title}\n\n${description ? `> ${description}\n\n` : ""}${body}\n`; |
| 64 | return new Response(text, { headers: { "content-type": "text/markdown; charset=utf-8" } }); |
| 65 | }; |