svelte-docsmith 0.4.0 → 0.5.1

package/dist/config.d.ts

@@ -29,6 +29,13 @@ export type DocsmithConfig = {
     url?: string;
     /** Default social-share image (absolute URL, or a path resolved against `url`). */
     ogImage?: string;
+    /**
+     * Base URL for the "Edit this page" link, pointing at the directory that maps
+     * to your app's working directory in the repo, e.g.
+     * `https://github.com/you/repo/edit/main/apps/docs`. DocsShell appends each
+     * page's source path. Omit to hide the edit link.
+     */
+    editUrl?: string;
     /** Optional GitHub URL; renders a link in the header when set. */
     github?: string;
     /** Optional version string, shown in the header (e.g. your library version). */
@@ -68,6 +75,10 @@ export type DocsContentItem = {
     section?: string;
     order?: number;
     description?: string;
+    /** Source file path relative to the app cwd, for the "Edit this page" link. */
+    sourcePath?: string;
+    /** Last git commit date (ISO) for the page's source file. */
+    lastUpdated?: string;
     /**
      * The page's `h2`/`h3` headings, extracted at build time by the `docsmith()`
      * vite plugin, so `DocsShell` can render the in-page TOC server-side. The
@@ -96,6 +107,22 @@ export type SearchDoc = {
     /** Plain-text body: prose and headings, code and markup removed. */
     text: string;
 };
+/**
+ * One page's record for LLM-facing output, emitted at build time by the
+ * `docsmith()` vite plugin as the `svelte-docsmith/llms` virtual module. Feeds
+ * `generateLlmsTxt` (an index) and `generateLlmsFullTxt` (the full corpus).
+ */
+export type LlmsDoc = {
+    path: string;
+    title: string;
+    section?: string;
+    /** Sidebar order within the section, so LLM output follows reading order. */
+    order?: number;
+    description?: string;
+    /** The page's markdown body (frontmatter and `<script>`/`<style>` removed,
+     *  headings and code kept), with the title prepended as an `h1`. */
+    content: string;
+};
 /** A single sidebar link. */
 export type NavItem = {
     title: string;

package/dist/config.js

@@ -10,7 +10,15 @@ export function defineConfig(config) {
     if (typeof config.title !== 'string' || config.title.trim() === '') {
         throw new Error('[svelte-docsmith] config.title is required — the site title shown in the sidebar header.');
     }
-    for (const key of ['github', 'version', 'logo', 'description', 'url', 'ogImage']) {
+    for (const key of [
+        'github',
+        'version',
+        'logo',
+        'description',
+        'url',
+        'ogImage',
+        'editUrl'
+    ]) {
         if (config[key] !== undefined && typeof config[key] !== 'string') {
             throw new Error(`[svelte-docsmith] config.${key} must be a string when set.`);
         }

package/dist/generate-llms.d.ts

@@ -0,0 +1,31 @@
+import type { LlmsDoc } from './config.js';
+/** Site-level info for the LLM files: title, optional description, and origin. */
+export type LlmsSite = {
+    title: string;
+    description?: string;
+    /** Absolute origin, e.g. `https://my-docs.dev`, used to make links absolute. */
+    origin?: string;
+};
+/**
+ * Build an [llms.txt](https://llmstxt.org) index: the site title and
+ * description, then a sectioned list of links to each page. Wire it into a
+ * `src/routes/llms.txt/+server.ts` over the `svelte-docsmith/llms` module.
+ *
+ * ```ts
+ * import { docs } from 'svelte-docsmith/llms';
+ * import { generateLlmsTxt } from 'svelte-docsmith';
+ *
+ * export const prerender = true;
+ * export function GET() {
+ *   const body = generateLlmsTxt({ title: 'My Docs', origin: 'https://my-docs.dev' }, docs);
+ *   return new Response(body, { headers: { 'content-type': 'text/plain; charset=utf-8' } });
+ * }
+ * ```
+ */
+export declare function generateLlmsTxt(site: LlmsSite, docs: LlmsDoc[]): string;
+/**
+ * Build `llms-full.txt`: the site header followed by the full markdown of every
+ * page, so an LLM can ingest the entire documentation in one request. Same
+ * wiring as {@link generateLlmsTxt}, at `src/routes/llms-full.txt/+server.ts`.
+ */
+export declare function generateLlmsFullTxt(site: LlmsSite, docs: LlmsDoc[]): string;

package/dist/generate-llms.js

@@ -0,0 +1,63 @@
+/**
+ * Group docs by section and put both the sections and the docs within them in
+ * sidebar reading order: items by their `order`, sections by the smallest
+ * `order` they contain. Mirrors `navFromContent` so the LLM index matches the
+ * on-page navigation instead of falling back to path-alphabetical order.
+ */
+function bySection(docs) {
+    const groups = new Map();
+    for (const doc of docs) {
+        const section = doc.section ?? 'Docs';
+        const order = doc.order ?? 0;
+        const group = groups.get(section) ?? { minOrder: Infinity, items: [] };
+        group.items.push(doc);
+        group.minOrder = Math.min(group.minOrder, order);
+        groups.set(section, group);
+    }
+    return [...groups.entries()]
+        .sort((a, b) => a[1].minOrder - b[1].minOrder)
+        .map(([section, group]) => [
+        section,
+        group.items.sort((a, b) => (a.order ?? 0) - (b.order ?? 0))
+    ]);
+}
+/**
+ * Build an [llms.txt](https://llmstxt.org) index: the site title and
+ * description, then a sectioned list of links to each page. Wire it into a
+ * `src/routes/llms.txt/+server.ts` over the `svelte-docsmith/llms` module.
+ *
+ * ```ts
+ * import { docs } from 'svelte-docsmith/llms';
+ * import { generateLlmsTxt } from 'svelte-docsmith';
+ *
+ * export const prerender = true;
+ * export function GET() {
+ *   const body = generateLlmsTxt({ title: 'My Docs', origin: 'https://my-docs.dev' }, docs);
+ *   return new Response(body, { headers: { 'content-type': 'text/plain; charset=utf-8' } });
+ * }
+ * ```
+ */
+export function generateLlmsTxt(site, docs) {
+    const base = (site.origin ?? '').replace(/\/$/, '');
+    const out = [`# ${site.title}`];
+    if (site.description)
+        out.push('', `> ${site.description}`);
+    for (const [section, items] of bySection(docs)) {
+        out.push('', `## ${section}`, '');
+        for (const doc of items) {
+            const suffix = doc.description ? `: ${doc.description}` : '';
+            out.push(`- [${doc.title}](${base}${doc.path})${suffix}`);
+        }
+    }
+    return out.join('\n') + '\n';
+}
+/**
+ * Build `llms-full.txt`: the site header followed by the full markdown of every
+ * page, so an LLM can ingest the entire documentation in one request. Same
+ * wiring as {@link generateLlmsTxt}, at `src/routes/llms-full.txt/+server.ts`.
+ */
+export function generateLlmsFullTxt(site, docs) {
+    const header = site.description ? `# ${site.title}\n\n> ${site.description}` : `# ${site.title}`;
+    const ordered = bySection(docs).flatMap(([, items]) => items);
+    return [header, ...ordered.map((doc) => doc.content.trim())].join('\n\n') + '\n';
+}

package/dist/index.d.ts

@@ -18,5 +18,7 @@ export { default as FileTree } from './ui/file-tree.svelte';
 export { default as FileTreeItem } from './ui/file-tree-item.svelte';
 export { default as PropsTable } from './ui/props-table.svelte';
 export { default as Prop } from './ui/prop.svelte';
-export { defineConfig, type DocsmithConfig, type DocsContentItem, type SearchDoc } from './config.js';
+export { defineConfig, type DocsmithConfig, type DocsContentItem, type SearchDoc, type LlmsDoc } from './config.js';
 export { createSearchEngine, type SearchEngine, type SearchResult } from './search/create-search.js';
+export { generateSitemap, type SitemapEntry } from './sitemap.js';
+export { generateLlmsTxt, generateLlmsFullTxt, type LlmsSite } from './generate-llms.js';

package/dist/index.js

@@ -28,3 +28,8 @@ export { defineConfig } from './config.js';
 // Search engine (framework-agnostic; for building a custom search UI over the
 // generated `svelte-docsmith/search` index)
 export { createSearchEngine } from './search/create-search.js';
+// Sitemap (framework-agnostic; wire into a `sitemap.xml/+server.ts`)
+export { generateSitemap } from './sitemap.js';
+// llms.txt (framework-agnostic; wire into `llms.txt/+server.ts` and
+// `llms-full.txt/+server.ts` over the generated `svelte-docsmith/llms` index)
+export { generateLlmsTxt, generateLlmsFullTxt } from './generate-llms.js';

package/dist/llms.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `svelte-docsmith/llms` — the generated LLM content index.
+ *
+ * At build time the `docsmith()` Vite plugin (in `vite.config.ts`) intercepts
+ * this import and replaces it with your doc pages' titles, sections, and full
+ * markdown bodies. This file is only the fallback that runs when the plugin is
+ * missing — it exists so the import type-checks and fails with a clear message
+ * instead of a mystery.
+ */
+import type { LlmsDoc } from './config.js';
+export declare const docs: LlmsDoc[];

package/dist/llms.js

@@ -0,0 +1,4 @@
+export const docs = [];
+throw new Error("[svelte-docsmith] 'svelte-docsmith/llms' requires the docsmith() plugin. " +
+    "Add it to your vite.config: import { docsmith } from 'svelte-docsmith/vite'; " +
+    'plugins: [docsmith(), tailwindcss(), sveltekit()]');

package/dist/normalize-path.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Strip a trailing slash so route matching is consistent regardless of the
+ * consumer's SvelteKit `trailingSlash` setting: `/docs/intro/` and `/docs/intro`
+ * resolve to the same content entry. The root stays `/`.
+ */
+export declare function normalizePath(pathname: string): string;

package/dist/normalize-path.js

@@ -0,0 +1,8 @@
+/**
+ * Strip a trailing slash so route matching is consistent regardless of the
+ * consumer's SvelteKit `trailingSlash` setting: `/docs/intro/` and `/docs/intro`
+ * resolve to the same content entry. The root stays `/`.
+ */
+export function normalizePath(pathname) {
+    return pathname.replace(/\/+$/, '') || '/';
+}

package/dist/sitemap.d.ts

@@ -0,0 +1,27 @@
+/** One entry in a sitemap: a page path (joined to the origin) and optional last-modified date. */
+export type SitemapEntry = {
+    /** Absolute path, e.g. `/docs/intro`. Joined to the origin. */
+    path: string;
+    /** Last-modified date; an ISO string or `YYYY-MM-DD`. Only the date is emitted. */
+    lastmod?: string;
+};
+/**
+ * Build a sitemap.xml body from a list of pages. Framework-agnostic: wire it
+ * into a SvelteKit `src/routes/sitemap.xml/+server.ts` that maps the generated
+ * `svelte-docsmith/content` index (plus any non-doc routes) into entries.
+ *
+ * ```ts
+ * import { docs } from 'svelte-docsmith/content';
+ * import { generateSitemap } from 'svelte-docsmith';
+ *
+ * export const prerender = true;
+ * export function GET() {
+ *   const body = generateSitemap('https://my-docs.dev', [
+ *     { path: '/' },
+ *     ...docs.map((d) => ({ path: d.path, lastmod: d.lastUpdated }))
+ *   ]);
+ *   return new Response(body, { headers: { 'content-type': 'application/xml' } });
+ * }
+ * ```
+ */
+export declare function generateSitemap(origin: string, entries: SitemapEntry[]): string;

package/dist/sitemap.js

@@ -0,0 +1,44 @@
+const escapeXml = (s) => s.replace(/[&<>'"]/g, (c) => {
+    switch (c) {
+        case '&':
+            return '&amp;';
+        case '<':
+            return '&lt;';
+        case '>':
+            return '&gt;';
+        case "'":
+            return '&apos;';
+        default:
+            return '&quot;';
+    }
+});
+/**
+ * Build a sitemap.xml body from a list of pages. Framework-agnostic: wire it
+ * into a SvelteKit `src/routes/sitemap.xml/+server.ts` that maps the generated
+ * `svelte-docsmith/content` index (plus any non-doc routes) into entries.
+ *
+ * ```ts
+ * import { docs } from 'svelte-docsmith/content';
+ * import { generateSitemap } from 'svelte-docsmith';
+ *
+ * export const prerender = true;
+ * export function GET() {
+ *   const body = generateSitemap('https://my-docs.dev', [
+ *     { path: '/' },
+ *     ...docs.map((d) => ({ path: d.path, lastmod: d.lastUpdated }))
+ *   ]);
+ *   return new Response(body, { headers: { 'content-type': 'application/xml' } });
+ * }
+ * ```
+ */
+export function generateSitemap(origin, entries) {
+    const base = origin.replace(/\/$/, '');
+    const urls = entries
+        .map(({ path, lastmod }) => {
+        const loc = `\t\t<loc>${escapeXml(base + path)}</loc>`;
+        const mod = lastmod ? `\n\t\t<lastmod>${lastmod.slice(0, 10)}</lastmod>` : '';
+        return `\t<url>\n${loc}${mod}\n\t</url>`;
+    })
+        .join('\n');
+    return `<?xml version="1.0" encoding="UTF-8"?>\n<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">\n${urls}\n</urlset>\n`;
+}

package/dist/ui/layouts/copy-page-menu.svelte

@@ -0,0 +1,113 @@
+<script lang="ts">
+	import { browser } from '$app/environment';
+	import { Button } from '../shadcn/button/index.js';
+	import * as DropdownMenu from '../shadcn/dropdown-menu/index.js';
+	import Check from '@lucide/svelte/icons/check';
+	import ChevronDown from '@lucide/svelte/icons/chevron-down';
+	import Copy from '@lucide/svelte/icons/copy';
+	import FileText from '@lucide/svelte/icons/file-text';
+	import ArrowUpRight from '@lucide/svelte/icons/arrow-up-right';
+
+	const {
+		path,
+		origin = ''
+	}: {
+		/** The current page's normalized pathname, e.g. `/docs/intro`. */
+		path: string;
+		/** Absolute site origin for the AI deep links; falls back to `location.origin`. */
+		origin?: string;
+	} = $props();
+
+	// Convention: each page's markdown lives at `<path>.md`, served by the
+	// consumer's catch-all endpoint over the `svelte-docsmith/llms` index.
+	const mdHref = $derived(`${path}.md`);
+	const base = $derived((origin || (browser ? location.origin : '')).replace(/\/$/, ''));
+	const absoluteMd = $derived(`${base}${mdHref}`);
+	const prompt = $derived(`Read ${absoluteMd} so I can ask questions about this page.`);
+	const chatgptHref = $derived(`https://chatgpt.com/?hints=search&q=${encodeURIComponent(prompt)}`);
+	const claudeHref = $derived(`https://claude.ai/new?q=${encodeURIComponent(prompt)}`);
+
+	let copied = $state(false);
+	let timer: ReturnType<typeof setTimeout>;
+
+	async function copyPage() {
+		try {
+			const res = await fetch(mdHref);
+			if (!res.ok) throw new Error(`${res.status} ${res.statusText}`);
+			const text = await res.text();
+			// `navigator.clipboard` is undefined on insecure origins and can reject
+			// without permission; fail quietly so the button never throws.
+			await navigator.clipboard.writeText(text);
+			copied = true;
+			clearTimeout(timer);
+			timer = setTimeout(() => (copied = false), 1500);
+		} catch (error) {
+			console.warn('[svelte-docsmith] copy page failed', error);
+		}
+	}
+</script>
+
+<div class="border-border bg-background inline-flex items-center rounded-md border shadow-xs">
+	<Button
+		variant="ghost"
+		size="sm"
+		onclick={copyPage}
+		class="rounded-r-none"
+		aria-label="Copy this page as Markdown"
+	>
+		{#if copied}
+			<Check class="text-primary" />
+			Copied
+		{:else}
+			<Copy />
+			Copy page
+		{/if}
+	</Button>
+	<div class="bg-border h-5 w-px" aria-hidden="true"></div>
+	<DropdownMenu.Root>
+		<DropdownMenu.Trigger>
+			{#snippet child({ props })}
+				<Button
+					variant="ghost"
+					size="sm"
+					class="rounded-l-none px-2"
+					aria-label="More page actions"
+					{...props}
+				>
+					<ChevronDown />
+				</Button>
+			{/snippet}
+		</DropdownMenu.Trigger>
+		<DropdownMenu.Content align="end" class="w-56">
+			<DropdownMenu.Item onSelect={copyPage}>
+				<Copy />
+				Copy page
+			</DropdownMenu.Item>
+			<DropdownMenu.Item>
+				{#snippet child({ props })}
+					<a href={mdHref} target="_blank" rel="noopener" {...props}>
+						<FileText />
+						View as Markdown
+					</a>
+				{/snippet}
+			</DropdownMenu.Item>
+			<DropdownMenu.Separator />
+			<DropdownMenu.Item>
+				{#snippet child({ props })}
+					<a href={chatgptHref} target="_blank" rel="noopener" {...props}>
+						<ArrowUpRight />
+						Open in ChatGPT
+					</a>
+				{/snippet}
+			</DropdownMenu.Item>
+			<DropdownMenu.Item>
+				{#snippet child({ props })}
+					<a href={claudeHref} target="_blank" rel="noopener" {...props}>
+						<ArrowUpRight />
+						Open in Claude
+					</a>
+				{/snippet}
+			</DropdownMenu.Item>
+		</DropdownMenu.Content>
+	</DropdownMenu.Root>
+</div>

package/dist/ui/layouts/copy-page-menu.svelte.d.ts

@@ -0,0 +1,9 @@
+type $$ComponentProps = {
+    /** The current page's normalized pathname, e.g. `/docs/intro`. */
+    path: string;
+    /** Absolute site origin for the AI deep links; falls back to `location.origin`. */
+    origin?: string;
+};
+declare const CopyPageMenu: import("svelte").Component<$$ComponentProps, {}, "">;
+type CopyPageMenu = ReturnType<typeof CopyPageMenu>;
+export default CopyPageMenu;

package/dist/ui/layouts/docs-header.svelte

@@ -49,7 +49,7 @@
 
 		<div class="ml-auto flex items-center gap-2">
 			{#if config.nav?.length}
-				<nav class="mr-1 flex items-center gap-1">
+				<nav aria-label="Main" class="mr-1 flex items-center gap-1">
 					{#each config.nav as link (link.href)}
 						<a
 							href={link.href}

package/dist/ui/layouts/docs-mobile-header.svelte

@@ -79,7 +79,7 @@
 				</div>
 				<ScrollArea class="my-4 h-[calc(100vh-8rem)] pb-10 pl-2">
 					{#if config.nav?.length}
-						<nav class="flex flex-col gap-0.5 px-5 pb-1">
+						<nav aria-label="Main" class="flex flex-col gap-0.5 px-5 pb-1">
 							{#each config.nav as link (link.href)}
 								<a
 									href={link.href}

package/dist/ui/layouts/docs-shell.svelte

@@ -9,6 +9,7 @@
 	} from '../../config.js';
 	import { createToc } from '../../toc/index.js';
 	import { createSearchState } from '../../search/context.svelte.js';
+	import { normalizePath } from '../../normalize-path.js';
 	import Search from '../search.svelte';
 	import BackgroundPattern from '../background-pattern.svelte';
 	import ThemeProvider from '../theme-provider.svelte';
@@ -18,7 +19,9 @@
 	import DocsSidebar from './docs-sidebar.svelte';
 	import PrevNextNav from './prev-next-nav.svelte';
 	import Breadcrumbs, { type Crumb } from './breadcrumbs.svelte';
+	import CopyPageMenu from './copy-page-menu.svelte';
 	import SeoHead from './seo-head.svelte';
+	import SquarePen from '@lucide/svelte/icons/square-pen';
 	import TableOfContents from '../table-of-contents.svelte';
 	import type { Snippet } from 'svelte';
 
@@ -32,6 +35,7 @@
 		search,
 		seo,
 		pattern = false,
+		copyPage = false,
 		layout = 'docs'
 	}: {
 		config: DocsmithConfig;
@@ -57,6 +61,12 @@
 		footer?: Snippet;
 		/** Render the decorative grid-and-glow page background. */
 		pattern?: boolean;
+		/**
+		 * Show the "Copy page" split button on doc pages: copy the page as
+		 * Markdown, view the raw `.md`, or open it in ChatGPT / Claude. Requires a
+		 * catch-all `<path>.md` endpoint over the `svelte-docsmith/llms` index.
+		 */
+		copyPage?: boolean;
 		/**
 		 * `docs` (default): the three-column shell — sidebar, content, in-page TOC.
 		 * `page`: full-bleed content with the same header/footer/background but no
@@ -75,12 +85,34 @@
 
 	const nav = $derived(navFromContent(content));
 
-	// The content entry for the current route drives the SEO title/description.
-	const currentEntry = $derived(content.find((item) => item.path === page.url.pathname));
+	// Match content by a trailing-slash-normalized path, so `/docs/intro/` and
+	// `/docs/intro` resolve to the same page regardless of the app's trailingSlash.
+	const pathname = $derived(normalizePath(page.url.pathname));
+
+	// The content entry for the current route drives the SEO title/description,
+	// the "Edit this page" link, and the "Last updated" stamp.
+	const currentEntry = $derived(content.find((item) => item.path === pathname));
+
+	const editHref = $derived(
+		config.editUrl && currentEntry?.sourcePath
+			? config.editUrl.replace(/\/$/, '') + '/' + currentEntry.sourcePath
+			: undefined
+	);
+	const lastUpdatedLabel = $derived.by(() => {
+		const iso = currentEntry?.lastUpdated;
+		if (!iso) return undefined;
+		const d = new Date(iso);
+		return Number.isNaN(d.getTime())
+			? undefined
+			: new Intl.DateTimeFormat('en', { year: 'numeric', month: 'short', day: 'numeric' }).format(
+					d
+				);
+	});
+	const showFooterMeta = $derived(Boolean(editHref || lastUpdatedLabel));
 
 	// Ordered flat page list drives the prev/next links.
 	const flatNav = $derived(nav.flatMap((group) => group.items));
-	const pageIndex = $derived(flatNav.findIndex((item) => item.url === page.url.pathname));
+	const pageIndex = $derived(flatNav.findIndex((item) => item.url === pathname));
 	const prev = $derived(pageIndex > 0 ? flatNav[pageIndex - 1] : undefined);
 	const next = $derived(
 		pageIndex >= 0 && pageIndex < flatNav.length - 1 ? flatNav[pageIndex + 1] : undefined
@@ -89,7 +121,7 @@
 
 	// Breadcrumb trail: the current page's sidebar group, then the page itself.
 	const currentGroup = $derived(
-		nav.find((group) => group.items.some((item) => item.url === page.url.pathname))
+		nav.find((group) => group.items.some((item) => item.url === pathname))
 	);
 	const breadcrumbs = $derived.by(() => {
 		const crumbs: Crumb[] = [];
@@ -109,7 +141,7 @@
 	// Server-rendered TOC (headings extracted at build time into the content
 	// index) so the list is present on first paint. Once the client engine has
 	// scanned the DOM, its items take over (scroll-spy + edge-case accuracy).
-	const pageToc = $derived(content.find((item) => item.path === page.url.pathname)?.toc ?? []);
+	const pageToc = $derived(content.find((item) => item.path === pathname)?.toc ?? []);
 	const tocItems = $derived(toc.items.length ? toc.items : pageToc);
 </script>
 
@@ -120,6 +152,14 @@
 />
 
 <div class="relative isolate flex min-h-screen flex-col">
+	<!-- Keyboard skip link: first focusable element, visible only on focus. -->
+	<a
+		href="#main-content"
+		class="bg-primary text-primary-foreground focus-visible:ring-ring sr-only z-50 rounded-md px-3 py-2 text-sm font-medium focus-visible:not-sr-only focus-visible:absolute focus-visible:top-3 focus-visible:left-3 focus-visible:ring-2"
+	>
+		Skip to content
+	</a>
+
 	<!-- Owns light/dark for the whole app — consumers never wire mode-watcher. -->
 	<ThemeProvider />
 
@@ -138,7 +178,7 @@
 	{#if layout === 'page'}
 		<DocsMobileHeader {config} {logo} {actions} />
 
-		<main class="flex-1">
+		<main id="main-content" tabindex="-1" class="flex-1">
 			{@render children()}
 		</main>
 	{:else}
@@ -155,10 +195,44 @@
 		<div class="mx-auto flex w-full max-w-7xl flex-1 gap-12 px-4 md:px-6 lg:px-8 lg:pt-10">
 			<DocsSidebar {nav} />
 
-			<main bind:this={contentEl} class="min-w-0 flex-1 py-6 lg:py-0">
-				<Breadcrumbs items={breadcrumbs} />
+			<main
+				bind:this={contentEl}
+				id="main-content"
+				tabindex="-1"
+				class="min-w-0 flex-1 py-6 lg:py-0"
+			>
+				<div class="flex items-start justify-between gap-4">
+					<Breadcrumbs items={breadcrumbs} />
+					{#if copyPage && currentEntry}
+						<div class="shrink-0">
+							<CopyPageMenu path={pathname} origin={config.url ?? ''} />
+						</div>
+					{/if}
+				</div>
 				{@render children()}
-				<PrevNextNav {prev} {next} />
+
+				{#if showFooterMeta}
+					<div
+						class="text-muted-foreground border-border mt-10 flex flex-wrap items-center gap-3 border-t pt-6 text-sm"
+					>
+						{#if editHref}
+							<a
+								href={editHref}
+								target="_blank"
+								rel="noopener noreferrer"
+								class="hover:text-foreground inline-flex items-center gap-1.5 transition-colors"
+							>
+								<SquarePen class="size-4" />
+								Edit this page
+							</a>
+						{/if}
+						{#if lastUpdatedLabel}
+							<span class="ml-auto">Last updated: {lastUpdatedLabel}</span>
+						{/if}
+					</div>
+				{/if}
+
+				<PrevNextNav {prev} {next} bordered={!showFooterMeta} />
 			</main>
 
 			<!-- Reserve the TOC column so its content filling in after hydration

package/dist/ui/layouts/docs-shell.svelte.d.ts

@@ -27,6 +27,12 @@ type $$ComponentProps = {
     footer?: Snippet;
     /** Render the decorative grid-and-glow page background. */
     pattern?: boolean;
+    /**
+     * Show the "Copy page" split button on doc pages: copy the page as
+     * Markdown, view the raw `.md`, or open it in ChatGPT / Claude. Requires a
+     * catch-all `<path>.md` endpoint over the `svelte-docsmith/llms` index.
+     */
+    copyPage?: boolean;
     /**
      * `docs` (default): the three-column shell — sidebar, content, in-page TOC.
      * `page`: full-bleed content with the same header/footer/background but no

package/dist/ui/layouts/docs-sidebar.svelte

@@ -1,6 +1,7 @@
 <script lang="ts">
 	import { page } from '$app/state';
 	import { cn } from '../../shadcn.js';
+	import { normalizePath } from '../../normalize-path.js';
 	import type { NavGroup } from '../../config.js';
 
 	const { nav, class: className = '' }: { nav: NavGroup[]; class?: string } = $props();
@@ -8,7 +9,7 @@
 
 <aside class={cn('sticky top-24 hidden h-screen w-56 shrink-0 bg-transparent lg:block', className)}>
 	<div class="max-h-[calc(100vh-10rem)] overflow-y-auto px-4">
-		<nav class="space-y-6">
+		<nav aria-label="Documentation" class="space-y-6">
 			{#each nav as group (group.title)}
 				<div class="space-y-3">
 					<h4 class="text-foreground px-2 text-sm font-semibold">{group.title}</h4>
@@ -19,7 +20,7 @@
 									href={item.url}
 									class={cn(
 										'hover:text-primary hover:bg-primary/20 block rounded-md px-2 py-1.5 text-sm transition-colors',
-										page.url.pathname === item.url
+										normalizePath(page.url.pathname) === item.url
 											? 'text-primary bg-primary/20 font-medium'
 											: 'text-muted-foreground'
 									)}

package/dist/ui/layouts/prev-next-nav.svelte

@@ -1,11 +1,18 @@
 <script lang="ts">
 	import type { NavItem } from '../../config.js';
 
-	const { prev, next }: { prev?: NavItem; next?: NavItem } = $props();
+	const {
+		prev,
+		next,
+		bordered = true
+	}: { prev?: NavItem; next?: NavItem; bordered?: boolean } = $props();
 </script>
 
 {#if prev || next}
-	<nav class="border-border mt-8 flex justify-between gap-4 border-t pt-8">
+	<nav
+		aria-label="Pagination"
+		class="flex justify-between gap-4 {bordered ? 'border-border mt-8 border-t pt-8' : 'mt-6'}"
+	>
 		{#if prev}
 			<a
 				href={prev.url}