npm - @raystack/chronicle - Versions diffs - 0.1.0-canary.323385a → 0.1.0-canary.3e58cd9 - Mend

@raystack/chronicle 0.1.0-canary.323385a → 0.1.0-canary.3e58cd9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (80) hide show

package/dist/cli/index.js +268 -9902
package/package.json +20 -12
package/src/cli/commands/build.ts +27 -25
package/src/cli/commands/dev.ts +24 -25
package/src/cli/commands/init.ts +38 -132
package/src/cli/commands/serve.ts +36 -49
package/src/cli/commands/start.ts +20 -25
package/src/cli/index.ts +14 -14
package/src/cli/utils/config.ts +25 -26
package/src/cli/utils/index.ts +3 -3
package/src/cli/utils/resolve.ts +9 -3
package/src/cli/utils/scaffold.ts +11 -124
package/src/components/mdx/code.tsx +10 -1
package/src/components/mdx/details.module.css +1 -26
package/src/components/mdx/details.tsx +2 -3
package/src/components/mdx/image.tsx +5 -34
package/src/components/mdx/index.tsx +15 -1
package/src/components/mdx/link.tsx +18 -15
package/src/components/ui/breadcrumbs.tsx +8 -42
package/src/components/ui/search.tsx +63 -51
package/src/lib/api-routes.ts +6 -8
package/src/lib/config.ts +12 -35
package/src/lib/head.tsx +49 -0
package/src/lib/openapi.ts +8 -8
package/src/lib/page-context.tsx +111 -0
package/src/lib/source.ts +134 -63
package/src/pages/ApiLayout.tsx +33 -0
package/src/pages/ApiPage.tsx +73 -0
package/src/pages/DocsLayout.tsx +18 -0
package/src/pages/DocsPage.tsx +43 -0
package/src/pages/NotFound.tsx +17 -0
package/src/server/App.tsx +67 -0
package/src/server/api/apis-proxy.ts +69 -0
package/src/server/api/health.ts +5 -0
package/src/server/api/page/[...slug].ts +17 -0
package/src/server/api/search.ts +118 -0
package/src/server/api/specs.ts +9 -0
package/src/server/build-search-index.ts +117 -0
package/src/server/entry-client.tsx +86 -0
package/src/server/entry-server.tsx +100 -0
package/src/server/routes/llms.txt.ts +21 -0
package/src/server/routes/og.tsx +75 -0
package/src/server/routes/robots.txt.ts +11 -0
package/src/server/routes/sitemap.xml.ts +40 -0
package/src/server/utils/safe-path.ts +17 -0
package/src/server/vite-config.ts +126 -0
package/src/themes/default/Layout.tsx +78 -48
package/src/themes/default/Page.module.css +44 -0
package/src/themes/default/Page.tsx +9 -11
package/src/themes/default/Toc.tsx +25 -39
package/src/themes/default/index.ts +7 -9
package/src/themes/paper/ChapterNav.tsx +64 -45
package/src/themes/paper/Layout.module.css +1 -1
package/src/themes/paper/Layout.tsx +24 -12
package/src/themes/paper/Page.module.css +16 -4
package/src/themes/paper/Page.tsx +56 -63
package/src/themes/paper/ReadingProgress.tsx +160 -139
package/src/themes/paper/index.ts +5 -5
package/src/themes/registry.ts +7 -7
package/src/types/config.ts +11 -0
package/src/types/content.ts +6 -21
package/src/types/globals.d.ts +4 -0
package/src/types/theme.ts +4 -3
package/tsconfig.json +2 -3
package/next.config.mjs +0 -10
package/source.config.ts +0 -50
package/src/app/[[...slug]]/layout.tsx +0 -15
package/src/app/[[...slug]]/page.tsx +0 -57
package/src/app/api/apis-proxy/route.ts +0 -59
package/src/app/api/health/route.ts +0 -3
package/src/app/api/search/route.ts +0 -90
package/src/app/apis/[[...slug]]/layout.tsx +0 -26
package/src/app/apis/[[...slug]]/page.tsx +0 -57
package/src/app/layout.tsx +0 -26
package/src/app/llms-full.txt/route.ts +0 -18
package/src/app/llms.txt/route.ts +0 -15
package/src/app/providers.tsx +0 -8
package/src/cli/utils/process.ts +0 -7
package/src/themes/default/font.ts +0 -6
/package/src/{app/apis/[[...slug]]/layout.module.css → pages/ApiLayout.module.css} +0 -0

package/src/pages/DocsPage.tsx ADDED Viewed

@@ -0,0 +1,43 @@
+import { Head } from '@/lib/head';
+import { usePageContext } from '@/lib/page-context';
+import { getTheme } from '@/themes/registry';
+interface DocsPageProps {
+  slug: string[];
+}
+export function DocsPage({ slug }: DocsPageProps) {
+  const { config, tree, page } = usePageContext();
+  if (!page) return null;
+  const { Page } = getTheme(config.theme?.name);
+  const pageUrl = config.url ? `${config.url}/${slug.join('/')}` : undefined;
+  return (
+    <>
+      <Head
+        title={page.frontmatter.title}
+        description={page.frontmatter.description}
+        config={config}
+        jsonLd={{
+          '@context': 'https://schema.org',
+          '@type': 'Article',
+          headline: page.frontmatter.title,
+          description: page.frontmatter.description,
+          ...(pageUrl && { url: pageUrl })
+        }}
+      />
+      <Page
+        page={{
+          slug,
+          frontmatter: page.frontmatter,
+          content: page.content,
+          toc: page.toc
+        }}
+        config={config}
+        tree={tree}
+      />
+    </>
+  );
+}

package/src/pages/NotFound.tsx ADDED Viewed

@@ -0,0 +1,17 @@
+import { Flex, Headline, Text } from '@raystack/apsara';
+export function NotFound() {
+  return (
+    <Flex
+      direction='column'
+      align='center'
+      justify='center'
+      style={{ minHeight: '60vh' }}
+    >
+      <Headline size='large' as='h1'>
+        404
+      </Headline>
+      <Text size={3}>Page not found</Text>
+    </Flex>
+  );
+}

package/src/server/App.tsx ADDED Viewed

@@ -0,0 +1,67 @@
+import '@raystack/apsara/normalize.css';
+import '@raystack/apsara/style.css';
+import { ThemeProvider } from '@raystack/apsara';
+import { useLocation } from 'react-router';
+import { Head } from '@/lib/head';
+import { usePageContext } from '@/lib/page-context';
+import { ApiLayout } from '@/pages/ApiLayout';
+import { ApiPage } from '@/pages/ApiPage';
+import { DocsLayout } from '@/pages/DocsLayout';
+import { DocsPage } from '@/pages/DocsPage';
+import type { ChronicleConfig } from '@/types';
+function resolveRoute(pathname: string) {
+  if (pathname.startsWith('/apis')) {
+    const slug = pathname
+      .replace(/^\/apis\/?/, '')
+      .split('/')
+      .filter(Boolean);
+    return { type: 'api' as const, slug };
+  }
+  const slug =
+    pathname === '/' ? [] : pathname.slice(1).split('/').filter(Boolean);
+  return { type: 'docs' as const, slug };
+}
+export function App() {
+  const { pathname } = useLocation();
+  const { config } = usePageContext();
+  const route = resolveRoute(pathname);
+  return (
+    <ThemeProvider enableSystem>
+      <RootHead config={config} />
+      {route.type === 'api' ? (
+        <ApiLayout>
+          <ApiPage slug={route.slug} />
+        </ApiLayout>
+      ) : (
+        <DocsLayout>
+          <DocsPage slug={route.slug} />
+        </DocsLayout>
+      )}
+    </ThemeProvider>
+  );
+}
+function RootHead({ config }: { config: ChronicleConfig }) {
+  return (
+    <Head
+      title={config.title}
+      description={config.description}
+      config={config}
+      jsonLd={
+        config.url
+          ? {
+              '@context': 'https://schema.org',
+              '@type': 'WebSite',
+              name: config.title,
+              description: config.description,
+              url: config.url
+            }
+          : undefined
+      }
+    />
+  );
+}

package/src/server/api/apis-proxy.ts ADDED Viewed

@@ -0,0 +1,69 @@
+import { defineHandler, HTTPError } from 'nitro';
+import { loadConfig } from '@/lib/config';
+import { loadApiSpecs } from '@/lib/openapi';
+interface ProxyRequest {
+  specName: string;
+  method: string;
+  path: string;
+  headers?: Record<string, string>;
+  body?: unknown;
+}
+export default defineHandler(async event => {
+  if (event.req.method !== 'POST') {
+    throw new HTTPError({ status: 405, message: 'Method not allowed' });
+  }
+  const { specName, method, path, headers, body } =
+    (await event.req.json()) as ProxyRequest;
+  if (!specName || !method || !path) {
+    throw new HTTPError({
+      status: 400,
+      message: 'Missing specName, method, or path'
+    });
+  }
+  const config = loadConfig();
+  const specs = await loadApiSpecs(config.api ?? []);
+  const spec = specs.find(s => s.name === specName);
+  if (!spec) {
+    throw new HTTPError({ status: 404, message: `Unknown spec: ${specName}` });
+  }
+  if (/^[a-z]+:\/\//i.test(path) || path.includes('..')) {
+    throw new HTTPError({ status: 400, message: 'Invalid path' });
+  }
+  const url = spec.server.url + path;
+  try {
+    const response = await fetch(url, {
+      method,
+      headers,
+      body: body ? JSON.stringify(body) : undefined
+    });
+    const contentType = response.headers.get('content-type') ?? '';
+    const responseBody = contentType.includes('application/json')
+      ? await response.json()
+      : await response.text();
+    return {
+      status: response.status,
+      statusText: response.statusText,
+      body: responseBody
+    };
+  } catch (error) {
+    const message =
+      error instanceof Error
+        ? `${error.message}${error.cause ? `: ${(error.cause as Error).message}` : ''}`
+        : 'Request failed';
+    throw new HTTPError({
+      status: 502,
+      message: `Could not reach ${url}\n${message}`
+    });
+  }
+});

package/src/server/api/health.ts ADDED Viewed

@@ -0,0 +1,5 @@
+import { defineHandler } from 'nitro';
+export default defineHandler(() => {
+  return { status: 'ok' };
+});

package/src/server/api/page/[...slug].ts ADDED Viewed

@@ -0,0 +1,17 @@
+import { defineHandler, HTTPError } from 'nitro';
+import { getPage, extractFrontmatter, getRelativePath } from '@/lib/source';
+export default defineHandler(async event => {
+  const slugParam = event.context.params?.slug ?? '';
+  const slug = slugParam ? slugParam.split('/') : [];
+  const page = await getPage(slug);
+  if (!page) {
+    throw new HTTPError({ status: 404, message: 'Page not found' });
+  }
+  return {
+    frontmatter: extractFrontmatter(page, slug[slug.length - 1]),
+    relativePath: getRelativePath(page),
+  };
+});

package/src/server/api/search.ts ADDED Viewed

@@ -0,0 +1,118 @@
+import MiniSearch from 'minisearch';
+import { defineHandler } from 'nitro';
+import type { OpenAPIV3 } from 'openapi-types';
+import { getSpecSlug } from '@/lib/api-routes';
+import { loadConfig } from '@/lib/config';
+import { loadApiSpecs } from '@/lib/openapi';
+import { getPages, extractFrontmatter } from '@/lib/source';
+interface SearchDocument {
+  id: string;
+  url: string;
+  title: string;
+  content: string;
+  type: 'page' | 'api';
+}
+let searchIndex: MiniSearch<SearchDocument> | null = null;
+let cachedDocs: SearchDocument[] | null = null;
+function createIndex(docs: SearchDocument[]): MiniSearch<SearchDocument> {
+  const index = new MiniSearch<SearchDocument>({
+    fields: ['title', 'content'],
+    storeFields: ['url', 'title', 'type'],
+    searchOptions: {
+      boost: { title: 2 },
+      fuzzy: 0.2,
+      prefix: true
+    }
+  });
+  index.addAll(docs);
+  return index;
+}
+async function scanContent(): Promise<SearchDocument[]> {
+  const pages = await getPages();
+  return pages.map(p => {
+    const fm = extractFrontmatter(p);
+    return {
+      id: p.url,
+      url: p.url,
+      title: fm.title,
+      content: fm.description ?? '',
+      type: 'page' as const
+    };
+  });
+}
+async function buildApiDocs(): Promise<SearchDocument[]> {
+  const config = loadConfig();
+  if (!config.api?.length) return [];
+  const docs: SearchDocument[] = [];
+  const specs = await loadApiSpecs(config.api);
+  for (const spec of specs) {
+    const specSlug = getSpecSlug(spec);
+    const paths = spec.document.paths ?? {};
+    for (const [, pathItem] of Object.entries(paths)) {
+      if (!pathItem) continue;
+      for (const method of ['get', 'post', 'put', 'delete', 'patch'] as const) {
+        const op = pathItem[method] as OpenAPIV3.OperationObject | undefined;
+        if (!op?.operationId) continue;
+        const url = `/apis/${specSlug}/${encodeURIComponent(op.operationId)}`;
+        docs.push({
+          id: url,
+          url,
+          title: `${method.toUpperCase()} ${op.summary ?? op.operationId}`,
+          content: op.description ?? '',
+          type: 'api'
+        });
+      }
+    }
+  }
+  return docs;
+}
+async function getDocs(): Promise<SearchDocument[]> {
+  if (cachedDocs) return cachedDocs;
+  const [contentDocs, apiDocs] = await Promise.all([
+    scanContent(),
+    buildApiDocs()
+  ]);
+  cachedDocs = [...contentDocs, ...apiDocs];
+  return cachedDocs;
+}
+async function getIndex(): Promise<MiniSearch<SearchDocument>> {
+  if (searchIndex) return searchIndex;
+  const docs = await getDocs();
+  searchIndex = createIndex(docs);
+  return searchIndex;
+}
+export default defineHandler(async event => {
+  const query = event.url.searchParams.get('query') ?? '';
+  const index = await getIndex();
+  if (!query) {
+    const docs = await getDocs();
+    return docs
+      .filter(d => d.type === 'page')
+      .slice(0, 8)
+      .map(d => ({
+        id: d.id,
+        url: d.url,
+        type: d.type,
+        content: d.title
+      }));
+  }
+  return index.search(query).map(r => ({
+    id: r.id,
+    url: r.url,
+    type: r.type,
+    content: r.title
+  }));
+});

package/src/server/api/specs.ts ADDED Viewed

@@ -0,0 +1,9 @@
+import { defineHandler } from 'nitro';
+import { loadConfig } from '@/lib/config';
+import { loadApiSpecs } from '@/lib/openapi';
+export default defineHandler(async () => {
+  const config = loadConfig();
+  const specs = config.api?.length ? await loadApiSpecs(config.api) : [];
+  return specs;
+});

package/src/server/build-search-index.ts ADDED Viewed

@@ -0,0 +1,117 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import matter from 'gray-matter';
+import type { OpenAPIV3 } from 'openapi-types';
+import remarkParse from 'remark-parse';
+import { unified } from 'unified';
+import { visit } from 'unist-util-visit';
+import type { Heading, Text } from 'mdast';
+import { getSpecSlug } from '@/lib/api-routes';
+import { loadConfig } from '@/lib/config';
+import { loadApiSpecs } from '@/lib/openapi';
+interface SearchDocument {
+  id: string;
+  url: string;
+  title: string;
+  content: string;
+  type: 'page' | 'api';
+}
+function extractHeadings(markdown: string): string {
+  const tree = unified().use(remarkParse).parse(markdown);
+  const headings: string[] = [];
+  visit(tree, 'heading', (node: Heading) => {
+    const text = node.children
+      .filter((child): child is Text => child.type === 'text')
+      .map(child => child.value)
+      .join('');
+    if (text) headings.push(text);
+  });
+  return headings.join(' ');
+}
+async function scanContent(contentDir: string): Promise<SearchDocument[]> {
+  const docs: SearchDocument[] = [];
+  async function scan(dir: string, prefix: string[] = []) {
+    try {
+      const entries = await fs.readdir(dir, { withFileTypes: true });
+      for (const entry of entries) {
+        if (entry.name.startsWith('.') || entry.name === 'node_modules')
+          continue;
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+          await scan(fullPath, [...prefix, entry.name]);
+          continue;
+        }
+        if (!entry.name.endsWith('.mdx') && !entry.name.endsWith('.md'))
+          continue;
+        const raw = await fs.readFile(fullPath, 'utf-8');
+        const { data: fm, content } = matter(raw);
+        const baseName = entry.name.replace(/\.(mdx|md)$/, '');
+        const slugs = baseName === 'index' ? prefix : [...prefix, baseName];
+        const url = slugs.length === 0 ? '/' : `/${slugs.join('/')}`;
+        docs.push({
+          id: url,
+          url,
+          title: fm.title ?? baseName,
+          content: extractHeadings(content),
+          type: 'page'
+        });
+      }
+    } catch {
+      /* directory not readable */
+    }
+  }
+  await scan(contentDir);
+  return docs;
+}
+async function buildApiDocs(): Promise<SearchDocument[]> {
+  const config = loadConfig();
+  if (!config.api?.length) return [];
+  const docs: SearchDocument[] = [];
+  const specs = await loadApiSpecs(config.api);
+  for (const spec of specs) {
+    const specSlug = getSpecSlug(spec);
+    const paths = spec.document.paths ?? {};
+    for (const [, pathItem] of Object.entries(paths)) {
+      if (!pathItem) continue;
+      for (const method of ['get', 'post', 'put', 'delete', 'patch'] as const) {
+        const op = pathItem[method] as OpenAPIV3.OperationObject | undefined;
+        if (!op?.operationId) continue;
+        const url = `/apis/${specSlug}/${encodeURIComponent(op.operationId)}`;
+        docs.push({
+          id: url,
+          url,
+          title: `${method.toUpperCase()} ${op.summary ?? op.operationId}`,
+          content: op.description ?? '',
+          type: 'api'
+        });
+      }
+    }
+  }
+  return docs;
+}
+export async function generateSearchIndex(contentDir: string, outDir: string) {
+  const [contentDocs, apiDocs] = await Promise.all([
+    scanContent(contentDir),
+    buildApiDocs()
+  ]);
+  const documents = [...contentDocs, ...apiDocs];
+  const outPath = path.join(outDir, 'search-index.json');
+  await fs.writeFile(outPath, JSON.stringify(documents));
+  return documents.length;
+}

package/src/server/entry-client.tsx ADDED Viewed

@@ -0,0 +1,86 @@
+import '@vitejs/plugin-react/preamble';
+import React from 'react';
+import { hydrateRoot } from 'react-dom/client';
+import { BrowserRouter } from 'react-router';
+import { ReactRouterProvider } from 'fumadocs-core/framework/react-router';
+import { mdxComponents } from '@/components/mdx';
+import { PageProvider } from '@/lib/page-context';
+import type { ChronicleConfig, Frontmatter, Root, TableOfContents } from '@/types';
+import type { ApiSpec } from '@/lib/openapi';
+import type { ReactNode } from 'react';
+import { App } from './App';
+interface EmbeddedData {
+  config: ChronicleConfig;
+  tree: Root;
+  slug: string[];
+  frontmatter: Frontmatter;
+  relativePath: string;
+}
+const contentModules = import.meta.glob<{ default?: React.ComponentType<any>; toc?: TableOfContents }>(
+  '../../.content/**/*.{mdx,md}'
+);
+async function loadMdxModule(relativePath: string): Promise<{ content: ReactNode; toc: TableOfContents }> {
+  const withoutExt = relativePath.replace(/\.(mdx|md)$/, '');
+  const key = relativePath.endsWith('.md')
+    ? `../../.content/${withoutExt}.md`
+    : `../../.content/${withoutExt}.mdx`;
+  const loader = contentModules[key];
+  if (!loader) return { content: null, toc: [] };
+  const mod = await loader();
+  const content = mod.default
+    ? React.createElement(mod.default, { components: mdxComponents })
+    : null;
+  return { content, toc: mod.toc ?? [] };
+}
+async function hydrate() {
+  try {
+    const embedded = (
+      window as unknown as { __PAGE_DATA__?: EmbeddedData }
+    ).__PAGE_DATA__;
+    const config: ChronicleConfig = embedded?.config ?? {
+      title: 'Documentation'
+    };
+    const tree: Root = embedded?.tree ?? { name: 'root', children: [] };
+    const isApiPage =
+      window.location.pathname.startsWith('/apis') && !!config.api?.length;
+    const apiSpecs: ApiSpec[] = isApiPage
+      ? await fetch('/api/specs')
+          .then(r => r.json())
+          .catch(() => [])
+      : [];
+    const page = embedded?.relativePath
+      ? {
+          slug: embedded.slug,
+          frontmatter: embedded.frontmatter,
+          ...(await loadMdxModule(embedded.relativePath)),
+        }
+      : null;
+    hydrateRoot(
+      document.getElementById('root') as HTMLElement,
+      <BrowserRouter>
+        <ReactRouterProvider>
+          <PageProvider
+            initialConfig={config}
+            initialTree={tree}
+            initialPage={page}
+            initialApiSpecs={apiSpecs}
+            loadMdx={loadMdxModule}
+          >
+            <App />
+          </PageProvider>
+        </ReactRouterProvider>
+      </BrowserRouter>
+    );
+  } catch (err) {
+    console.error('Hydration failed:', err);
+  }
+}
+hydrate();

package/src/server/entry-server.tsx ADDED Viewed

@@ -0,0 +1,100 @@
+import '@raystack/apsara/normalize.css';
+import '@raystack/apsara/style.css';
+import React from 'react';
+import { renderToReadableStream } from 'react-dom/server.edge';
+import { StaticRouter } from 'react-router';
+import { ReactRouterProvider } from 'fumadocs-core/framework/react-router';
+import { mdxComponents } from '@/components/mdx';
+import { loadConfig } from '@/lib/config';
+import { loadApiSpecs } from '@/lib/openapi';
+import { PageProvider } from '@/lib/page-context';
+import { getPageTree, getPage, loadPageModule, extractFrontmatter, getRelativePath } from '@/lib/source';
+import { App } from './App';
+import clientAssets from './entry-client?assets=client';
+import serverAssets from './entry-server?assets=ssr';
+export default {
+  async fetch(req: Request) {
+    const url = new URL(req.url);
+    const pathname = url.pathname;
+    const slug = pathname === '/' ? [] : pathname.slice(1).split('/').filter(Boolean);
+    const config = loadConfig();
+    const apiSpecs = config.api?.length
+      ? await loadApiSpecs(config.api).catch(() => [])
+      : [];
+    const [tree, page] = await Promise.all([
+      getPageTree(),
+      getPage(slug),
+    ]);
+    const relativePath = page ? getRelativePath(page) : null;
+    const mdxModule = relativePath ? await loadPageModule(relativePath) : null;
+    const pageData = page
+      ? {
+          slug,
+          frontmatter: extractFrontmatter(page, slug[slug.length - 1]),
+          content: mdxModule?.default
+            ? React.createElement(mdxModule.default, { components: mdxComponents })
+            : null,
+          toc: mdxModule?.toc ?? [],
+        }
+      : null;
+    const embeddedData = {
+      config,
+      tree,
+      slug,
+      frontmatter: pageData?.frontmatter ?? null,
+      relativePath,
+    };
+    const safeJson = JSON.stringify(embeddedData).replace(/</g, '\\u003c');
+    const assets = clientAssets.merge(serverAssets);
+    const stream = await renderToReadableStream(
+      <html lang="en">
+        <head>
+          <meta charSet="UTF-8" />
+          <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+          {assets.css.map((attr: { href: string }) => (
+            <link key={attr.href} rel="stylesheet" {...attr} />
+          ))}
+          {assets.js.map((attr: { href: string }) => (
+            <link key={attr.href} rel="modulepreload" {...attr} />
+          ))}
+          <script type="module" src={assets.entry} />
+          <script dangerouslySetInnerHTML={{ __html: `window.__PAGE_DATA__ = ${safeJson}` }} />
+        </head>
+        <body>
+          <div id="root">
+            <StaticRouter location={pathname}>
+              <ReactRouterProvider>
+                <PageProvider
+                  initialConfig={config}
+                  initialTree={tree}
+                  initialPage={pageData}
+                  initialApiSpecs={apiSpecs}
+                  loadMdx={async () => ({ content: null, toc: [] })}
+                >
+                  <App />
+                </PageProvider>
+              </ReactRouterProvider>
+            </StaticRouter>
+          </div>
+        </body>
+      </html>,
+    );
+    const isApiRoute = pathname.startsWith('/apis');
+    const status = !page && !isApiRoute && slug.length > 0 ? 404 : 200;
+    return new Response(stream, {
+      status,
+      headers: { 'Content-Type': 'text/html;charset=utf-8' },
+    });
+  },
+};

package/src/server/routes/llms.txt.ts ADDED Viewed

@@ -0,0 +1,21 @@
+import { defineHandler, HTTPError } from 'nitro';
+import { loadConfig } from '@/lib/config';
+import { getPages, extractFrontmatter } from '@/lib/source';
+export default defineHandler(async event => {
+  const config = loadConfig();
+  if (!config.llms?.enabled) {
+    throw new HTTPError({ status: 404, message: 'Not Found' });
+  }
+  const pages = await getPages();
+  const index = pages.map(p => {
+    const fm = extractFrontmatter(p);
+    return `- [${fm.title}](${p.url})`;
+  }).join('\n');
+  const body = `# ${config.title}\n\n${config.description ?? ''}\n\n${index}`;
+  event.res.headers.set('Content-Type', 'text/plain');
+  return body;
+});