fix: paper theme search and relative link resolution (#45)

* fix: enable search in paper theme via Cmd+K shortcut

Search component was missing from paper theme. Add it with hidden trigger
button so only keyboard shortcut (Cmd/Ctrl+K) opens the dialog. Refactor
Search props from className to classNames object for flexibility.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* fix: resolve relative links in MDX content to absolute routes

Replace remark-strip-md-extensions with remark-resolve-links that
resolves relative links (./page.mdx, ../dir/page.md) to absolute
routes based on the source file's location. Also strips index/readme
suffixes to match route conventions.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* fix: include reading time in page API for client navigation

Load MDX module in /api/page endpoint to include _readingTime in
frontmatter response, matching SSR behavior in entry-server.tsx.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* fix: address CodeRabbit review comments

- Use lastIndexOf for /content/ to avoid matching outer path directories
- Guard all URI schemes (mailto:, tel:, ftp:, etc.) not just http(s)
- Remove duplicate Search mount from ApiLayout — theme Layouts own search

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: rsbh

examples/versioned/content/dev/api.mdx

@@ -6,3 +6,8 @@ order: 2
 # Dev API notes — latest
 
 Latest `/dev/api`.
+
+- [Dev Home](./index.mdx)
+- [Docs Guide](../docs/guide.mdx)
+- [Docs Home](../docs/index.mdx)
+- [Guide with hash](../docs/guide.mdx#some-section)

examples/versioned/content/dev/index.mdx

@@ -6,3 +6,7 @@ order: 1
 # Dev — latest
 
 Latest `/dev`.
+
+- [API Notes](./api.mdx)
+- [Docs Home](../docs/index.mdx)
+- [Docs Guide](../docs/guide.mdx)

examples/versioned/content/docs/guide.mdx

@@ -6,3 +6,7 @@ order: 2
 # Guide — latest docs
 
 Latest `/docs/guide`.
+
+- [Docs Home](./index.mdx)
+- [Dev API](../dev/api.mdx)
+- [Dev Home](../dev/index.mdx)

examples/versioned/content/docs/index.mdx

@@ -8,6 +8,10 @@ order: 1
 
 This is `/docs` on latest (3.0).
 
+## Links
+
+- [Guide](./guide.mdx)
+
 ## Getting Started
 
 Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.

packages/chronicle/src/components/ui/search.tsx

@@ -13,10 +13,10 @@ import { usePageContext } from '@/lib/page-context';
 import styles from './search.module.css';
 
 interface SearchProps {
-  className?: string;
+  classNames?: { trigger?: string };
 }
 
-export function Search({ className }: SearchProps) {
+export function Search({ classNames }: SearchProps) {
   const [open, setOpen] = useState(false);
   const navigate = useNavigate();
   const { version } = usePageContext();
@@ -60,7 +60,7 @@ export function Search({ className }: SearchProps) {
         aria-label='Search'
         title='Search (Ctrl/⌘K)'
         onClick={() => setOpen(true)}
-        className={className}
+        className={classNames?.trigger}
       >
         <MagnifyingGlassIcon width={16} height={16} />
       </IconButton>

packages/chronicle/src/lib/remark-resolve-links.ts

@@ -0,0 +1,32 @@
+import path from 'node:path'
+import { visit } from 'unist-util-visit'
+import type { Plugin } from 'unified'
+import type { Link } from 'mdast'
+
+const remarkResolveLinks: Plugin = () => {
+  return (tree, file) => {
+    const filePath = file.path
+    if (!filePath) return
+
+    const contentIdx = filePath.lastIndexOf('/content/')
+    if (contentIdx === -1) return
+
+    const relative = filePath.slice(contentIdx + '/content/'.length)
+    const dir = path.posix.dirname(relative)
+
+    visit(tree, 'link', (node: Link) => {
+      if (!node.url) return
+      if (/^[a-z][a-z0-9+\-.]*:/i.test(node.url)) return
+      if (node.url.startsWith('#')) return
+      if (node.url.startsWith('/')) return
+
+      const [rawPath, hash] = node.url.split('#')
+      const stripped = rawPath.replace(/\.mdx?$/, '')
+      let resolved = path.posix.normalize(path.posix.join(dir, stripped))
+      resolved = resolved.replace(/\/(index|readme)$/i, '') || '.'
+      node.url = `/${resolved}${hash ? `#${hash}` : ''}`
+    })
+  }
+}
+
+export default remarkResolveLinks

packages/chronicle/src/lib/remark-strip-md-extensions.ts

@@ -1,6 +1,5 @@
 import { cx } from 'class-variance-authority';
 import type { ReactNode } from 'react';
-import { Search } from '@/components/ui/search';
 import { buildApiPageTree } from '@/lib/api-routes';
 import { usePageContext } from '@/lib/page-context';
 import { getTheme } from '@/themes/registry';
@@ -26,7 +25,6 @@ export function ApiLayout({ children }: ApiLayoutProps) {
         content: styles.content
       }}
     >
-      <Search className={styles.hiddenSearch} />
       {children}
     </Layout>
   );

packages/chronicle/src/pages/ApiLayout.tsx

@@ -1,5 +1,5 @@
 import { defineHandler, HTTPError } from 'nitro';
-import { getPage, getPageNav, extractFrontmatter, getRelativePath, getOriginalPath } from '@/lib/source';
+import { getPage, getPageNav, extractFrontmatter, getRelativePath, getOriginalPath, loadPageModule } from '@/lib/source';
 
 export default defineHandler(async event => {
   const slugParam = event.url.searchParams.get('slug') ?? '';
@@ -11,11 +11,17 @@ export default defineHandler(async event => {
   }
 
   const nav = await getPageNav(slug);
+  const originalPath = getOriginalPath(page);
+  const relativePath = getRelativePath(page);
+  const mdxModule = (originalPath || relativePath) ? await loadPageModule(originalPath || relativePath) : null;
 
   return {
-    frontmatter: extractFrontmatter(page, slug[slug.length - 1]),
-    relativePath: getRelativePath(page),
-    originalPath: getOriginalPath(page),
+    frontmatter: {
+      ...extractFrontmatter(page, slug[slug.length - 1]),
+      _readingTime: mdxModule?._readingTime,
+    },
+    relativePath,
+    originalPath,
     prev: nav.prev,
     next: nav.next,
   };

packages/chronicle/src/server/api/page.ts

@@ -7,7 +7,7 @@ import fs from 'node:fs/promises';
 import path from 'node:path';
 import remarkDirective from 'remark-directive';
 import { type InlineConfig } from 'vite';
-import remarkStripMdExtensions from '../lib/remark-strip-md-extensions';
+import remarkResolveLinks from '../lib/remark-resolve-links';
 import remarkReadingTime from 'remark-reading-time';
 import remarkUnusedDirectives from '../lib/remark-unused-directives';
 
@@ -77,7 +77,7 @@ export async function createViteConfig(
                 },
               }],
               remarkUnusedDirectives,
-              remarkStripMdExtensions,
+              remarkResolveLinks,
               remarkMdxMermaid,
               remarkReadingTime,
             ],