@raystack/chronicle 0.6.1 → 0.7.1

package/dist/cli/index.js

@@ -1,5 +1,35 @@
 import { createRequire } from "node:module";
+var __create = Object.create;
+var __getProtoOf = Object.getPrototypeOf;
 var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+function __accessProp(key) {
+  return this[key];
+}
+var __toESMCache_node;
+var __toESMCache_esm;
+var __toESM = (mod, isNodeMode, target) => {
+  var canCache = mod != null && typeof mod === "object";
+  if (canCache) {
+    var cache = isNodeMode ? __toESMCache_node ??= new WeakMap : __toESMCache_esm ??= new WeakMap;
+    var cached = cache.get(mod);
+    if (cached)
+      return cached;
+  }
+  target = mod != null ? __create(__getProtoOf(mod)) : {};
+  const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
+  for (let key of __getOwnPropNames(mod))
+    if (!__hasOwnProp.call(to, key))
+      __defProp(to, key, {
+        get: __accessProp.bind(mod, key),
+        enumerable: true
+      });
+  if (canCache)
+    cache.set(mod, to);
+  return to;
+};
+var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
 var __returnValue = (v) => v;
 function __exportSetter(name, newValue) {
   this[name] = __returnValue.bind(null, newValue);
@@ -16,28 +46,239 @@ 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;
-      if (node.url.startsWith("http://") || node.url.startsWith("https://"))
+      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.url = node.url.replace(/\.mdx?(#|$)/, "$1");
+      node.properties.src = resolveUrl(src, dir);
     });
   };
-}, remark_strip_md_extensions_default;
-var init_remark_strip_md_extensions = __esm(() => {
-  remark_strip_md_extensions_default = remarkStripMdExtensions;
+}, remark_resolve_images_default;
+var init_remark_resolve_images = __esm(() => {
+  remark_resolve_images_default = remarkResolveImages;
 });
 
-// src/lib/remark-unused-directives.ts
+// 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 (/^[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 = path5.posix.normalize(path5.posix.join(dir, stripped));
+      resolved = resolved.replace(/\/(index|readme)$/i, "") || ".";
+      node.url = `/${resolved}${hash ? `#${hash}` : ""}`;
+    });
+  };
+}, 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
+var require_reading_time = __commonJS((exports, module) => {
+  /*!
+   * reading-time
+   * Copyright (c) Nicolas Gryman <ngryman@gmail.com>
+   * MIT Licensed
+   */
+  function codeIsInRanges(number, arrayOfRanges) {
+    return arrayOfRanges.some(([lowerBound, upperBound]) => lowerBound <= number && number <= upperBound);
+  }
+  function isCJK(c) {
+    if (typeof c !== "string") {
+      return false;
+    }
+    const charCode = c.charCodeAt(0);
+    return codeIsInRanges(charCode, [
+      [12352, 12447],
+      [19968, 40959],
+      [44032, 55203],
+      [131072, 191456]
+    ]);
+  }
+  function isAnsiWordBound(c) {
+    return ` 
+\r	`.includes(c);
+  }
+  function isPunctuation(c) {
+    if (typeof c !== "string") {
+      return false;
+    }
+    const charCode = c.charCodeAt(0);
+    return codeIsInRanges(charCode, [
+      [33, 47],
+      [58, 64],
+      [91, 96],
+      [123, 126],
+      [12288, 12351],
+      [65280, 65519]
+    ]);
+  }
+  function readingTime(text, options = {}) {
+    let words = 0, start = 0, end = text.length - 1;
+    const wordsPerMinute = options.wordsPerMinute || 200;
+    const isWordBound = options.wordBound || isAnsiWordBound;
+    while (isWordBound(text[start]))
+      start++;
+    while (isWordBound(text[end]))
+      end--;
+    const normalizedText = `${text}
+`;
+    for (let i = start;i <= end; i++) {
+      if (isCJK(normalizedText[i]) || !isWordBound(normalizedText[i]) && (isWordBound(normalizedText[i + 1]) || isCJK(normalizedText[i + 1]))) {
+        words++;
+      }
+      if (isCJK(normalizedText[i])) {
+        while (i <= end && (isPunctuation(normalizedText[i + 1]) || isWordBound(normalizedText[i + 1]))) {
+          i++;
+        }
+      }
+    }
+    const minutes = words / wordsPerMinute;
+    const time = Math.round(minutes * 60 * 1000);
+    const displayed = Math.ceil(minutes.toFixed(2));
+    return {
+      text: displayed + " min read",
+      minutes,
+      time,
+      words
+    };
+  }
+  module.exports = readingTime;
+});
+
+// ../../node_modules/.bun/reading-time@1.5.0/node_modules/reading-time/lib/stream.js
+var require_stream = __commonJS((exports, module) => {
+  /*!
+   * reading-time
+   * Copyright (c) Nicolas Gryman <ngryman@gmail.com>
+   * MIT Licensed
+   */
+  var readingTime = require_reading_time();
+  var Transform = __require("stream").Transform;
+  var util = __require("util");
+  function ReadingTimeStream(options) {
+    if (!(this instanceof ReadingTimeStream)) {
+      return new ReadingTimeStream(options);
+    }
+    Transform.call(this, { objectMode: true });
+    this.options = options || {};
+    this.stats = {
+      minutes: 0,
+      time: 0,
+      words: 0
+    };
+  }
+  util.inherits(ReadingTimeStream, Transform);
+  ReadingTimeStream.prototype._transform = function(chunk, encoding, callback) {
+    const stats = readingTime(chunk.toString(encoding), this.options);
+    this.stats.minutes += stats.minutes;
+    this.stats.time += stats.time;
+    this.stats.words += stats.words;
+    callback();
+  };
+  ReadingTimeStream.prototype._flush = function(callback) {
+    this.stats.text = Math.ceil(this.stats.minutes.toFixed(2)) + " min read";
+    this.push(this.stats);
+    callback();
+  };
+  module.exports = ReadingTimeStream;
+});
+
+// ../../node_modules/.bun/reading-time@1.5.0/node_modules/reading-time/index.js
+var require_reading_time2 = __commonJS((exports, module) => {
+  exports.default = module.exports = require_reading_time();
+  module.exports.readingTimeStream = require_stream();
+});
+
+// ../../node_modules/.bun/remark-reading-time@2.1.0/node_modules/remark-reading-time/index.js
+import { visit as visit3 } from "unist-util-visit";
+function readingTime({
+  attribute = "readingTime"
+} = {}) {
+  return function(info, file) {
+    let text = "";
+    visit3(info, ["text", "code"], (node) => {
+      text += node.value;
+    });
+    file.data[attribute] = import_reading_time.default(text);
+  };
+}
+var import_reading_time;
+var init_remark_reading_time = __esm(() => {
+  import_reading_time = __toESM(require_reading_time2(), 1);
+});
+
+// src/lib/remark-unused-directives.ts
+import { visit as visit4 } from "unist-util-visit";
 var remarkUnusedDirectives = () => {
   return (tree) => {
-    visit2(tree, ["textDirective"], (node) => {
+    visit4(tree, ["textDirective"], (node) => {
       const directive = node;
       if (!directive.data) {
         const hasAttributes = directive.attributes && Object.keys(directive.attributes).length > 0;
@@ -69,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) {
@@ -85,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;
   }
@@ -93,18 +334,20 @@ 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,
               [remarkDirectiveAdmonition, {
@@ -125,8 +368,10 @@ async function createViteConfig(options) {
                 }
               }],
               remark_unused_directives_default,
-              remark_strip_md_extensions_default,
-              remarkMdxMermaid
+              remark_resolve_links_default,
+              remark_resolve_images_default,
+              remarkMdxMermaid,
+              readingTime
             ]
           }
         })
@@ -135,7 +380,7 @@ async function createViteConfig(options) {
     ],
     resolve: {
       alias: {
-        "@": path4.resolve(packageRoot, "src"),
+        "@": path6.resolve(packageRoot, "src"),
         tslib: "tslib/tslib.es6.js"
       },
       dedupe: [
@@ -168,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")
           }
         }
       }
@@ -182,7 +427,9 @@ 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();
 });
 
@@ -266,6 +513,7 @@ var dirNameSchema = z.string().min(1).refine((s) => DIR_NAME_PATTERN.test(s) &&
 var contentEntrySchema = z.object({
   dir: dirNameSchema,
   label: z.string().min(1),
+  description: z.string().optional(),
   icon: z.string().optional()
 });
 var badgeVariantSchema = z.enum([
@@ -428,6 +676,7 @@ function getLatestContentRoots(config2) {
     versionLabel: config2.latest?.label ?? null,
     contentDir: c.dir,
     contentLabel: c.label,
+    contentDescription: c.description,
     contentIcon: c.icon,
     fsPath: `content/${c.dir}`,
     urlPrefix: `/${c.dir}`
@@ -442,6 +691,7 @@ function getVersionContentRoots(config2, versionDir) {
     versionLabel: version.label,
     contentDir: c.dir,
     contentLabel: c.label,
+    contentDescription: c.description,
     contentIcon: c.icon,
     fsPath: `versions/${version.dir}/${c.dir}`,
     urlPrefix: `/${version.dir}/${c.dir}`
@@ -549,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";
@@ -576,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 });
@@ -590,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.6.1",
+  "version": "0.7.1",
   "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/config.ts

@@ -35,6 +35,7 @@ export interface ContentRoot {
   versionLabel: string | null
   contentDir: string
   contentLabel: string
+  contentDescription?: string
   contentIcon?: string
   fsPath: string
   urlPrefix: string
@@ -46,6 +47,7 @@ export function getLatestContentRoots(config: ChronicleConfig): ContentRoot[] {
     versionLabel: config.latest?.label ?? null,
     contentDir: c.dir,
     contentLabel: c.label,
+    contentDescription: c.description,
     contentIcon: c.icon,
     fsPath: `content/${c.dir}`,
     urlPrefix: `/${c.dir}`,
@@ -64,6 +66,7 @@ export function getVersionContentRoots(
     versionLabel: version.label,
     contentDir: c.dir,
     contentLabel: c.label,
+    contentDescription: c.description,
     contentIcon: c.icon,
     fsPath: `versions/${version.dir}/${c.dir}`,
     urlPrefix: `/${version.dir}/${c.dir}`,
@@ -79,6 +82,7 @@ export interface VersionDescriptor {
 
 export interface LandingEntry {
   label: string
+  description?: string
   href: string
   contentDir: string
   icon?: string
@@ -95,6 +99,7 @@ export function getLandingEntries(
 
   return roots.map((r) => ({
     label: r.contentLabel,
+    description: r.contentDescription,
     href: r.urlPrefix,
     contentDir: r.contentDir,
     icon: r.contentIcon,

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 }
     });
   }
 
@@ -206,6 +213,7 @@ export function extractFrontmatter(page: { data: unknown }, fallbackTitle?: stri
     order: d.order as number | undefined,
     icon: d.icon as string | undefined,
     lastModified: d.lastModified as string | undefined,
+    _readingTime: d._readingTime as number | undefined,
   };
 }
 
@@ -217,13 +225,20 @@ export function getOriginalPath(page: { data: unknown }): string {
   return ((page.data as Record<string, unknown>)._originalPath as string) ?? '';
 }
 
-const ssrModules = import.meta.glob<{ default?: MDXContent; toc?: TableOfContents }>(
+interface ReadingTime {
+  text: string;
+  minutes: number;
+  words: number;
+  time: number;
+}
+
+const ssrModules = import.meta.glob<{ default?: MDXContent; toc?: TableOfContents; readingTime?: ReadingTime }>(
   '../../.content/**/*.{mdx,md}'
 );
 
 export async function loadPageModule(
   relativePath: string
-): Promise<{ default: MDXContent | null; toc: TableOfContents }> {
+): Promise<{ default: MDXContent | null; toc: TableOfContents; _readingTime?: number }> {
   if (!relativePath || relativePath.includes('..')) return { default: null, toc: [] };
   const withoutExt = relativePath.replace(/\.(mdx|md)$/, '');
   const key = relativePath.endsWith('.md')
@@ -232,5 +247,6 @@ export async function loadPageModule(
   const loader = ssrModules[key];
   if (!loader) return { default: null, toc: [] };
   const mod = await loader();
-  return { default: mod.default ?? null, toc: mod.toc ?? [] };
+  const minutes = mod.readingTime?.minutes;
+  return { default: mod.default ?? null, toc: mod.toc ?? [], _readingTime: minutes != null ? Math.max(1, Math.round(minutes)) : undefined };
 }