@eqtylab/docs 0.3.0 → 0.3.1

package/dist/runtime/components/CodeFence.astro

@@ -1,38 +0,0 @@
----
-/**
- * Fenced code through Equality's CodeBlock with no client React. eq-copy drives
- * the copy button and eq-highlight starts the highlight pass CodeBlock's own
- * useEffect never runs here. The highlighter owns language aliasing.
- */
-import { CodeBlock } from '@eqtylab/equality';
-
-interface Props {
-  code: string;
-  lang?: string;
-  title?: string;
-}
-
-const { code, lang = 'text', title } = Astro.props;
-
-const language = lang.toLowerCase();
----
-
-{/*
-  `block` is load-bearing: the fence is a custom element, which is inline by default.
-
-  The descendant rule undoes CodeBlock's max-h-64, which is wrong for a docs sample.
-  `!` is load-bearing too: Equality ships unlayered CSS, and an unlayered declaration
-  beats anything in `@layer utilities` whatever its specificity, so a plain utility
-  loses to `.code-block` and the sample silently goes back to scrolling at 16rem.
-*/}
-<eq-highlight
-  class="mb-4 block [&_[class*=code-block]]:max-h-none!"
-  data-eq-chrome
-  data-eq-copy={code}
->
-  <CodeBlock code={code} language={language} title={title} />
-</eq-highlight>
-<script>
-  import '@eqtylab/docs/scripts/eq-copy.ts';
-  import '@eqtylab/docs/scripts/eq-highlight.ts';
-</script>

package/dist/runtime/components/CodeFenceBridge.astro

@@ -1,20 +0,0 @@
----
-/**
- * Renders a fence from the props `rehypeCodeFence` lifted onto the `<pre>`.
- * Do not re-parse the slot: its HTML is escaped in dev and raw in build.
- */
-import CodeFence from './CodeFence.astro';
-
-interface Props {
-  'data-code'?: string;
-  'data-language'?: string;
-  'data-title'?: string;
-}
-
-const props = Astro.props as Props;
-const code = props['data-code'] ?? '';
-const lang = props['data-language'] ?? 'text';
-const title = props['data-title'];
----
-
-<CodeFence code={code} lang={lang} title={title} />

package/dist/runtime/components/Link.astro

@@ -1,21 +0,0 @@
----
-import { isExternalHref } from '@eqtylab/docs/paths';
-
-interface Props {
-  href?: string;
-  [key: string]: unknown;
-}
-
-const { href = '', ...rest } = Astro.props;
-const external = isExternalHref(href);
----
-
-<a
-  href={href}
-  class="text-inherit"
-  target={external ? '_blank' : undefined}
-  rel={external ? 'noopener noreferrer' : undefined}
-  {...rest}
->
-  <slot />
-</a>

package/dist/runtime/components/TableBridge.astro

@@ -1,18 +0,0 @@
----
-/** Bridges a markdown table to Equality's `Table`; the column count comes from `rehypeTableColumns`. */
-import { TableContainer } from '@eqtylab/equality';
-
-interface Props {
-  'data-column-count'?: string;
-}
-
-const count = Number(Astro.props['data-column-count'] ?? 0);
-
-// minmax(0, auto): without a zero minimum, one long unbroken cell blows the grid past its container.
-const columns = count > 0 ? `repeat(${count}, minmax(0, auto))` : undefined;
----
-
-{/* Flow spacing only; every visual property comes from Equality's Table. */}
-<TableContainer columns={columns} border className="mb-4" data-eq-chrome>
-  <slot />
-</TableContainer>

package/dist/runtime/components/index.ts

@@ -1,2 +0,0 @@
-/** Public components for MDX authors. `.astro` only: a React component here pulls React into every page. */
-export { default as Link } from './Link.astro';

package/dist/runtime/layouts/DocsPage.astro

@@ -1,50 +0,0 @@
----
-/** Header + sidebar | prose | TOC. The `doc` template. */
-import type { NavNode, TocNode } from '@eqtylab/docs/types';
-import CONFIG from 'virtual:eqty-docs/config';
-import DocsShell from './DocsShell.astro';
-import Header from '../chrome/Header.astro';
-import NavDrawer from '../chrome/NavDrawer.astro';
-import Sidebar from '../chrome/Sidebar.astro';
-import TableOfContents from '../chrome/TableOfContents.astro';
-
-interface Props {
-  title: string;
-  description?: string;
-  nav: NavNode[];
-  toc: TocNode[];
-  showToc?: boolean;
-  splash?: boolean;
-}
-
-const { title, description, nav, toc, showToc = true, splash = false } = Astro.props;
-
-// A section's own index page if it has one, else its first child. Never the sidebar repeated.
-const suggested = nav
-  .map((node) => ({ label: node.label, href: node.href ?? node.children?.[0]?.href }))
-  .filter((item): item is { label: string; href: string } => !!item.href)
-  .slice(0, 4);
----
-
-<DocsShell title={title} description={description}>
-  {/* A prop, not slot fallback: Astro registers a named slot at compile time, so a forwarded
-      slot always counts as filled and the fallback never runs. */}
-  <Header showSearch={!Astro.slots.has('search')} suggested={suggested}>
-    <slot name="search" slot="search" />
-    <slot name="versions" slot="versions" />
-  </Header>
-  <NavDrawer nodes={nav} />
-  <div class="flex items-start">
-    {!splash && <Sidebar nodes={nav} />}
-    {/* 128px of runway, so a page stops deliberately rather than at its last line. */}
-    <main
-      class="mx-auto flex w-full min-w-0 max-w-[calc(var(--eq-docs-content-max)+var(--eq-docs-toc-width)+8rem)] items-start gap-12 px-6 pb-32 pt-10 data-[splash]:max-w-none xl:gap-16"
-      data-splash={splash ? '' : undefined}
-    >
-      <div class="min-w-0 flex-1 [&>.eq-prose]:max-w-[var(--eq-docs-content-max)]">
-        <slot />
-      </div>
-      {!splash && showToc && toc.length > 0 && <TableOfContents items={toc} />}
-    </main>
-  </div>
-</DocsShell>

package/dist/runtime/layouts/DocsShell.astro

@@ -1,92 +0,0 @@
----
-/** The <html> document: head, theme bootstrap, and a slot for the page body. */
-import CONFIG from 'virtual:eqty-docs/config';
-import { withBase } from '@eqtylab/docs/paths';
-
-import '../styles/docs.css';
-
-interface Props {
-  title?: string;
-  description?: string;
-  /** Emit robots noindex. Set for every pinned version build. */
-  noIndex?: boolean;
-  /** Canonical URL, when it differs from the current page. */
-  canonical?: string;
-}
-
-const { title, description, noIndex, canonical } = Astro.props;
-
-const paths = {
-  base: import.meta.env.BASE_URL,
-  pathPrefix: CONFIG.pathPrefix,
-};
-
-const pageTitle = title && title !== CONFIG.title ? `${title} · ${CONFIG.title}` : CONFIG.title;
-const pageDescription = description ?? CONFIG.description;
-
-// Pinned version builds are noindex: latest today is not latest tomorrow.
-const robots = noIndex ?? !CONFIG.env.isLatest;
-
-/**
- * Blocking inline theme bootstrap, so the attribute is set before first paint.
- * Do not also call Equality's `initializeTheme`: it knows only light and dark
- * and its stored value would override this. Never write storage here, or
- * 'system' becomes a resolved value permanently. Constants must match
- * `runtime/lib/theme.ts`.
- */
-const themeBootstrap = `
-  (() => {
-    const KEY = 'eqty-docs-theme';
-    const EVENT = 'eqty-docs-theme-change';
-    const PERSIST = ${JSON.stringify(CONFIG.theme.persist)};
-    const query = window.matchMedia('(prefers-color-scheme: dark)');
-
-    const read = () => {
-      if (!PERSIST) return window.__eqtyDocsTheme ?? null;
-      try {
-        return window.localStorage.getItem(KEY);
-      } catch {
-        return null;
-      }
-    };
-
-    const apply = () => {
-      const stored = read();
-      const preference =
-        stored === 'dark' || stored === 'light' || stored === 'system' ? stored : 'system';
-      const resolved = preference === 'system' ? (query.matches ? 'dark' : 'light') : preference;
-      const root = document.documentElement;
-      root.setAttribute('data-equality-theme', resolved);
-      root.setAttribute('data-eq-theme-pref', preference);
-      // Native UI follows this, not the attribute above.
-      root.style.colorScheme = resolved;
-    };
-
-    apply();
-    query.addEventListener('change', apply);
-    window.addEventListener(EVENT, apply);
-    // The React subscription never touches the attribute, so other tabs repaint here.
-    window.addEventListener('storage', (event) => {
-      if (event.key === KEY) apply();
-    });
-  })();
-`;
----
-
-<!doctype html>
-<html lang="en">
-  <head>
-    <meta charset="utf-8" />
-    <meta name="viewport" content="width=device-width, initial-scale=1" />
-    <title>{pageTitle}</title>
-    {pageDescription && <meta name="description" content={pageDescription} />}
-    {robots && <meta name="robots" content="noindex, follow" />}
-    {canonical && <link rel="canonical" href={canonical} />}
-    <link rel="icon" href={withBase(CONFIG.favicon, paths)} />
-    <script is:inline set:html={themeBootstrap} />
-    <slot name="head" />
-  </head>
-  <body>
-    <slot />
-  </body>
-</html>

package/dist/runtime/lib/mdx-components.ts

@@ -1,43 +0,0 @@
-/**
- * Route-level MDX component map. Entries here OVERRIDE a page's own
- * `export const components`, so keep it small.
- */
-import {
-  TableBody,
-  TableCaption,
-  TableCell,
-  TableFooter,
-  TableHead,
-  TableHeader,
-  TableRow,
-} from '@eqtylab/equality';
-import CONFIG from 'virtual:eqty-docs/config';
-
-import AlertBridge from '../components/AlertBridge.astro';
-import CodeFenceBridge from '../components/CodeFenceBridge.astro';
-import Link from '../components/Link.astro';
-import TableBridge from '../components/TableBridge.astro';
-
-const base: Record<string, unknown> = {
-  a: Link,
-
-  // An explicit import of Alert from @eqtylab/equality still wins.
-  Alert: AlertBridge,
-
-  // All hook-free, so they render statically with no client directive.
-  table: TableBridge,
-  thead: TableHeader,
-  tbody: TableBody,
-  tfoot: TableFooter,
-  tr: TableRow,
-  th: TableHead,
-  td: TableCell,
-  caption: TableCaption,
-};
-
-// With 'shiki', Astro has already rendered the block.
-if (CONFIG.code?.highlighter === 'codeblock') {
-  base.pre = CodeFenceBridge;
-}
-
-export const mdxComponents = base;

package/dist/runtime/lib/nav-data.ts

@@ -1,74 +0,0 @@
-/** Bridges the content collections into the pure nav builder. Needs `astro:content`, so it lives in the runtime tree. */
-import { breadcrumbsFor, buildNavTree, buildTocTree, prevNextFor } from '@eqtylab/docs/nav';
-import type { GroupConfig } from '@eqtylab/docs/nav';
-import type { DocsNavEntry, NavNode } from '@eqtylab/docs/types';
-import { getCollection } from 'astro:content';
-import CONFIG from 'virtual:eqty-docs/config';
-
-export { buildTocTree, breadcrumbsFor, prevNextFor };
-
-/** No `versionPrefix`: the version already lives in `base`, and adding it here doubles the segment. */
-export function pathContext() {
-  return {
-    base: import.meta.env.BASE_URL,
-    pathPrefix: CONFIG.pathPrefix,
-  };
-}
-
-/** All docs entries, with drafts filtered out unless we're in `astro dev`. */
-export async function docsEntries() {
-  return getCollection('docs', ({ data }: { data: { draft?: boolean } }) =>
-    import.meta.env.DEV ? true : !data.draft
-  );
-}
-
-async function groupMap(): Promise<Map<string, GroupConfig>> {
-  const map = new Map<string, GroupConfig>();
-  try {
-    const groups = await getCollection('docsGroups');
-    for (const group of groups) {
-      map.set(group.id, group.data as GroupConfig);
-    }
-  } catch {
-    // docsGroups is optional; no _group.yaml means alphabetical ordering.
-  }
-  return map;
-}
-
-export async function docsNav(currentPath: string): Promise<NavNode[]> {
-  const [entries, groups] = await Promise.all([docsEntries(), groupMap()]);
-
-  const navEntries: DocsNavEntry[] = entries.map((entry) => ({
-    id: entry.id,
-    filePath: entry.filePath,
-    label: entry.data.navLabel ?? entry.data.title,
-    icon: entry.data.icon,
-    badge: entry.data.badge ?? deprecationBadge(entry.data.deprecated),
-    hidden: entry.data.hidden,
-    draft: entry.data.draft,
-  }));
-
-  return buildNavTree({
-    entries: navEntries,
-    groups,
-    currentPath,
-    paths: pathContext(),
-    defaultCollapsed: CONFIG.sidebar.collapsed,
-    defaultSort: CONFIG.sidebar.sort,
-    extra: (CONFIG.sidebar.extra ?? []) as NavNode[],
-    onWarn: warnOnce,
-  });
-}
-
-// The nav is rebuilt per page; report each config problem once per build.
-const warned = new Set<string>();
-function warnOnce(message: string) {
-  if (warned.has(message)) return;
-  warned.add(message);
-  console.warn(`[@eqtylab/docs] ${message}`);
-}
-
-function deprecationBadge(deprecated: unknown) {
-  if (!deprecated) return undefined;
-  return { text: 'Deprecated', variant: 'warning' as const };
-}

package/dist/runtime/lib/summary.ts

@@ -1,57 +0,0 @@
-/** Fallback page summary for pages with no `description` frontmatter. Build time only. */
-
-const MAX_LENGTH = 140;
-
-function isSkippable(line: string): boolean {
-  return (
-    line === '' ||
-    line.startsWith('#') ||
-    line.startsWith('import ') ||
-    line.startsWith('export ') ||
-    line.startsWith('<') ||
-    line.startsWith('|') ||
-    line.startsWith('>') ||
-    line.startsWith('- ') ||
-    line.startsWith('* ') ||
-    /^\d+\.\s/.test(line)
-  );
-}
-
-/** Enough markdown to make one sentence readable; anything richer is not a summary anyway. */
-function stripMarkdown(text: string): string {
-  return text
-    .replace(/!\[[^\]]*\]\([^)]*\)/g, '')
-    .replace(/\[([^\]]*)\]\([^)]*\)/g, '$1')
-    .replace(/[`*_]/g, '')
-    .replace(/<[^>]+>/g, '')
-    .replace(/\s+/g, ' ')
-    .trim();
-}
-
-function truncate(text: string): string {
-  if (text.length <= MAX_LENGTH) return text;
-  const cut = text.slice(0, MAX_LENGTH);
-  const lastSpace = cut.lastIndexOf(' ');
-  return `${cut.slice(0, lastSpace > 0 ? lastSpace : MAX_LENGTH).trimEnd()}…`;
-}
-
-/** First paragraph of prose. Frontmatter is already stripped by the content loader. */
-export function firstParagraph(body: string | undefined): string | undefined {
-  if (!body) return undefined;
-
-  let inFence = false;
-  for (const raw of body.split('\n')) {
-    const line = raw.trim();
-
-    if (line.startsWith('```')) {
-      inFence = !inFence;
-      continue;
-    }
-    if (inFence || isSkippable(line)) continue;
-
-    const text = stripMarkdown(line);
-    // A line that was nothing but a link or a tag strips to nothing; keep looking.
-    if (text) return truncate(text);
-  }
-  return undefined;
-}

package/dist/runtime/lib/theme.ts

@@ -1,84 +0,0 @@
-import CONFIG from 'virtual:eqty-docs/config';
-
-/** These four are repeated in DocsShell.astro's inline script. Change both. */
-export const STORAGE_KEY = 'eqty-docs-theme';
-export const UPDATE_EVENT = 'eqty-docs-theme-change';
-/** Equality's palette keys on this. */
-export const THEME_ATTRIBUTE = 'data-equality-theme';
-/** ThemeToggle.module.css reads this, so the trigger is correct before React loads. */
-export const PREFERENCE_ATTRIBUTE = 'data-eq-theme-pref';
-
-export type ThemePreference = 'light' | 'dark' | 'system';
-
-export type ResolvedTheme = 'light' | 'dark';
-
-const PREFERENCES: readonly ThemePreference[] = ['dark', 'light', 'system'];
-
-function isPreference(value: unknown): value is ThemePreference {
-  return typeof value === 'string' && (PREFERENCES as readonly string[]).includes(value);
-}
-
-function readStored(): string | null {
-  if (!CONFIG.theme.persist) return window.__eqtyDocsTheme ?? null;
-  try {
-    return window.localStorage.getItem(STORAGE_KEY);
-  } catch {
-    return null;
-  }
-}
-
-function writeStored(preference: ThemePreference): void {
-  if (!CONFIG.theme.persist) {
-    window.__eqtyDocsTheme = preference;
-    return;
-  }
-  try {
-    window.localStorage.setItem(STORAGE_KEY, preference);
-  } catch {
-    // Ignore a storage failure; the theme still applies for this page.
-  }
-}
-
-export function getSystemTheme(): ResolvedTheme {
-  return window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light';
-}
-
-export function getThemePreference(): ThemePreference {
-  if (typeof window === 'undefined') return 'system';
-  const stored = readStored();
-  return isPreference(stored) ? stored : 'system';
-}
-
-export function resolveTheme(preference: ThemePreference): ResolvedTheme {
-  return preference === 'system' ? getSystemTheme() : preference;
-}
-
-export function applyTheme(preference: ThemePreference): void {
-  const resolved = resolveTheme(preference);
-  const root = document.documentElement;
-  root.setAttribute(THEME_ATTRIBUTE, resolved);
-  root.setAttribute(PREFERENCE_ATTRIBUTE, preference);
-  // Without this, scrollbars and form controls stay light on a dark page.
-  root.style.colorScheme = resolved;
-}
-
-export function setThemePreference(preference: ThemePreference): void {
-  writeStored(preference);
-  applyTheme(preference);
-  window.dispatchEvent(new CustomEvent(UPDATE_EVENT, { detail: preference }));
-}
-
-export function subscribeToThemePreference(listener: () => void): () => void {
-  if (typeof window === 'undefined') return () => {};
-
-  const onStorage = (event: StorageEvent) => {
-    if (event.key === STORAGE_KEY) listener();
-  };
-
-  window.addEventListener(UPDATE_EVENT, listener);
-  window.addEventListener('storage', onStorage);
-  return () => {
-    window.removeEventListener(UPDATE_EVENT, listener);
-    window.removeEventListener('storage', onStorage);
-  };
-}

package/dist/runtime/routes/docs-md.ts

@@ -1,33 +0,0 @@
-/** Markdown twin of every page, for LLM and agent consumption. */
-import { idToPath } from '@eqtylab/docs/paths';
-import type { APIRoute } from 'astro';
-import { getCollection } from 'astro:content';
-import CONFIG from 'virtual:eqty-docs/config';
-
-export async function getStaticPaths() {
-  const entries = await getCollection(
-    'docs',
-    ({ data }: { data: { draft?: boolean; noIndex?: boolean } }) => !data.draft && !data.noIndex
-  );
-  return entries.map((entry) => ({
-    // An empty slug would emit a file literally called ".md".
-    params: { slug: idToPath(entry.id) || 'index' },
-    props: { entry },
-  }));
-}
-
-export const GET: APIRoute = ({ props }) => {
-  const { entry } = props as {
-    entry: { body?: string; data: { title: string; description?: string } };
-  };
-
-  const frontmatter = ['---', `title: ${JSON.stringify(entry.data.title)}`];
-  if (entry.data.description) {
-    frontmatter.push(`description: ${JSON.stringify(entry.data.description)}`);
-  }
-  frontmatter.push(`source: ${JSON.stringify(CONFIG.title)}`, '---', '');
-
-  return new Response(frontmatter.join('\n') + (entry.body ?? ''), {
-    headers: { 'Content-Type': 'text/markdown; charset=utf-8' },
-  });
-};

package/dist/runtime/routes/docs.astro

@@ -1,92 +0,0 @@
----
-import { getCollection, render } from 'astro:content';
-import CONFIG from 'virtual:eqty-docs/config';
-import { docsHref, idToPath, joinPath, normalizePath } from '@eqtylab/docs/paths';
-import DocsPage from '../layouts/DocsPage.astro';
-import { breadcrumbsFor, buildTocTree, docsNav, pathContext, prevNextFor } from '../lib/nav-data.ts';
-import { firstParagraph } from '../lib/summary.ts';
-import { mdxComponents } from '../lib/mdx-components.ts';
-import PageFooter from '../chrome/PageFooter.astro';
-import Prose from '../chrome/Prose.astro';
-
-export async function getStaticPaths() {
-  const entries = await getCollection('docs', ({ data }: { data: { draft?: boolean } }) =>
-    import.meta.env.DEV ? true : !data.draft
-  );
-
-  const owned = new Set((CONFIG.ownedByConsumer ?? []).map(normalizePath));
-
-  return entries
-    // Astro does not de-duplicate injected routes against consumer pages.
-    .filter((entry) => !owned.has(normalizePath(docsHref(entry.id, pathContext()))))
-    .map((entry) => ({
-      // `undefined` (not '') is how a rest param matches the empty path.
-      params: { slug: idToPath(entry.id) || undefined },
-      props: { entry },
-    }));
-}
-
-const { entry } = Astro.props;
-const { Content, headings } = await render(entry);
-
-const tocConfig = entry.data.tableOfContents ?? CONFIG.tableOfContents;
-const showToc = tocConfig !== false;
-const toc = showToc
-  ? buildTocTree(headings, {
-      minLevel: (tocConfig as { minLevel?: number })?.minLevel ?? 2,
-      maxLevel: (tocConfig as { maxLevel?: number })?.maxLevel ?? 3,
-    })
-  : [];
-
-const nav = await docsNav(Astro.url.pathname);
-const splash = entry.data.template === 'splash';
-
-// Trail is [group, ..., page]; a length of one means the page has no section above it.
-const trail = breadcrumbsFor(nav, Astro.url.pathname);
-const crumbs = trail.length > 1 ? trail.map((node) => node.label).join(' › ') : undefined;
-
-// Ancestors only. `crumbs` above keeps the page as well, because a search result row
-// needs the page name to identify itself. The two diverge on purpose.
-const renderedTrail = trail.slice(0, -1).map((node) => ({ label: node.label, href: node.href }));
-
-// Indexed only, never rendered: a page with no `description` still needs a result summary.
-const fallbackSummary = entry.data.description ? undefined : firstParagraph(entry.body);
-
-const { prev, next } = CONFIG.footer.showPrevNext ? prevNextFor(nav, Astro.url.pathname) : {};
-
-// `editUrl` is a base; the content path is appended. The slice is taken at the
-// consumer's own content directory, which is configurable.
-const contentPath = entry.filePath?.split(`${CONFIG.contentDir}/`).pop();
-const editHref =
-  CONFIG.footer.editUrl && contentPath
-    ? `${CONFIG.footer.editUrl.replace(/\/$/, '')}/${contentPath}`
-    : undefined;
-
-// File-shaped (/x/label.md) beside the directory-shaped page; 'index' must match docs-md.ts.
-const markdownHref = CONFIG.routing.markdownTwins
-  ? `${joinPath(import.meta.env.BASE_URL, CONFIG.pathPrefix, idToPath(entry.id) || 'index')}.md`
-  : undefined;
----
-
-<DocsPage
-  title={entry.data.title}
-  description={entry.data.description}
-  nav={nav}
-  toc={toc}
-  showToc={showToc}
-  splash={splash}
->
-  <Prose
-    title={entry.data.title}
-    description={entry.data.description}
-    deprecated={entry.data.deprecated}
-    markdownHref={markdownHref}
-    source={entry.body}
-    crumbs={crumbs}
-    trail={renderedTrail}
-    fallbackSummary={fallbackSummary}
-  >
-    <Content components={mdxComponents} />
-  </Prose>
-  {!splash && <PageFooter prev={prev} next={next} editHref={editHref} text={CONFIG.footer.text} />}
-</DocsPage>

package/dist/runtime/routes/llms-txt.ts

@@ -1,38 +0,0 @@
-/** An index of every page, in the llms.txt convention. */
-import { docsHref } from '@eqtylab/docs/paths';
-import type { APIRoute } from 'astro';
-import { getCollection } from 'astro:content';
-import CONFIG from 'virtual:eqty-docs/config';
-
-export const GET: APIRoute = async (ctx) => {
-  const entries = await getCollection(
-    'docs',
-    ({ data }: { data: { draft?: boolean; noIndex?: boolean } }) => !data.draft && !data.noIndex
-  );
-
-  const paths = {
-    base: import.meta.env.BASE_URL,
-    pathPrefix: CONFIG.pathPrefix,
-  };
-  const origin = (ctx.site ?? new URL(ctx.request.url)).origin;
-
-  const sorted = [...entries].sort((a, b) => a.data.title.localeCompare(b.data.title));
-
-  const lines = [
-    `# ${CONFIG.title}`,
-    '',
-    ...(CONFIG.description ? [`> ${CONFIG.description}`, ''] : []),
-    '## Pages',
-    '',
-    ...sorted.map((entry) => {
-      const href = docsHref(entry.id, paths).replace(/\/$/, '');
-      const suffix = entry.data.description ? `: ${entry.data.description}` : '';
-      return `- [${entry.data.title}](${origin}${href}.md)${suffix}`;
-    }),
-    '',
-  ];
-
-  return new Response(lines.join('\n'), {
-    headers: { 'Content-Type': 'text/plain; charset=utf-8' },
-  });
-};