boltdocs 3.0.1 → 3.1.0

package/README.md

@@ -1,12 +1,11 @@
 <h1 align="center">Boltdocs</h1>
 
 <p align="center">
-  <strong>The fastest documentation framework. 2.5× faster warm builds than Docusaurus.</strong>
+  <strong>A modern documentation framework built with React, Vite, and MDX.</strong>
 </p>
 
 <p align="center">
   <a href="#quick-start"><img src="https://img.shields.io/badge/Quick_Start-blue?style=flat-square" alt="Quick Start" /></a>
-  <a href="#benchmarks"><img src="https://img.shields.io/badge/Benchmarks-orange?style=flat-square" alt="Benchmarks" /></a>
   <a href="https://boltdocs.vercel.app"><img src="https://img.shields.io/badge/Live_Demo-purple?style=flat-square" alt="Live Demo" /></a>
   <br />
   <a href="https://www.npmjs.com/package/boltdocs"><img src="https://img.shields.io/npm/v/boltdocs?style=flat-square" alt="npm version" /></a>
@@ -18,21 +17,6 @@
 
 ---
 
-## Benchmarks
-
-Real performance comparison with **100 pages** — Boltdocs vs Docusaurus:
-
-| Metric | Boltdocs | Docusaurus | Advantage |
-|--------|----------|------------|-----------|
-| **Cold build** (first build) | **15.66s** | 30.50s | **1.9× faster** |
-| **Warm rebuild** (cached) | **5.68s** | 14.24s | **2.5× faster** |
-| **Dev server start** | **2132ms** | 2612ms | **1.2× faster** |
-| **Zero-config setup** | **1 line** | 60+ lines | — |
-
-<sub>Benchmark source: `docs/src/data/benchmark-results.json`. 100-page project with identical content on both frameworks.</sub>
-
----
-
 ## Quick Start
 
 ```bash
@@ -52,7 +36,7 @@ mkdir docs && echo "# Hello World" > docs/index.md
 
 ## Why Boltdocs?
 
-**Zero config, instant docs.** A single command sets up a full documentation site with Tailwind CSS v4, TypeScript, MDX support, and a production-ready layout — no Docusaurus-style boilerplate.
+**Zero config, instant docs.** A single command sets up a full documentation site with Tailwind CSS v4, TypeScript, MDX support, and a production-ready layout — zero boilerplate.
 
 **Built-in, not bolt-on.** i18n, versioning, full-text search, SEO, analytics (GA4/GTM), syntax highlighting (Shiki), image optimization, CSP headers, and a changelog generator — all ship as part of the framework, not as third-party plugins.
 

package/dist/{adapters-C5AWWGfb.cjs → adapters-uGz-UKQa.cjs}

@@ -3,4 +3,4 @@
  * Copyright (c) 2026 Jesus Alcala
  * Licensed under the MIT License.
  */
-const e=require(`./handler-Dzf4dSnV.cjs`),t={"Access-Control-Allow-Origin":`*`,"Access-Control-Allow-Methods":`POST, OPTIONS`,"Access-Control-Allow-Headers":`Content-Type`,"Content-Type":`application/json`};async function n(n,r){if(Object.entries(t).forEach(([e,t])=>{r.setHeader(e,t)}),n.method===`OPTIONS`){r.status(200).end();return}if(n.method!==`POST`){r.status(405).json({error:`Method Not Allowed`});return}try{let t=await e.t(n.body,process.env);r.status(200).json(t)}catch(e){let t=e instanceof Error?e.message:`Failed to submit feedback`;return r.status(500).json({error:t})}}async function r(n,r=process.env){let i=(e,n=200)=>({statusCode:n,headers:t,body:e?JSON.stringify(e):``});if(n.httpMethod===`OPTIONS`)return i(null,200);if(n.httpMethod!==`POST`)return i({error:`Method Not Allowed`},405);try{return i(await e.t(n.body?JSON.parse(n.body):{},r))}catch(e){return i({error:e instanceof Error?e.message:`Failed to submit feedback`},500)}}async function i(n,r={}){let i=(e,n=200)=>new Response(e?JSON.stringify(e):null,{status:n,headers:t});if(n.method===`OPTIONS`)return i(null);if(n.method!==`POST`)return i({error:`Method Not Allowed`},405);try{return i(await e.t(await n.json(),{...process.env,...r}))}catch(e){return i({error:e instanceof Error?e.message:`Failed to submit feedback`},500)}}async function a(n,r=process.env){let i=(e,n=200)=>({statusCode:n,headers:t,body:e?JSON.stringify(e):``});if(n.httpMethod===`OPTIONS`)return i(null,200);if(n.httpMethod!==`POST`)return i({error:`Method Not Allowed`},405);try{return i(await e.t(n.body?JSON.parse(n.body):{},r))}catch(e){return i({error:e instanceof Error?e.message:`Failed to submit feedback`},500)}}Object.defineProperty(exports,`i`,{enumerable:!0,get:function(){return n}}),Object.defineProperty(exports,`n`,{enumerable:!0,get:function(){return i}}),Object.defineProperty(exports,`r`,{enumerable:!0,get:function(){return r}}),Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return a}});
+const e=require(`./handler-1LRMYeI4.cjs`),t={"Access-Control-Allow-Origin":`*`,"Access-Control-Allow-Methods":`POST, OPTIONS`,"Access-Control-Allow-Headers":`Content-Type`,"Content-Type":`application/json`};async function n(n,r){if(Object.entries(t).forEach(([e,t])=>{r.setHeader(e,t)}),n.method===`OPTIONS`){r.status(200).end();return}if(n.method!==`POST`){r.status(405).json({error:`Method Not Allowed`});return}try{let t=await e.t(n.body,process.env);r.status(200).json(t)}catch(e){let t=e instanceof Error?e.message:`Failed to submit feedback`;return r.status(500).json({error:t})}}async function r(n,r=process.env){let i=(e,n=200)=>({statusCode:n,headers:t,body:e?JSON.stringify(e):``});if(n.httpMethod===`OPTIONS`)return i(null,200);if(n.httpMethod!==`POST`)return i({error:`Method Not Allowed`},405);try{return i(await e.t(n.body?JSON.parse(n.body):{},r))}catch(e){return i({error:e instanceof Error?e.message:`Failed to submit feedback`},500)}}async function i(n,r={}){let i=(e,n=200)=>new Response(e?JSON.stringify(e):null,{status:n,headers:t});if(n.method===`OPTIONS`)return i(null);if(n.method!==`POST`)return i({error:`Method Not Allowed`},405);try{return i(await e.t(await n.json(),{...process.env,...r}))}catch(e){return i({error:e instanceof Error?e.message:`Failed to submit feedback`},500)}}async function a(n,r=process.env){let i=(e,n=200)=>({statusCode:n,headers:t,body:e?JSON.stringify(e):``});if(n.httpMethod===`OPTIONS`)return i(null,200);if(n.httpMethod!==`POST`)return i({error:`Method Not Allowed`},405);try{return i(await e.t(n.body?JSON.parse(n.body):{},r))}catch(e){return i({error:e instanceof Error?e.message:`Failed to submit feedback`},500)}}Object.defineProperty(exports,`i`,{enumerable:!0,get:function(){return n}}),Object.defineProperty(exports,`n`,{enumerable:!0,get:function(){return i}}),Object.defineProperty(exports,`r`,{enumerable:!0,get:function(){return r}}),Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return a}});

package/dist/{banner-DNSkgUsO.d.cts → banner-DdSgCs4G.d.cts}

@@ -1,5 +1,5 @@
 
-import { T as BoltdocsConfig, a as SidebarItem, d as SidebarMobile, f as SidebarRoot, i as SidebarHeader, l as SidebarLink, n as SidebarContent, p as SidebarSubGroup, r as SidebarGroup, s as SidebarItems, v as ComponentRoute, x as OnThisPageProps } from "./sidebar-7gIifpBX.cjs";
+import { T as BoltdocsConfig, a as SidebarItem, d as SidebarMobile, f as SidebarRoot, i as SidebarHeader, l as SidebarLink, n as SidebarContent, p as SidebarSubGroup, r as SidebarGroup, s as SidebarItems, v as ComponentRoute, x as OnThisPageProps } from "./sidebar-DH2iPKXM.cjs";
 import { ReactNode } from "react";
 import * as _$react_jsx_runtime0 from "react/jsx-runtime";
 

package/dist/{banner-CfdalYLL.d.ts → banner-DjujkctF.d.ts}

@@ -1,5 +1,5 @@
 
-import { T as BoltdocsConfig, a as SidebarItem, d as SidebarMobile, f as SidebarRoot, i as SidebarHeader, l as SidebarLink, n as SidebarContent, p as SidebarSubGroup, r as SidebarGroup, s as SidebarItems, v as ComponentRoute, x as OnThisPageProps } from "./sidebar-BAKgJ-Er.js";
+import { T as BoltdocsConfig, a as SidebarItem, d as SidebarMobile, f as SidebarRoot, i as SidebarHeader, l as SidebarLink, n as SidebarContent, p as SidebarSubGroup, r as SidebarGroup, s as SidebarItems, v as ComponentRoute, x as OnThisPageProps } from "./sidebar-DknLUI1R.js";
 import { ReactNode } from "react";
 import * as _$react_jsx_runtime0 from "react/jsx-runtime";
 

package/dist/cache-B0C2i0yP.mjs

@@ -0,0 +1,6 @@
+/**
+ * Boltdocs - https://boltdocs.vercel.app
+ * Copyright (c) 2026 Jesus Alcala
+ * Licensed under the MIT License.
+ */
+import{o as e}from"./utils-B3xYMrpK.mjs";import{globalBackgroundQueue as t}from"./node/cache.mjs";import n from"node:path";import r from"node:fs";import i from"node:crypto";const a=new Map,o=()=>{let t=e();return n.resolve(process.cwd(),t.dir,`parser`)},s=`v2.5`;var c=class{static async get(t){if(e().noCache)return null;try{let e=await r.promises.stat(t),c=a.get(t);if(c&&c.mtime===e.mtimeMs)return c.data;let l=o(),u=i.createHash(`md5`).update(t).digest(`hex`),d=n.join(l,`${u}.json`);try{let n=await r.promises.readFile(d,`utf-8`),i=JSON.parse(n);return i._mtime!==e.mtimeMs||i._v!==s?null:(a.set(t,{data:i.data,mtime:i._mtime}),i.data)}catch{return null}}catch{return null}}static async set(c,l){if(!e().noCache)try{let e=await r.promises.stat(c);a.set(c,{data:l,mtime:e.mtimeMs});let u=o(),d=i.createHash(`md5`).update(c).digest(`hex`),f=n.join(u,`${d}.json`),p={_v:s,_mtime:e.mtimeMs,data:l};t.add(async()=>{try{await r.promises.mkdir(u,{recursive:!0}),await r.promises.writeFile(f,JSON.stringify(p))}catch{}})}catch{}}static invalidate(e){a.delete(e)}static clear(){a.clear();let e=o();if(r.existsSync(e))try{r.rmSync(e,{recursive:!0,force:!0})}catch{}}};export{c as t};

package/dist/cache-CfRTUzWC.cjs

@@ -0,0 +1,6 @@
+/**
+ * Boltdocs - https://boltdocs.vercel.app
+ * Copyright (c) 2026 Jesus Alcala
+ * Licensed under the MIT License.
+ */
+const e=require(`./chunk-Ds5LZdWN.cjs`),t=require(`./utils-Bz1tG9Dg.cjs`),n=require(`./node/cache.cjs`);let r=require(`node:path`);r=e.n(r);let i=require(`node:fs`);i=e.n(i);let a=require(`node:crypto`);a=e.n(a);const o=new Map,s=()=>{let e=t.o();return r.default.resolve(process.cwd(),e.dir,`parser`)},c=`v2.5`;var l=class{static async get(e){if(t.o().noCache)return null;try{let t=await i.default.promises.stat(e),n=o.get(e);if(n&&n.mtime===t.mtimeMs)return n.data;let l=s(),u=a.default.createHash(`md5`).update(e).digest(`hex`),d=r.default.join(l,`${u}.json`);try{let n=await i.default.promises.readFile(d,`utf-8`),r=JSON.parse(n);return r._mtime!==t.mtimeMs||r._v!==c?null:(o.set(e,{data:r.data,mtime:r._mtime}),r.data)}catch{return null}}catch{return null}}static async set(e,l){if(!t.o().noCache)try{let t=await i.default.promises.stat(e);o.set(e,{data:l,mtime:t.mtimeMs});let u=s(),d=a.default.createHash(`md5`).update(e).digest(`hex`),f=r.default.join(u,`${d}.json`),p={_v:c,_mtime:t.mtimeMs,data:l};n.globalBackgroundQueue.add(async()=>{try{await i.default.promises.mkdir(u,{recursive:!0}),await i.default.promises.writeFile(f,JSON.stringify(p))}catch{}})}catch{}}static invalidate(e){o.delete(e)}static clear(){o.clear();let e=s();if(i.default.existsSync(e))try{i.default.rmSync(e,{recursive:!0,force:!0})}catch{}}};Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return l}});

package/dist/chunk-hT5z_Zn9-DsJawvsz.mjs

@@ -0,0 +1,6 @@
+/**
+ * Boltdocs - https://boltdocs.vercel.app
+ * Copyright (c) 2026 Jesus Alcala
+ * Licensed under the MIT License.
+ */
+import{createRequire as e}from"node:module";var t=Object.create,n=Object.defineProperty,r=Object.getOwnPropertyDescriptor,i=Object.getOwnPropertyNames,a=Object.getPrototypeOf,o=Object.prototype.hasOwnProperty,s=(e,t)=>()=>(t||(e((t={exports:{}}).exports,t),e=null),t.exports),c=(e,t)=>{let r={};for(var i in e)n(r,i,{get:e[i],enumerable:!0});return t||n(r,Symbol.toStringTag,{value:`Module`}),r},l=(e,t,a,s)=>{if(t&&typeof t==`object`||typeof t==`function`)for(var c=i(t),l=0,u=c.length,d;l<u;l++)d=c[l],!o.call(e,d)&&d!==a&&n(e,d,{get:(e=>t[e]).bind(null,d),enumerable:!(s=r(t,d))||s.enumerable});return e},u=(e,r,i)=>(i=e==null?{}:t(a(e)),l(r||!e||!e.__esModule?n(i,`default`,{value:e,enumerable:!0}):i,e)),d=e(import.meta.url);export{u as i,c as n,d as r,s as t};

package/dist/chunk-hT5z_Zn9-SKz6VFXu.cjs

@@ -0,0 +1,6 @@
+/**
+ * Boltdocs - https://boltdocs.vercel.app
+ * Copyright (c) 2026 Jesus Alcala
+ * Licensed under the MIT License.
+ */
+require(`./chunk-Ds5LZdWN.cjs`);let e=require(`node:module`);var t=Object.create,n=Object.defineProperty,r=Object.getOwnPropertyDescriptor,i=Object.getOwnPropertyNames,a=Object.getPrototypeOf,o=Object.prototype.hasOwnProperty,s=(e,t)=>()=>(t||(e((t={exports:{}}).exports,t),e=null),t.exports),c=(e,t)=>{let r={};for(var i in e)n(r,i,{get:e[i],enumerable:!0});return t||n(r,Symbol.toStringTag,{value:`Module`}),r},l=(e,t,a,s)=>{if(t&&typeof t==`object`||typeof t==`function`)for(var c=i(t),l=0,u=c.length,d;l<u;l++)d=c[l],!o.call(e,d)&&d!==a&&n(e,d,{get:(e=>t[e]).bind(null,d),enumerable:!(s=r(t,d))||s.enumerable});return e},u=(e,r,i)=>(i=e==null?{}:t(a(e)),l(r||!e||!e.__esModule?n(i,`default`,{value:e,enumerable:!0}):i,e)),d=(0,e.createRequire)(require(`url`).pathToFileURL(__filename).href);Object.defineProperty(exports,`i`,{enumerable:!0,get:function(){return u}}),Object.defineProperty(exports,`n`,{enumerable:!0,get:function(){return c}}),Object.defineProperty(exports,`r`,{enumerable:!0,get:function(){return d}}),Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return s}});

package/dist/client/index.cjs

@@ -4,18 +4,18 @@
  * Licensed under the MIT License.
  */
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_icons_dev = require('../icons-dev-BryEFkJu.cjs');
-const require_image = require('../image-CR6UlaI5.cjs');
-const require_mdx = require('../mdx-DJBg5DuL.cjs');
-const require_docs_layout = require('../docs-layout-3TpAt6MB.cjs');
-const require_search_dialog = require('../search-dialog-D4rplZMv.cjs');
-const require_search_dialog$1 = require('../search-dialog-CwNh8lIN.cjs');
+const require_icons_dev = require('../icons-dev-YtDoLUsb.cjs');
+const require_image = require('../image-Hb105Gu6.cjs');
+const require_mdx = require('../mdx-CDUcJmye.cjs');
+const require_docs_layout = require('../docs-layout-D1buSdua.cjs');
+const require_search_dialog = require('../search-dialog-BpNULmrl.cjs');
+const require_search_dialog$1 = require('../search-dialog-BbtxA1uT.cjs');
 let react = require("react");
 let react_router_dom = require("react-router-dom");
 let react_jsx_runtime = require("react/jsx-runtime");
+let react_aria_components = require("react-aria-components");
 let react_helmet_async = require("react-helmet-async");
 react_helmet_async = require_icons_dev.__toESM(react_helmet_async);
-let react_aria_components = require("react-aria-components");
 let virtual_boltdocs_mdx_components = require("virtual:boltdocs-mdx-components");
 virtual_boltdocs_mdx_components = require_icons_dev.__toESM(virtual_boltdocs_mdx_components);
 let virtual_boltdocs_icons = require("virtual:boltdocs-icons");
@@ -55,20 +55,6 @@ function MdxComponentsProvider({ components, children }) {
 	});
 }
 
-//#endregion
-//#region src/client/app/helmet-compat.tsx
-const mod = react_helmet_async;
-/**
-* The `<Helmet>` component, resolved across CJS/ESM module shapes.
-* Falls back to a transparent fragment wrapper if the module cannot be resolved.
-*/
-const Helmet = mod.Helmet || mod.default?.Helmet || (({ children }) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_jsx_runtime.Fragment, { children }));
-/**
-* The `<HelmetProvider>` component, resolved across CJS/ESM module shapes.
-* Falls back to a transparent fragment wrapper if the module cannot be resolved.
-*/
-const HelmetProvider = mod.HelmetProvider || mod.default?.HelmetProvider || (({ children }) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_jsx_runtime.Fragment, { children }));
-
 //#endregion
 //#region src/client/app/scroll-handler.tsx
 /**
@@ -161,6 +147,28 @@ const mdxComponentsDefault = {
 	"404": NotFound
 };
 
+//#endregion
+//#region src/client/app/helmet-compat.tsx
+const mod = react_helmet_async;
+/**
+* The `<Helmet>` component, resolved across CJS/ESM module shapes.
+* Falls back to a transparent fragment wrapper if the module cannot be resolved.
+*/
+const Helmet = mod.Helmet || mod.default?.Helmet || (({ children }) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_jsx_runtime.Fragment, { children }));
+/**
+* The `<HelmetProvider>` component, resolved across CJS/ESM module shapes.
+* Falls back to a transparent fragment wrapper if the module cannot be resolved.
+*/
+const HelmetProvider = mod.HelmetProvider || mod.default?.HelmetProvider || (({ children }) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_jsx_runtime.Fragment, { children }));
+if (typeof globalThis !== "undefined" && globalThis.__BOLTDOCS_SSG_RENDERING__) {
+	const hp = HelmetProvider;
+	if (hp && typeof hp === "function" && hp.canUseDOM) hp.canUseDOM = false;
+}
+if (typeof globalThis !== "undefined") {
+	globalThis.__BOLTDOCS_HELMET_PROVIDER__ = HelmetProvider;
+	globalThis.__BOLTDOCS_HELMET__ = Helmet;
+}
+
 //#endregion
 //#region src/client/utils/i18n.ts
 /**
@@ -313,6 +321,16 @@ const CollectionsContext = (0, react.createContext)({});
 function useCollectionsData() {
 	return (0, react.use)(CollectionsContext);
 }
+const CurrentPostContext = (0, react.createContext)(null);
+function CurrentPostProvider({ value, children }) {
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CurrentPostContext.Provider, {
+		value,
+		children
+	});
+}
+function useCurrentPostData() {
+	return (0, react.use)(CurrentPostContext);
+}
 
 //#endregion
 //#region src/client/ssg/boltdocs-shell.tsx
@@ -382,7 +400,7 @@ function BoltdocsShell({ config, routes, components = {}, collectionsData }) {
 		config,
 		routeMap
 	]);
-	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(HelmetProvider, { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_icons_dev.RoutesProvider, {
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_icons_dev.RoutesProvider, {
 		routes,
 		children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_image.ThemeProvider, { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(require_docs_layout.UIProvider, { children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(MdxComponentsProvider, {
 			components: allComponents,
@@ -410,7 +428,7 @@ function BoltdocsShell({ config, routes, components = {}, collectionsData }) {
 				})
 			})
 		}) }) })
-	}) });
+	});
 }
 
 //#endregion
@@ -455,17 +473,43 @@ function DocPage({ route, content: Content, mdxComponents: propComponents }) {
 /**
 * Renders an MDX page by consuming pre-loaded route data.
 *
-* - If the route belongs to a collection (`data.collection` is set), renders
-*   the custom post component if provided, else falls back to the standard DocPage.
+* - If the route belongs to a collection (`data.collection` is set), wraps
+*   the content with `CurrentPostProvider` so that `usePost()` (called without
+*   a slug) can read the current post's data from context.
 * - Otherwise, renders the standard `DocPage` layout.
 */
 function MdxPage({ MDXComponent, mdxComponents: propComponents, collectionPostComponent: CollectionPost }) {
 	const data = (0, react_router_dom.useLoaderData)();
 	if (!MDXComponent) return null;
-	if (!!data?.collection && CollectionPost) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CollectionPost, {
-		MDXComponent,
-		mdxComponents: propComponents
-	});
+	const collectionData = data;
+	if (!!collectionData?.collection) {
+		const postElement = CollectionPost ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CollectionPost, {
+			MDXComponent,
+			mdxComponents: propComponents
+		}) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)(DocPage, {
+			route: {
+				path: collectionData.route.path,
+				filePath: collectionData.route.filePath,
+				title: collectionData.route.title,
+				description: collectionData.route.description,
+				headings: collectionData.headings,
+				locale: collectionData.route.locale,
+				version: collectionData.route.version,
+				lastUpdated: collectionData.route.lastUpdated,
+				frontmatter: collectionData.route.frontmatter
+			},
+			content: MDXComponent,
+			mdxComponents: propComponents
+		});
+		return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CurrentPostProvider, {
+			value: {
+				route: collectionData.route,
+				headings: collectionData.headings,
+				collection: collectionData.collection
+			},
+			children: postElement
+		});
+	}
 	const docData = data;
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(DocPage, {
 		route: {
@@ -1028,7 +1072,7 @@ function VersionSelector({ className }) {
 function useI18n() {
 	const navigate = (0, react_router_dom.useNavigate)();
 	const config = require_icons_dev.useConfig();
-	const { allRoutes, currentRoute, currentLocale, currentVersion } = require_icons_dev.useRoutes();
+	const { allRoutes, currentRoute, currentLocale, isCollectionPage } = require_icons_dev.useRoutes();
 	const i18n = config.i18n;
 	const { setLocale } = require_icons_dev.useBoltdocsContext();
 	const handleLocaleChange = (locale) => {
@@ -1038,7 +1082,7 @@ function useI18n() {
 		const safeBase = base === "/" ? "" : base.replace(/\/$/, "");
 		const isDocRoute = !!currentRoute?.filePath;
 		let targetPath = "";
-		if (currentRoute) if (isDocRoute) {
+		if (currentRoute) if (isDocRoute && !currentRoute.collection && !isCollectionPage) {
 			const baseFile = getBaseFilePath(currentRoute.filePath, currentRoute.version, currentRoute.locale);
 			const targetRoute = allRoutes.find((r) => getBaseFilePath(r.filePath, r.version, r.locale) === baseFile && (r.locale || i18n.defaultLocale) === locale && r.version === currentRoute.version);
 			if (targetRoute) targetPath = targetRoute.path;
@@ -1050,25 +1094,29 @@ function useI18n() {
 		} else {
 			let rawExternal = currentRoute.path;
 			const parts = rawExternal.split("/").filter(Boolean);
-			if (parts.length > 0 && (Array.isArray(i18n.locales) ? i18n.locales.includes(parts[0]) : !!i18n.locales[parts[0]])) {
-				parts.shift();
+			const localePosition = currentRoute.collection ? 1 : 0;
+			if (parts.length > localePosition && (Array.isArray(i18n.locales) ? i18n.locales.includes(parts[localePosition]) : !!i18n.locales[parts[localePosition]])) {
+				parts.splice(localePosition, 1);
 				rawExternal = "/" + parts.join("/");
 			}
+			const cleanParts = rawExternal.split("/").filter(Boolean);
 			if (locale === i18n.defaultLocale) targetPath = rawExternal === "" ? "/" : rawExternal;
 			else {
-				const cleanExt = rawExternal.startsWith("/") ? rawExternal : `/${rawExternal}`;
-				targetPath = `/${locale}${cleanExt === "/" ? "" : cleanExt}`;
+				cleanParts.splice(localePosition, 0, locale);
+				targetPath = "/" + cleanParts.join("/") || "/";
 			}
 		}
 		else {
-			const targetRoute = allRoutes.find((r) => (r.locale || i18n.defaultLocale) === locale && (r.version || config.versions?.defaultVersion) === (currentVersion || config.versions?.defaultVersion));
-			if (targetRoute) targetPath = targetRoute.path;
+			const currentPath = location.pathname;
+			if (isCollectionPage) targetPath = currentPath;
 			else {
-				const vPath = currentVersion && currentVersion !== config.versions?.defaultVersion ? `/${currentVersion}` : "";
-				targetPath = locale === i18n.defaultLocale ? `${safeBase}${vPath}` : `${safeBase}${vPath}/${locale}`;
+				const parts = currentPath.split("/").filter(Boolean);
+				if (parts.length > 0 && (Array.isArray(i18n.locales) ? i18n.locales.includes(parts[0]) : !!i18n.locales[parts[0]])) parts.shift();
+				if (locale !== i18n.defaultLocale) parts.unshift(locale);
+				targetPath = "/" + parts.join("/");
 			}
 		}
-		if (!targetPath || targetPath === "") targetPath = "/";
+		if (!targetPath || targetPath === "") targetPath = "/s";
 		targetPath = targetPath.replace(/\/+/g, "/");
 		navigate(targetPath);
 	};
@@ -1152,10 +1200,42 @@ function usePageNav() {
 //#region src/client/hooks/use-analytics.ts
 function createAnalyticsInstance(config) {
 	if (typeof window === "undefined") return createDisabledAnalytics();
+	if (window.posthog) return createPostHogAnalytics(config);
 	if (typeof window.gtag === "function") return createGtagAnalytics(config);
 	if (window.dataLayer) return createDataLayerAnalytics(config);
 	return createDisabledAnalytics();
 }
+function createPostHogAnalytics(_config) {
+	return {
+		trackPageView: (path) => {
+			window.posthog?.capture("$pageview", { $current_url: path });
+		},
+		trackEvent: ({ action, category, label, value, params }) => {
+			window.posthog?.capture(action, {
+				event_category: category,
+				event_label: label,
+				value,
+				...params
+			});
+		},
+		trackSearch: (query, resultsCount) => {
+			window.posthog?.capture("search", {
+				query,
+				results_count: resultsCount
+			});
+		},
+		trackDownload: (file, type) => {
+			window.posthog?.capture("file_download", {
+				file_name: file,
+				file_type: type || file.split(".").pop()
+			});
+		},
+		trackExternalLink: (url) => {
+			window.posthog?.capture("external_link", { link_url: url });
+		},
+		isEnabled: true
+	};
+}
 function createGtagAnalytics(config) {
 	return {
 		trackPageView: (path, title) => {
@@ -1439,7 +1519,7 @@ function I18nSelector({ className }) {
 
 //#endregion
 //#region src/client/components/ui-base/navbar.tsx
-const SearchDialog$1 = (0, react.lazy)(() => Promise.resolve().then(() => require("../search-dialog-cHJoKjts.cjs")).then((m) => ({ default: m.SearchDialog })));
+const SearchDialog$1 = (0, react.lazy)(() => Promise.resolve().then(() => require("../search-dialog-BIuxGQsg.cjs")).then((m) => ({ default: m.SearchDialog })));
 function Navbar() {
 	const { links, title, logo, logoProps, github, social, config } = useNavbar();
 	const { routes, currentRoute, isCollectionPage, currentVersion, currentLocale } = require_icons_dev.useRoutes();
@@ -1470,6 +1550,10 @@ function Navbar() {
 						href: "site:/",
 						children: title
 					}),
+					currentRoute?.draft && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+						className: "hidden sm:inline-flex items-center px-2 py-0.5 rounded-full text-xs font-medium bg-yellow-100 text-yellow-800 dark:bg-yellow-900/30 dark:text-yellow-400 border border-yellow-200 dark:border-yellow-800",
+						children: "Draft"
+					}),
 					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 						className: "hidden sm:block",
 						children: config.versions && currentVersion && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(VersionSelector, {})
@@ -2200,21 +2284,107 @@ function buildExternalRoutes(options) {
 	};
 }
 
+//#endregion
+//#region src/client/collections/hooks.ts
+const DEFAULT_COLLECTION = "blog";
+/**
+* Returns the posts of a collection, filtered by the current locale and version.
+* Defaults to "blog" if no collection is specified.
+* @param collection - The name of the collection. Defaults to "blog".
+* @param options - Options to customize the query.
+* @param options.includeDrafts - If true, includes draft posts in the results.
+* @returns The filtered posts of the collection.
+*/
+function usePosts(collection = DEFAULT_COLLECTION, options) {
+	const data = useCollectionsData();
+	const { currentLocale, currentVersion } = require_icons_dev.useRoutes();
+	const config = require_icons_dev.useConfig();
+	const posts = data[collection] || [];
+	const defaultLocale = config.i18n?.defaultLocale;
+	const defaultVersion = config.versions?.defaultVersion;
+	return (0, react.useMemo)(() => {
+		return posts.filter((post) => {
+			const postLocale = post.locale || defaultLocale;
+			const postVersion = post.version || defaultVersion;
+			const localeMatch = !currentLocale || postLocale === currentLocale;
+			const versionMatch = !currentVersion || postVersion === currentVersion;
+			const draftMatch = options?.includeDrafts || !post.draft;
+			return localeMatch && versionMatch && draftMatch;
+		});
+	}, [
+		posts,
+		currentLocale,
+		currentVersion,
+		defaultLocale,
+		defaultVersion,
+		options?.includeDrafts
+	]);
+}
+function usePost(collection, slug) {
+	const ctx = useCurrentPostData();
+	const posts = usePosts(collection);
+	if (ctx && !slug) {
+		const { route } = ctx;
+		return (0, react.useMemo)(() => ({
+			path: route.path,
+			title: route.title,
+			date: route.date,
+			excerpt: route.excerpt,
+			tags: route.tags,
+			author: route.author,
+			coverImage: route.coverImage,
+			filePath: route.filePath,
+			locale: route.locale,
+			version: route.version,
+			frontmatter: route.frontmatter,
+			lastUpdated: route.lastUpdated,
+			headings: route.headings
+		}), [route]);
+	}
+	if (!collection || !slug) return void 0;
+	return (0, react.useMemo)(() => posts.find((p) => p.path === `/${collection}/${slug}` || p.path.endsWith(`/${slug}`) || p.path === slug), [
+		posts,
+		collection,
+		slug
+	]);
+}
+/**
+* Returns the recent posts of a collection. Defaults to "blog".
+* @param collection - The name of the collection. Defaults to "blog".
+* @param count - The number of recent posts to return.
+* @returns The recent posts of the collection.
+*/
+function useRecentPosts(collection = DEFAULT_COLLECTION, count = 5) {
+	const posts = usePosts(collection);
+	return (0, react.useMemo)(() => posts.slice(0, count), [posts, count]);
+}
+
 //#endregion
 //#region src/client/ssg/create-routes.collection.tsx
 function DefaultCollectionList() {
-	const data = (0, react_router_dom.useLoaderData)();
-	if (!data || !data.posts) return null;
+	const location = (0, react_router_dom.useLocation)();
+	const config = require_icons_dev.useConfig();
+	const postsPerPage = config.collections?.postsPerPage ?? 10;
+	const segments = location.pathname.split("/").filter(Boolean);
+	const isLocalePrefixed = config.i18n && segments[0] in (config.i18n.locales || {});
+	const collection = isLocalePrefixed ? segments[1] : segments[0];
+	const currentPage = (isLocalePrefixed ? segments[3] : segments[2]) === "page" ? Number(isLocalePrefixed ? segments[4] : segments[3]) || 1 : 1;
+	const allPosts = usePosts(collection);
+	const totalPages = Math.ceil(allPosts.length / postsPerPage);
+	const start = (currentPage - 1) * postsPerPage;
+	const posts = allPosts.slice(start, start + postsPerPage);
+	if (!posts.length) return null;
+	const basePath = isLocalePrefixed ? `/${segments[0]}/${segments[1]}` : `/${segments[0]}`;
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 		className: "py-8 max-w-2xl mx-auto px-4",
 		children: [
 			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h1", {
 				className: "text-3xl font-bold mb-6 capitalize",
-				children: data.collection
+				children: collection
 			}),
 			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
 				className: "space-y-6",
-				children: data.posts.map((post) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("article", {
+				children: posts.map((post) => /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("article", {
 					className: "border-b border-subtle pb-4",
 					children: [
 						/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h2", {
@@ -2236,22 +2406,22 @@ function DefaultCollectionList() {
 					]
 				}, post.path))
 			}),
-			data.totalPages > 1 && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+			totalPages > 1 && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 				className: "mt-8 flex gap-4 text-sm",
 				children: [
-					data.currentPage > 1 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_router_dom.Link, {
-						to: data.currentPage === 2 ? `/${data.collection}` : `/${data.collection}/page/${data.currentPage - 1}`,
+					currentPage > 1 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_router_dom.Link, {
+						to: currentPage === 2 ? basePath : `${basePath}/page/${currentPage - 1}`,
 						className: "text-primary-600 hover:underline",
 						children: "Previous"
 					}),
 					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", { children: [
 						"Page ",
-						data.currentPage,
+						currentPage,
 						" of ",
-						data.totalPages
+						totalPages
 					] }),
-					data.currentPage < data.totalPages && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_router_dom.Link, {
-						to: `/${data.collection}/page/${data.currentPage + 1}`,
+					currentPage < totalPages && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_router_dom.Link, {
+						to: `${basePath}/page/${currentPage + 1}`,
 						className: "text-primary-600 hover:underline",
 						children: "Next"
 					})
@@ -2342,6 +2512,9 @@ function buildCollectionRoutes(options) {
 			author: r.author,
 			coverImage: r.coverImage,
 			filePath: r.filePath,
+			locale: r.locale,
+			version: r.version,
+			lastUpdated: r.lastUpdated,
 			frontmatter: r.frontmatter
 		}));
 		const ListElement = collectionLists?.[colName] || DefaultCollectionList;
@@ -2422,18 +2595,6 @@ function createRoutes(options) {
 function DocsLayoutComponent({ children }) {
 	const { routes: filteredRoutes, currentRoute, isCollectionPage } = require_icons_dev.useRoutes();
 	const config = require_icons_dev.useConfig();
-	const AskAiDialog = useMergedComponents().AskAiDialog;
-	const [isAskAiOpen, setIsAskAiOpen] = (0, react.useState)(false);
-	(0, react.useEffect)(() => {
-		const handleOpen = () => setIsAskAiOpen(true);
-		const handleClose = () => setIsAskAiOpen(false);
-		window.addEventListener("boltdocs:ask-ai:open", handleOpen);
-		window.addEventListener("boltdocs:ask-ai:close", handleClose);
-		return () => {
-			window.removeEventListener("boltdocs:ask-ai:open", handleOpen);
-			window.removeEventListener("boltdocs:ask-ai:close", handleClose);
-		};
-	}, []);
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_docs_layout.DocsLayout, {
 		className: "selection:bg-primary-500/10 selection:text-primary-500",
 		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Navbar, {}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(require_docs_layout.DocsLayout.Body, {
@@ -2475,8 +2636,7 @@ function DocsLayoutComponent({ children }) {
 						]
 					})
 				}),
-				AskAiDialog && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(AskAiDialog, {}),
-				!isCollectionPage && !isAskAiOpen && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(OnThisPage, {
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)(OnThisPage, {
 					headings: currentRoute?.headings,
 					filePath: currentRoute?.filePath,
 					communityHelp: config.theme?.communityHelp,
@@ -2487,41 +2647,6 @@ function DocsLayoutComponent({ children }) {
 	});
 }
 
-//#endregion
-//#region src/client/collections/hooks.ts
-/**
-* Returns the posts of a collection.
-* @param collection - The name of the collection.
-* @returns The posts of the collection.
-*/
-function usePosts(collection) {
-	return useCollectionsData()[collection] || [];
-}
-/**
-* Returns a post by its slug.
-* @param collection - The name of the collection.
-* @param slug - The slug of the post.
-* @returns The post with the given slug.
-*/
-function usePost(collection, slug) {
-	const posts = usePosts(collection);
-	return (0, react.useMemo)(() => posts.find((p) => p.path === `/${collection}/${slug}` || p.path.endsWith(`/${slug}`) || p.path === slug), [
-		posts,
-		collection,
-		slug
-	]);
-}
-/**
-* Returns the recent posts of a collection.
-* @param collection - The name of the collection.
-* @param count - The number of recent posts to return.
-* @returns The recent posts of the collection.
-*/
-function useRecentPosts(collection, count = 5) {
-	const posts = usePosts(collection);
-	return (0, react.useMemo)(() => posts.slice(0, count), [posts, count]);
-}
-
 //#endregion
 //#region src/client/utils/react-to-text.ts
 const reactToText = (node, resolvers) => {
@@ -2542,6 +2667,7 @@ exports.BoltdocsShell = BoltdocsShell;
 exports.Breadcrumbs = Breadcrumbs;
 exports.CollectionsContext = CollectionsContext;
 exports.CopyMarkdown = CopyMarkdown;
+exports.CurrentPostProvider = CurrentPostProvider;
 exports.DocsLayout = DocsLayoutComponent;
 exports.ErrorBoundary = ErrorBoundary;
 exports.MdxPage = MdxPage;