@raystack/chronicle 0.7.0 → 0.7.2

package/dist/cli/index.js

@@ -46,21 +46,97 @@ var __export = (target, all) => {
 var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
-// src/lib/remark-strip-md-extensions.ts
+// src/lib/remark-resolve-images.ts
+import path4 from "node:path";
 import { visit } from "unist-util-visit";
-var remarkStripMdExtensions = () => {
-  return (tree) => {
-    visit(tree, "link", (node) => {
+function resolveUrl(src, dir) {
+  if (/^[a-z][a-z0-9+\-.]*:/i.test(src))
+    return src;
+  if (src.startsWith("//"))
+    return src;
+  if (src.startsWith("#"))
+    return src;
+  if (src.startsWith("/_content/"))
+    return src;
+  if (src.startsWith("/"))
+    return `/_content${src}`;
+  return `/_content/${path4.posix.normalize(path4.posix.join(dir, src))}`;
+}
+var remarkResolveImages = () => {
+  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 = path4.posix.dirname(relative);
+    visit(tree, "image", (node) => {
+      if (!node.url)
+        return;
+      node.url = resolveUrl(node.url, dir);
+    });
+    visit(tree, "html", (node) => {
+      node.value = node.value.replace(/(<img\b[^>]*\bsrc=["'])([^"']+)(["'])/gi, (_, before, src, after) => `${before}${resolveUrl(src, dir)}${after}`);
+    });
+    visit(tree, (node) => {
+      if (node.type !== "mdxJsxFlowElement" && node.type !== "mdxJsxTextElement")
+        return;
+      const jsx = node;
+      if (jsx.name !== "img")
+        return;
+      const srcAttr = jsx.attributes.find((a) => a.type === "mdxJsxAttribute" && a.name === "src");
+      if (!srcAttr?.value || typeof srcAttr.value !== "string")
+        return;
+      srcAttr.value = resolveUrl(srcAttr.value, dir);
+    });
+    visit(tree, "element", (node) => {
+      if (node.tagName !== "img")
+        return;
+      const src = node.properties?.src;
+      if (typeof src !== "string")
+        return;
+      node.properties.src = resolveUrl(src, dir);
+    });
+  };
+}, remark_resolve_images_default;
+var init_remark_resolve_images = __esm(() => {
+  remark_resolve_images_default = remarkResolveImages;
+});
+
+// src/lib/remark-resolve-links.ts
+import path5 from "node:path";
+import { visit as visit2 } from "unist-util-visit";
+var remarkResolveLinks = () => {
+  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 = path5.posix.dirname(relative);
+    visit2(tree, "link", (node) => {
       if (!node.url)
         return;
-      if (node.url.startsWith("http://") || node.url.startsWith("https://"))
+      if (/^[a-z][a-z0-9+\-.]*:/i.test(node.url))
         return;
-      node.url = node.url.replace(/\.mdx?(#|$)/, "$1");
+      if (node.url.startsWith("#"))
+        return;
+      if (node.url.startsWith("/"))
+        return;
+      const [rawPath, hash] = node.url.split("#");
+      const stripped = rawPath.replace(/\.mdx?$/, "");
+      let resolved = path5.posix.normalize(path5.posix.join(dir, stripped));
+      resolved = resolved.replace(/\/(index|readme)$/i, "") || ".";
+      node.url = `/${resolved}${hash ? `#${hash}` : ""}`;
     });
   };
-}, remark_strip_md_extensions_default;
-var init_remark_strip_md_extensions = __esm(() => {
-  remark_strip_md_extensions_default = remarkStripMdExtensions;
+}, remark_resolve_links_default;
+var init_remark_resolve_links = __esm(() => {
+  remark_resolve_links_default = remarkResolveLinks;
 });
 
 // ../../node_modules/.bun/reading-time@1.5.0/node_modules/reading-time/lib/reading-time.js
@@ -181,13 +257,13 @@ var require_reading_time2 = __commonJS((exports, module) => {
 });
 
 // ../../node_modules/.bun/remark-reading-time@2.1.0/node_modules/remark-reading-time/index.js
-import { visit as visit2 } from "unist-util-visit";
+import { visit as visit3 } from "unist-util-visit";
 function readingTime({
   attribute = "readingTime"
 } = {}) {
   return function(info, file) {
     let text = "";
-    visit2(info, ["text", "code"], (node) => {
+    visit3(info, ["text", "code"], (node) => {
       text += node.value;
     });
     file.data[attribute] = import_reading_time.default(text);
@@ -199,10 +275,10 @@ var init_remark_reading_time = __esm(() => {
 });
 
 // src/lib/remark-unused-directives.ts
-import { visit as visit3 } from "unist-util-visit";
+import { visit as visit4 } from "unist-util-visit";
 var remarkUnusedDirectives = () => {
   return (tree) => {
-    visit3(tree, ["textDirective"], (node) => {
+    visit4(tree, ["textDirective"], (node) => {
       const directive = node;
       if (!directive.data) {
         const hasAttributes = directive.attributes && Object.keys(directive.attributes).length > 0;
@@ -234,12 +310,12 @@ import { defineConfig as defineFumadocsConfig } from "fumadocs-mdx/config";
 import mdx from "fumadocs-mdx/vite";
 import { nitro } from "nitro/vite";
 import fs3 from "node:fs/promises";
-import path4 from "node:path";
+import path6 from "node:path";
 import remarkDirective from "remark-directive";
 function resolveOutputDir(projectRoot, preset) {
   if (preset === "vercel" || preset === "vercel-static")
-    return path4.resolve(projectRoot, ".vercel/output");
-  return path4.resolve(projectRoot, ".output");
+    return path6.resolve(projectRoot, ".vercel/output");
+  return path6.resolve(projectRoot, ".output");
 }
 async function readChronicleConfig(projectRoot, configPath) {
   if (configPath) {
@@ -250,7 +326,7 @@ async function readChronicleConfig(projectRoot, configPath) {
     }
   }
   try {
-    return await fs3.readFile(path4.join(projectRoot, "chronicle.yaml"), "utf-8");
+    return await fs3.readFile(path6.join(projectRoot, "chronicle.yaml"), "utf-8");
   } catch {
     return null;
   }
@@ -258,18 +334,19 @@ async function readChronicleConfig(projectRoot, configPath) {
 async function createViteConfig(options) {
   const { packageRoot, projectRoot, configPath, preset } = options;
   const rawConfig = await readChronicleConfig(projectRoot, configPath);
-  const contentMirror = path4.resolve(packageRoot, ".content");
+  const contentMirror = path6.resolve(packageRoot, ".content");
   return {
     root: packageRoot,
     configFile: false,
     plugins: [
       nitro({
-        serverDir: path4.resolve(packageRoot, "src/server"),
+        serverDir: path6.resolve(packageRoot, "src/server"),
         ...preset && { preset }
       }),
       mdx({
         default: defineFumadocsConfig({
           mdxOptions: {
+            remarkImageOptions: false,
             valueToExport: ["readingTime"],
             remarkPlugins: [
               remarkDirective,
@@ -291,7 +368,8 @@ async function createViteConfig(options) {
                 }
               }],
               remark_unused_directives_default,
-              remark_strip_md_extensions_default,
+              remark_resolve_links_default,
+              remark_resolve_images_default,
               remarkMdxMermaid,
               readingTime
             ]
@@ -302,7 +380,7 @@ async function createViteConfig(options) {
     ],
     resolve: {
       alias: {
-        "@": path4.resolve(packageRoot, "src"),
+        "@": path6.resolve(packageRoot, "src"),
         tslib: "tslib/tslib.es6.js"
       },
       dedupe: [
@@ -335,7 +413,7 @@ async function createViteConfig(options) {
       client: {
         build: {
           rollupOptions: {
-            input: path4.resolve(packageRoot, "src/server/entry-client.tsx")
+            input: path6.resolve(packageRoot, "src/server/entry-client.tsx")
           }
         }
       }
@@ -349,7 +427,8 @@ async function createViteConfig(options) {
   };
 }
 var init_vite_config = __esm(() => {
-  init_remark_strip_md_extensions();
+  init_remark_resolve_images();
+  init_remark_resolve_links();
   init_remark_reading_time();
   init_remark_unused_directives();
 });
@@ -720,7 +799,7 @@ var devCommand = new Command2("dev").description("Start development server").opt
 
 // src/cli/commands/init.ts
 import fs4 from "node:fs";
-import path5 from "node:path";
+import path7 from "node:path";
 import chalk4 from "chalk";
 import { Command as Command3 } from "commander";
 import { stringify } from "yaml";
@@ -747,12 +826,12 @@ var GITIGNORE_ENTRIES = ["node_modules", "dist", ".output"];
 function runInit(projectDir) {
   const events = [];
   const defaultDir = defaultInitConfig.content[0].dir;
-  const contentDir = path5.join(projectDir, "content", defaultDir);
+  const contentDir = path7.join(projectDir, "content", defaultDir);
   if (!fs4.existsSync(contentDir)) {
     fs4.mkdirSync(contentDir, { recursive: true });
     events.push({ type: "created", path: contentDir });
   }
-  const configPath = path5.join(projectDir, "chronicle.yaml");
+  const configPath = path7.join(projectDir, "chronicle.yaml");
   if (!fs4.existsSync(configPath)) {
     fs4.writeFileSync(configPath, stringify(defaultInitConfig));
     events.push({ type: "created", path: configPath });
@@ -761,11 +840,11 @@ function runInit(projectDir) {
   }
   const contentFiles = fs4.readdirSync(contentDir);
   if (contentFiles.length === 0) {
-    const indexPath = path5.join(contentDir, "index.mdx");
+    const indexPath = path7.join(contentDir, "index.mdx");
     fs4.writeFileSync(indexPath, sampleMdx);
     events.push({ type: "created", path: indexPath });
   }
-  const gitignorePath = path5.join(projectDir, ".gitignore");
+  const gitignorePath = path7.join(projectDir, ".gitignore");
   if (fs4.existsSync(gitignorePath)) {
     const existing = fs4.readFileSync(gitignorePath, "utf-8");
     const existingLines = new Set(existing.split(/\r?\n/).map((l) => l.trim()).filter(Boolean));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@raystack/chronicle",
-  "version": "0.7.0",
+  "version": "0.7.2",
   "description": "Config-driven documentation framework",
   "license": "Apache-2.0",
   "type": "module",
@@ -22,12 +22,16 @@
   "devDependencies": {
     "@biomejs/biome": "^2.3.13",
     "@raystack/tools-config": "0.56.0",
+    "@types/hast": "^3.0.4",
     "@types/lodash": "^4.17.23",
+    "@types/mdast": "^4.0.4",
     "@types/mdx": "^2.0.13",
     "@types/node": "^25.1.0",
     "@types/react": "^19.2.10",
     "@types/react-dom": "^19.2.3",
     "@types/semver": "^7.7.1",
+    "@types/unist": "^3.0.3",
+    "mdast-util-mdx-jsx": "^3.2.0",
     "semver": "^7.7.4",
     "typescript": "5.9.3"
   },

package/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>

package/src/lib/remark-resolve-images.ts

@@ -0,0 +1,59 @@
+import path from 'node:path'
+import { visit } from 'unist-util-visit'
+import type { Plugin } from 'unified'
+import type { Image, Html } from 'mdast'
+import type { Element } from 'hast'
+import type { MdxJsxFlowElement, MdxJsxTextElement, MdxJsxAttribute } from 'mdast-util-mdx-jsx'
+
+function resolveUrl(src: string, dir: string): string {
+  if (/^[a-z][a-z0-9+\-.]*:/i.test(src)) return src
+  if (src.startsWith('//')) return src
+  if (src.startsWith('#')) return src
+  if (src.startsWith('/_content/')) return src
+
+  if (src.startsWith('/')) return `/_content${src}`
+  return `/_content/${path.posix.normalize(path.posix.join(dir, src))}`
+}
+
+const remarkResolveImages: 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, 'image', (node: Image) => {
+      if (!node.url) return
+      node.url = resolveUrl(node.url, dir)
+    })
+
+    visit(tree, 'html', (node: Html) => {
+      node.value = node.value.replace(
+        /(<img\b[^>]*\bsrc=["'])([^"']+)(["'])/gi,
+        (_, before, src, after) => `${before}${resolveUrl(src, dir)}${after}`
+      )
+    })
+
+    visit(tree, (node) => {
+      if (node.type !== 'mdxJsxFlowElement' && node.type !== 'mdxJsxTextElement') return
+      const jsx = node as MdxJsxFlowElement | MdxJsxTextElement
+      if (jsx.name !== 'img') return
+      const srcAttr = jsx.attributes.find((a): a is MdxJsxAttribute => a.type === 'mdxJsxAttribute' && a.name === 'src')
+      if (!srcAttr?.value || typeof srcAttr.value !== 'string') return
+      srcAttr.value = resolveUrl(srcAttr.value, dir)
+    })
+
+    visit(tree, 'element', (node: Element) => {
+      if (node.tagName !== 'img') return
+      const src = node.properties?.src
+      if (typeof src !== 'string') return
+      node.properties.src = resolveUrl(src, dir)
+    })
+  }
+}
+
+export default remarkResolveImages

package/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

package/src/lib/source.ts

@@ -23,6 +23,11 @@ const frontmatterGlob: Record<string, Record<string, unknown>> = import.meta.glo
   { eager: true, import: 'frontmatter' }
 );
 
+const readingTimeGlob: Record<string, { text: string; minutes: number; words: number; time: number } | undefined> = import.meta.glob(
+  '../../.content/**/*.{mdx,md}',
+  { eager: true, import: 'readingTime' }
+);
+
 const metaGlob: Record<string, Record<string, unknown>> = import.meta.glob(
   '../../.content/**/meta.json',
   { eager: true }
@@ -38,10 +43,12 @@ function buildFiles() {
   for (const [key, data] of Object.entries(frontmatterGlob)) {
     const originalPath = key.slice(CONTENT_PREFIX.length);
     const relativePath = originalPath.replace(/readme\.(mdx?)$/i, 'index.$1');
+    const rt = readingTimeGlob[key];
+    const _readingTime = rt?.minutes != null ? Math.max(1, Math.round(rt.minutes)) : undefined;
     files.push({
       type: 'page',
       path: relativePath,
-      data: { ...data, _relativePath: relativePath, _originalPath: originalPath }
+      data: { ...data, _readingTime, _relativePath: relativePath, _originalPath: originalPath }
     });
   }
 

package/src/pages/ApiLayout.tsx

@@ -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>
   );

package/src/server/App.tsx

@@ -40,7 +40,7 @@ export function App() {
           <ApiPage slug={apiSlug} />
         </ApiLayout>
       ) : (
-        <DocsLayout>
+        <DocsLayout hideSidebar={isLanding}>
           {isLanding ? <LandingPage /> : <DocsPage slug={docsSlug} />}
         </DocsLayout>
       )}

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

@@ -51,11 +51,11 @@ export default defineHandler(async event => {
       ? await response.json()
       : await response.text();
 
-    return {
+    return Response.json({
       status: response.status,
       statusText: response.statusText,
       body: responseBody
-    };
+    });
   } catch (error) {
     const message =
       error instanceof Error

package/src/server/api/health.ts

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

package/src/server/api/page.ts

@@ -12,11 +12,11 @@ export default defineHandler(async event => {
 
   const nav = await getPageNav(slug);
 
-  return {
+  return Response.json({
     frontmatter: extractFrontmatter(page, slug[slug.length - 1]),
     relativePath: getRelativePath(page),
     originalPath: getOriginalPath(page),
     prev: nav.prev,
     next: nav.next,
-  };
+  });
 });

package/src/server/api/search.ts

@@ -125,7 +125,7 @@ export default defineHandler(async event => {
 
   if (!query) {
     const docs = await getDocs(ctx);
-    return docs
+    return Response.json(docs
       .filter(d => d.type === 'page')
       .slice(0, 8)
       .map(d => ({
@@ -133,13 +133,13 @@ export default defineHandler(async event => {
         url: d.url,
         type: d.type,
         content: d.title
-      }));
+      })));
   }
 
-  return index.search(query).map(r => ({
+  return Response.json(index.search(query).map(r => ({
     id: r.id,
     url: r.url,
     type: r.type,
     content: r.title
-  }));
+  })));
 });

package/src/server/api/specs.ts

@@ -15,7 +15,7 @@ export default defineHandler(async event => {
   }
 
   const apiConfigs = getApiConfigsForVersion(config, versionDir);
-  if (!apiConfigs.length) return [];
+  if (!apiConfigs.length) return Response.json([]);
 
-  return loadApiSpecs(apiConfigs);
+  return Response.json(await loadApiSpecs(apiConfigs));
 });

package/src/server/routes/[...slug].md.ts

@@ -34,6 +34,5 @@ export default defineHandler(async event => {
     throw new HTTPError({ status: 404, message: 'Not Found' });
   }
 
-  event.res.headers.set('Content-Type', 'text/markdown; charset=utf-8');
-  return matter(raw).content;
+  return new Response(matter(raw).content, { headers: { 'Content-Type': 'text/markdown; charset=utf-8' } });
 });

package/src/server/routes/[version]/llms.txt.ts

@@ -21,6 +21,5 @@ export default defineHandler(async event => {
     ctx,
   );
 
-  event.res.headers.set('Content-Type', 'text/plain');
-  return body;
+  return new Response(body, { headers: { 'Content-Type': 'text/plain' } });
 });

package/src/server/routes/_content/[...path].ts

@@ -0,0 +1,40 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { defineHandler, HTTPError } from 'nitro';
+import { safePath } from '@/server/utils/safe-path';
+
+const MIME: Record<string, string> = {
+  '.png': 'image/png',
+  '.jpg': 'image/jpeg',
+  '.jpeg': 'image/jpeg',
+  '.gif': 'image/gif',
+  '.svg': 'image/svg+xml',
+  '.webp': 'image/webp',
+  '.ico': 'image/x-icon',
+  '.pdf': 'application/pdf',
+};
+
+export default defineHandler(async event => {
+  const pathname = event.path?.replace(/^\/_content/, '') || '';
+  if (!pathname || pathname.endsWith('.md') || pathname.endsWith('.mdx')) {
+    throw new HTTPError({ status: 404, message: 'Not Found' });
+  }
+
+  const contentDir = __CHRONICLE_CONTENT_DIR__;
+  let filePath: string | null = null;
+  try { filePath = safePath(contentDir, pathname); } catch { /* malformed URL encoding */ }
+  if (!filePath) throw new HTTPError({ status: 404, message: 'Not Found' });
+
+  const data = await fs.readFile(filePath).catch(() => null);
+  if (!data) throw new HTTPError({ status: 404, message: 'Not Found' });
+
+  const ext = path.extname(filePath).toLowerCase();
+  const contentType = MIME[ext] ?? 'application/octet-stream';
+
+  return new Response(data, {
+    headers: {
+      'Content-Type': contentType,
+      'Cache-Control': 'public, max-age=86400',
+    },
+  });
+});

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

@@ -4,7 +4,7 @@ import { buildLlmsTxt } from '@/lib/llms';
 import { extractFrontmatter, getPagesForVersion } from '@/lib/source';
 import { LATEST_CONTEXT } from '@/lib/version-source';
 
-export default defineHandler(async event => {
+export default defineHandler(async () => {
   const config = loadConfig();
 
   const pages = await getPagesForVersion(LATEST_CONTEXT);
@@ -14,6 +14,5 @@ export default defineHandler(async event => {
     LATEST_CONTEXT,
   );
 
-  event.res.headers.set('Content-Type', 'text/plain');
-  return body;
+  return new Response(body, { headers: { 'Content-Type': 'text/plain' } });
 });

package/src/server/routes/og.tsx

@@ -69,7 +69,5 @@ export default defineHandler(async event => {
     },
   );
 
-  event.res.headers.set('Content-Type', 'image/svg+xml');
-  event.res.headers.set('Cache-Control', 'public, max-age=86400');
-  return svg;
+  return new Response(svg, { headers: { 'Content-Type': 'image/svg+xml', 'Cache-Control': 'public, max-age=86400' } });
 });

package/src/server/routes/robots.txt.ts

@@ -1,11 +1,10 @@
 import { defineHandler } from 'nitro';
 import { loadConfig } from '@/lib/config';
 
-export default defineHandler(event => {
+export default defineHandler(() => {
   const config = loadConfig();
   const sitemap = config.url ? `\nSitemap: ${config.url}/sitemap.xml` : '';
   const body = `User-agent: *\nAllow: /${sitemap}`;
 
-  event.res.headers.set('Content-Type', 'text/plain');
-  return body;
+  return new Response(body, { headers: { 'Content-Type': 'text/plain' } });
 });

package/src/server/routes/sitemap.xml.ts

@@ -4,12 +4,11 @@ import { getAllVersions, getApiConfigsForVersion, loadConfig } from '@/lib/confi
 import { loadApiSpecs } from '@/lib/openapi';
 import { getPages } from '@/lib/source';
 
-export default defineHandler(async event => {
+export default defineHandler(async () => {
   const config = loadConfig();
 
   if (!config.url) {
-    event.res.headers.set('Content-Type', 'application/xml');
-    return '<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"/>';
+    return new Response('<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"/>', { headers: { 'Content-Type': 'application/xml' } });
   }
 
   const baseUrl = config.url.replace(/\/$/, '');
@@ -43,6 +42,5 @@ export default defineHandler(async event => {
 ${[...docPages, ...apiPages].join('\n')}
 </urlset>`;
 
-  event.res.headers.set('Content-Type', 'application/xml');
-  return xml;
+  return new Response(xml, { headers: { 'Content-Type': 'application/xml' } });
 });

package/src/server/vite-config.ts

@@ -7,7 +7,8 @@ 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 remarkResolveImages from '../lib/remark-resolve-images';
+import remarkResolveLinks from '../lib/remark-resolve-links';
 import remarkReadingTime from 'remark-reading-time';
 import remarkUnusedDirectives from '../lib/remark-unused-directives';
 
@@ -56,6 +57,7 @@ export async function createViteConfig(
       mdx({
         default: defineFumadocsConfig({
           mdxOptions: {
+            remarkImageOptions: false,
             valueToExport: ['readingTime'],
             remarkPlugins: [
               remarkDirective,
@@ -77,7 +79,8 @@ export async function createViteConfig(
                 },
               }],
               remarkUnusedDirectives,
-              remarkStripMdExtensions,
+              remarkResolveLinks,
+              remarkResolveImages,
               remarkMdxMermaid,
               remarkReadingTime,
             ],

package/src/themes/paper/Layout.module.css

@@ -79,3 +79,7 @@
   flex: 1;
   background: var(--rs-color-background-neutral-primary);
 }
+
+.hiddenTrigger {
+  display: none;
+}

package/src/themes/paper/Layout.tsx

@@ -6,6 +6,7 @@ import { useLocation, useNavigate } from 'react-router';
 import { getLandingEntries } from '@/lib/config';
 import { getActiveContentDir } from '@/lib/navigation';
 import { usePageContext } from '@/lib/page-context';
+import { Search } from '@/components/ui/search';
 import type { ThemeLayoutProps } from '@/types';
 import { ChapterNav } from './ChapterNav';
 import styles from './Layout.module.css';
@@ -82,6 +83,7 @@ function LayoutInner({
           </aside>
         ) : null}
         <div className={cx(styles.content, classNames?.content)}>
+          {config.search?.enabled && <Search classNames={{ trigger: styles.hiddenTrigger }} />}
           {children}
         </div>
       </Flex>

package/src/lib/remark-strip-md-extensions.ts

@@ -1,14 +0,0 @@
-import { visit } from 'unist-util-visit'
-import type { Plugin } from 'unified'
-
-const remarkStripMdExtensions: Plugin = () => {
-  return (tree) => {
-    visit(tree, 'link', (node: any) => {
-      if (!node.url) return
-      if (node.url.startsWith('http://') || node.url.startsWith('https://')) return
-      node.url = node.url.replace(/\.mdx?(#|$)/, '$1')
-    })
-  }
-}
-
-export default remarkStripMdExtensions