boltdocs 2.7.9 → 2.7.11

package/dist/utils-BxNAXhZZ.mjs

@@ -1,7 +0,0 @@
-/**
- * Boltdocs - https://boltdocs.vercel.app
- * Copyright (c) 2026 Jesus Alcala
- * Licensed under the MIT License.
- */
-import e from"fs";import t from"isomorphic-dompurify";import{z as n}from"zod";const r=/^[a-zA-Z0-9\-_/.()]+$/,i=n.looseObject({title:n.string().max(200).optional(),description:n.string().max(500).optional(),permalink:n.string().optional(),sidebarPosition:n.number().optional(),sidebarLabel:n.string().max(100).optional(),sidebarHidden:n.boolean().optional(),hidden:n.boolean().optional(),category:n.string().max(50).optional(),order:n.number().optional(),badge:n.union([n.string().max(50),n.object({text:n.string().max(50),expires:n.string().optional()})]).optional(),icon:n.string().max(50).optional(),date:n.union([n.string(),n.date()]).optional(),lastUpdated:n.union([n.string(),n.date()]).optional(),groupTitle:n.string().max(100).optional(),groupPosition:n.number().optional(),seo:n.record(n.any()).optional()});function a(e){let t=e.trim();if(!t.startsWith(`---`))return{data:{},content:e,rawMatter:``};let n=t.indexOf(`---`,3);if(n===-1||n===3)return{data:{},content:e,rawMatter:``};let r=t.slice(3,n).trim(),i=t.slice(n+3).trim();return o(r)?{data:{},content:i,rawMatter:r}:{data:s(r),content:i,rawMatter:r}}function o(e){let t=!1,n=!1;for(let r=0;r<e.length;r++){let i=e[r],a=r>0?e[r-1]:``;i===`'`&&!n&&a!==`\\`?t=!t:i===`"`&&!t&&a!==`\\`&&(n=!n)}return t||n}function s(e){let t=e.split(`
-`),n={},r=0;for(;r<t.length;){let e=t[r],i=e.trim();if(!i||i.startsWith(`#`)){r++;continue}let a=i.indexOf(`:`);if(a!==-1){let o=i.slice(0,a).trim(),s=i.slice(a+1).trim();if(s===``){let i=c(t.slice(r+1),e.search(/\S|$/));i.value===void 0?r++:(n[o]=i.value,r+=i.linesConsumed)}else n[o]=l(s),r++}else r++}return n}function c(e,t){if(e.length===0)return{value:void 0,linesConsumed:0};if(e[0].trim().startsWith(`-`)){let n=[],r=0;for(;r<e.length;){let i=e[r],a=i.search(/\S|$/),o=i.trim();if(!o||o.startsWith(`#`)){r++;continue}if(o.startsWith(`-`)){let e=o.slice(1).trim();if(e.includes(`:`)){let t={},r=e.split(/,\s*/);for(let e of r){let n=e.indexOf(`:`);if(n!==-1){let r=e.slice(0,n).trim();t[r]=l(e.slice(n+1).trim())}}n.push(t)}else n.push(e)}else if(a>t&&n.length>0){let e=n[n.length-1];if(typeof e==`object`&&e){let t=e,n=o.indexOf(`:`);if(n!==-1){let e=o.slice(0,n).trim();t[e]=l(o.slice(n+1).trim())}}}else break;r++}return{value:n.length>0?n:void 0,linesConsumed:r}}let n={},r=0;for(;r<e.length;){let i=e[r],a=i.search(/\S|$/),o=i.trim();if(!o||o.startsWith(`#`)){r++;continue}if(a<=t)break;let s=o.indexOf(`:`);if(s!==-1){let e=o.slice(0,s).trim();n[e]=l(o.slice(s+1).trim())}r++}return{value:Object.keys(n).length>0?n:void 0,linesConsumed:r}}function l(e){let t=e.trim();if(t===`true`)return!0;if(t===`false`)return!1;if(t===`null`||t===`~`)return null;if(/^-?\d+(\.\d+)?$/.test(t))return Number(t);if(t.startsWith(`"`)&&t.endsWith(`"`)||t.startsWith(`'`)&&t.endsWith(`'`))return t.slice(1,-1);if(t.startsWith(`{`)&&t.endsWith(`}`)){let e=t.slice(1,-1).trim(),n={},r=e.split(/,\s*/);for(let e of r){let t=e.indexOf(`:`);if(t!==-1){let r=e.slice(0,t).trim();n[r]=l(e.slice(t+1).trim())}}return n}return t}var u=class e extends Error{constructor(t){super(t),this.name=`SecurityViolationError`,Object.setPrototypeOf(this,e.prototype)}},d=class e extends u{constructor(t){super(t),this.name=`PathTraversalError`,Object.setPrototypeOf(this,e.prototype)}},f=class e extends u{constructor(t){super(t),this.name=`EncodingSecurityError`,Object.setPrototypeOf(this,e.prototype)}},p=class e extends u{constructor(t){super(t),this.name=`ValidationError`,Object.setPrototypeOf(this,e.prototype)}};function m(e){return e.replace(/\\/g,`/`)}function h(e){return e.replace(/^\d+\./,``)}function g(e){let t=e.match(/^(\d+)\./);return t?parseInt(t[1],10):void 0}function _(e){return/\.mdx?$/.test(e)}function v(t){try{return e.statSync(t).mtimeMs}catch{return 0}}async function y(t,n=!0){let r=``;try{r=await e.promises.readFile(t,`utf-8`);let{data:o,content:s,rawMatter:c}=a(r);if(c&&c.length>10240)throw D(`FRONTMATTER_TOO_LARGE`,`Frontmatter block exceeds size limit`,{size:c.length,file:t}),new p(`Security breach: Frontmatter size exceeds limit of 10240 bytes`);if(!n)return{data:o,content:s,raw:r};let l=i.safeParse(o),u={...l.success?l.data:{}};return u.lastUpdated||=(await e.promises.stat(t)).mtimeMs,u.title&&=w(u.title).trim(),u.description&&=w(u.description).trim(),{data:u,content:s,raw:r}}catch(e){if(e instanceof p)throw e;return{data:{},content:r,raw:r}}}function b(e){return e.replace(/&/g,`&amp;`).replace(/"/g,`&quot;`).replace(/'/g,`&apos;`).replace(/</g,`&lt;`).replace(/>/g,`&gt;`)}function x(e){return b(e)}function S(e){let t=m(e).split(`/`).map(e=>E(h(e))).join(`/`).replace(/\/$/,``);return t=t.replace(/\.mdx?$/,``),(t===`index`||t.endsWith(`/index`))&&(t=t.replace(/index$/,``)),t.startsWith(`/`)||(t=`/`+t),t.length>1&&t.endsWith(`/`)&&(t=t.slice(0,-1)),t}function C(e){return t.sanitize(e,{ALLOWED_TAGS:`b.i.em.strong.a.p.br.code.pre.span.div.h1.h2.h3.h4.h5.h6.ul.ol.li.table.thead.tbody.tr.th.td.blockquote.hr`.split(`.`),ALLOWED_ATTR:[`href`,`title`,`target`,`class`,`id`,`src`,`alt`,`width`,`height`],FORCE_BODY:!0})}t.addHook(`afterSanitizeAttributes`,e=>{if(e.hasAttribute(`href`)){let t=e.getAttribute(`href`)?.toLowerCase()||``;(t.startsWith(`javascript:`)||t.startsWith(`data:`)||t.startsWith(`vbscript:`))&&e.removeAttribute(`href`)}if(e.hasAttribute(`src`)){let t=e.getAttribute(`src`)?.toLowerCase()||``;(t.startsWith(`javascript:`)||t.startsWith(`data:`)||t.startsWith(`vbscript:`))&&e.removeAttribute(`src`)}});function w(e){return e?e.replace(/<script\b[^<]*(?:(?!<\/script>)<[^<]*)*<\/script>/gi,``).replace(/<style\b[^<]*(?:(?!<\/style>)<[^<]*)*<\/style>/gi,``).replace(/<!--[\s\S]*?-->/g,``).replace(/<[^>]+>/g,` `).replace(/\s+/g,` `).trim():``}function T(e){return e.charAt(0).toUpperCase()+e.slice(1)}function E(e){return e.replace(/[^a-zA-Z0-9\-_/.]/g,``).split(`/`).filter(e=>e!==`..`&&e!==`.`).map(e=>e.replace(/\.\.+/g,`.`)).join(`/`)}function D(e,t,n={}){let r=new Date().toISOString(),i={...n};for(let e in i)typeof i[e]==`string`&&i[e].includes(`:`)&&(i[e]=i[e].split(/[\\/]/).pop()||i[e]);console.error(`[SECURITY][${r}] TYPE: ${e} | MESSAGE: ${t} | DETAILS: ${JSON.stringify(i)}`)}function O(){return{dir:process.env.BOLTDOCS_CACHE_DIR||`.boltdocs`,noCache:process.env.BOLTDOCS_NO_CACHE===`1`,lruLimit:parseInt(process.env.BOLTDOCS_CACHE_LRU_LIMIT||`2000`,10),lruTTL:parseInt(process.env.BOLTDOCS_CACHE_LRU_TTL||`14400000`,10),compress:process.env.BOLTDOCS_CACHE_COMPRESS!==`0`}}export{p as _,O as a,D as c,E as d,C as f,d as g,f as h,S as i,m as l,h as m,x as n,v as o,w as p,g as r,_ as s,T as t,y as u,i as v,r as y};

package/dist/utils-Clzu7jvb.cjs

@@ -1,7 +0,0 @@
-/**
- * Boltdocs - https://boltdocs.vercel.app
- * Copyright (c) 2026 Jesus Alcala
- * Licensed under the MIT License.
- */
-const e=require(`./chunk-Ds5LZdWN.cjs`);let t=require(`fs`);t=e.n(t);let n=require(`isomorphic-dompurify`);n=e.n(n);let r=require(`zod`);const i=/^[a-zA-Z0-9\-_/.()]+$/,a=r.z.looseObject({title:r.z.string().max(200).optional(),description:r.z.string().max(500).optional(),permalink:r.z.string().optional(),sidebarPosition:r.z.number().optional(),sidebarLabel:r.z.string().max(100).optional(),sidebarHidden:r.z.boolean().optional(),hidden:r.z.boolean().optional(),category:r.z.string().max(50).optional(),order:r.z.number().optional(),badge:r.z.union([r.z.string().max(50),r.z.object({text:r.z.string().max(50),expires:r.z.string().optional()})]).optional(),icon:r.z.string().max(50).optional(),date:r.z.union([r.z.string(),r.z.date()]).optional(),lastUpdated:r.z.union([r.z.string(),r.z.date()]).optional(),groupTitle:r.z.string().max(100).optional(),groupPosition:r.z.number().optional(),seo:r.z.record(r.z.any()).optional()});function o(e){let t=e.trim();if(!t.startsWith(`---`))return{data:{},content:e,rawMatter:``};let n=t.indexOf(`---`,3);if(n===-1||n===3)return{data:{},content:e,rawMatter:``};let r=t.slice(3,n).trim(),i=t.slice(n+3).trim();return s(r)?{data:{},content:i,rawMatter:r}:{data:c(r),content:i,rawMatter:r}}function s(e){let t=!1,n=!1;for(let r=0;r<e.length;r++){let i=e[r],a=r>0?e[r-1]:``;i===`'`&&!n&&a!==`\\`?t=!t:i===`"`&&!t&&a!==`\\`&&(n=!n)}return t||n}function c(e){let t=e.split(`
-`),n={},r=0;for(;r<t.length;){let e=t[r],i=e.trim();if(!i||i.startsWith(`#`)){r++;continue}let a=i.indexOf(`:`);if(a!==-1){let o=i.slice(0,a).trim(),s=i.slice(a+1).trim();if(s===``){let i=l(t.slice(r+1),e.search(/\S|$/));i.value===void 0?r++:(n[o]=i.value,r+=i.linesConsumed)}else n[o]=u(s),r++}else r++}return n}function l(e,t){if(e.length===0)return{value:void 0,linesConsumed:0};if(e[0].trim().startsWith(`-`)){let n=[],r=0;for(;r<e.length;){let i=e[r],a=i.search(/\S|$/),o=i.trim();if(!o||o.startsWith(`#`)){r++;continue}if(o.startsWith(`-`)){let e=o.slice(1).trim();if(e.includes(`:`)){let t={},r=e.split(/,\s*/);for(let e of r){let n=e.indexOf(`:`);if(n!==-1){let r=e.slice(0,n).trim();t[r]=u(e.slice(n+1).trim())}}n.push(t)}else n.push(e)}else if(a>t&&n.length>0){let e=n[n.length-1];if(typeof e==`object`&&e){let t=e,n=o.indexOf(`:`);if(n!==-1){let e=o.slice(0,n).trim();t[e]=u(o.slice(n+1).trim())}}}else break;r++}return{value:n.length>0?n:void 0,linesConsumed:r}}let n={},r=0;for(;r<e.length;){let i=e[r],a=i.search(/\S|$/),o=i.trim();if(!o||o.startsWith(`#`)){r++;continue}if(a<=t)break;let s=o.indexOf(`:`);if(s!==-1){let e=o.slice(0,s).trim();n[e]=u(o.slice(s+1).trim())}r++}return{value:Object.keys(n).length>0?n:void 0,linesConsumed:r}}function u(e){let t=e.trim();if(t===`true`)return!0;if(t===`false`)return!1;if(t===`null`||t===`~`)return null;if(/^-?\d+(\.\d+)?$/.test(t))return Number(t);if(t.startsWith(`"`)&&t.endsWith(`"`)||t.startsWith(`'`)&&t.endsWith(`'`))return t.slice(1,-1);if(t.startsWith(`{`)&&t.endsWith(`}`)){let e=t.slice(1,-1).trim(),n={},r=e.split(/,\s*/);for(let e of r){let t=e.indexOf(`:`);if(t!==-1){let r=e.slice(0,t).trim();n[r]=u(e.slice(t+1).trim())}}return n}return t}var d=class e extends Error{constructor(t){super(t),this.name=`SecurityViolationError`,Object.setPrototypeOf(this,e.prototype)}},f=class e extends d{constructor(t){super(t),this.name=`PathTraversalError`,Object.setPrototypeOf(this,e.prototype)}},p=class e extends d{constructor(t){super(t),this.name=`EncodingSecurityError`,Object.setPrototypeOf(this,e.prototype)}},m=class e extends d{constructor(t){super(t),this.name=`ValidationError`,Object.setPrototypeOf(this,e.prototype)}};function h(e){return e.replace(/\\/g,`/`)}function g(e){return e.replace(/^\d+\./,``)}function _(e){let t=e.match(/^(\d+)\./);return t?parseInt(t[1],10):void 0}function v(e){return/\.mdx?$/.test(e)}function y(e){try{return t.default.statSync(e).mtimeMs}catch{return 0}}async function b(e,n=!0){let r=``;try{r=await t.default.promises.readFile(e,`utf-8`);let{data:i,content:s,rawMatter:c}=o(r);if(c&&c.length>10240)throw O(`FRONTMATTER_TOO_LARGE`,`Frontmatter block exceeds size limit`,{size:c.length,file:e}),new m(`Security breach: Frontmatter size exceeds limit of 10240 bytes`);if(!n)return{data:i,content:s,raw:r};let l=a.safeParse(i),u={...l.success?l.data:{}};return u.lastUpdated||=(await t.default.promises.stat(e)).mtimeMs,u.title&&=T(u.title).trim(),u.description&&=T(u.description).trim(),{data:u,content:s,raw:r}}catch(e){if(e instanceof m)throw e;return{data:{},content:r,raw:r}}}function x(e){return e.replace(/&/g,`&amp;`).replace(/"/g,`&quot;`).replace(/'/g,`&apos;`).replace(/</g,`&lt;`).replace(/>/g,`&gt;`)}function S(e){return x(e)}function C(e){let t=h(e).split(`/`).map(e=>D(g(e))).join(`/`).replace(/\/$/,``);return t=t.replace(/\.mdx?$/,``),(t===`index`||t.endsWith(`/index`))&&(t=t.replace(/index$/,``)),t.startsWith(`/`)||(t=`/`+t),t.length>1&&t.endsWith(`/`)&&(t=t.slice(0,-1)),t}function w(e){return n.default.sanitize(e,{ALLOWED_TAGS:`b.i.em.strong.a.p.br.code.pre.span.div.h1.h2.h3.h4.h5.h6.ul.ol.li.table.thead.tbody.tr.th.td.blockquote.hr`.split(`.`),ALLOWED_ATTR:[`href`,`title`,`target`,`class`,`id`,`src`,`alt`,`width`,`height`],FORCE_BODY:!0})}n.default.addHook(`afterSanitizeAttributes`,e=>{if(e.hasAttribute(`href`)){let t=e.getAttribute(`href`)?.toLowerCase()||``;(t.startsWith(`javascript:`)||t.startsWith(`data:`)||t.startsWith(`vbscript:`))&&e.removeAttribute(`href`)}if(e.hasAttribute(`src`)){let t=e.getAttribute(`src`)?.toLowerCase()||``;(t.startsWith(`javascript:`)||t.startsWith(`data:`)||t.startsWith(`vbscript:`))&&e.removeAttribute(`src`)}});function T(e){return e?e.replace(/<script\b[^<]*(?:(?!<\/script>)<[^<]*)*<\/script>/gi,``).replace(/<style\b[^<]*(?:(?!<\/style>)<[^<]*)*<\/style>/gi,``).replace(/<!--[\s\S]*?-->/g,``).replace(/<[^>]+>/g,` `).replace(/\s+/g,` `).trim():``}function E(e){return e.charAt(0).toUpperCase()+e.slice(1)}function D(e){return e.replace(/[^a-zA-Z0-9\-_/.]/g,``).split(`/`).filter(e=>e!==`..`&&e!==`.`).map(e=>e.replace(/\.\.+/g,`.`)).join(`/`)}function O(e,t,n={}){let r=new Date().toISOString(),i={...n};for(let e in i)typeof i[e]==`string`&&i[e].includes(`:`)&&(i[e]=i[e].split(/[\\/]/).pop()||i[e]);console.error(`[SECURITY][${r}] TYPE: ${e} | MESSAGE: ${t} | DETAILS: ${JSON.stringify(i)}`)}function k(){return{dir:process.env.BOLTDOCS_CACHE_DIR||`.boltdocs`,noCache:process.env.BOLTDOCS_NO_CACHE===`1`,lruLimit:parseInt(process.env.BOLTDOCS_CACHE_LRU_LIMIT||`2000`,10),lruTTL:parseInt(process.env.BOLTDOCS_CACHE_LRU_TTL||`14400000`,10),compress:process.env.BOLTDOCS_CACHE_COMPRESS!==`0`}}Object.defineProperty(exports,`_`,{enumerable:!0,get:function(){return m}}),Object.defineProperty(exports,`a`,{enumerable:!0,get:function(){return k}}),Object.defineProperty(exports,`c`,{enumerable:!0,get:function(){return O}}),Object.defineProperty(exports,`d`,{enumerable:!0,get:function(){return D}}),Object.defineProperty(exports,`f`,{enumerable:!0,get:function(){return w}}),Object.defineProperty(exports,`g`,{enumerable:!0,get:function(){return f}}),Object.defineProperty(exports,`h`,{enumerable:!0,get:function(){return p}}),Object.defineProperty(exports,`i`,{enumerable:!0,get:function(){return C}}),Object.defineProperty(exports,`l`,{enumerable:!0,get:function(){return h}}),Object.defineProperty(exports,`m`,{enumerable:!0,get:function(){return g}}),Object.defineProperty(exports,`n`,{enumerable:!0,get:function(){return S}}),Object.defineProperty(exports,`o`,{enumerable:!0,get:function(){return y}}),Object.defineProperty(exports,`p`,{enumerable:!0,get:function(){return T}}),Object.defineProperty(exports,`r`,{enumerable:!0,get:function(){return _}}),Object.defineProperty(exports,`s`,{enumerable:!0,get:function(){return v}}),Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return E}}),Object.defineProperty(exports,`u`,{enumerable:!0,get:function(){return b}}),Object.defineProperty(exports,`v`,{enumerable:!0,get:function(){return a}}),Object.defineProperty(exports,`y`,{enumerable:!0,get:function(){return i}});

package/src/client/app/config-context.tsx

@@ -1,51 +0,0 @@
-import { createContext, use } from 'react'
-import type { BoltdocsConfig } from '../../shared/types'
-
-/**
- * Context for the global documentation configuration.
- * Using a global singleton pattern to survive dual-package or duplicated-code hazards.
- */
-const CONFIG_CONTEXT_SYMBOL = Symbol.for('__BDOCS_CONFIG_CONTEXT__')
-const CONFIG_INSTANCE_SYMBOL = Symbol.for('__BDOCS_CONFIG_INSTANCE__')
-
-export const ConfigContext =
-  (globalThis as any)[CONFIG_CONTEXT_SYMBOL] ||
-  ((globalThis as any)[CONFIG_CONTEXT_SYMBOL] =
-    createContext<BoltdocsConfig | null>(null))
-
-export function ConfigProvider({
-  config,
-  children,
-}: {
-  config: BoltdocsConfig
-  children: React.ReactNode
-}) {
-  // Sync with global registry for dual-package fallback
-  if (typeof globalThis !== 'undefined') {
-    ;(globalThis as any)[CONFIG_INSTANCE_SYMBOL] = config
-  }
-
-  return (
-    <ConfigContext.Provider value={config}>{children}</ConfigContext.Provider>
-  )
-}
-
-/**
- * Hook to access the Boltdocs configuration.
- */
-export function useConfig() {
-  const context = use(ConfigContext)
-
-  // Fallback to global registry if context is missing (dual-package hazard safety net)
-  if (
-    !context &&
-    typeof globalThis !== 'undefined' &&
-    (globalThis as any)[CONFIG_INSTANCE_SYMBOL]
-  ) {
-    return (globalThis as any)[CONFIG_INSTANCE_SYMBOL] as BoltdocsConfig
-  }
-
-  if (!context)
-    throw new Error('useConfig must be used within a ConfigProvider')
-  return context as BoltdocsConfig
-}

package/src/client/app/doc-page.tsx

@@ -1,38 +0,0 @@
-import { useMdxComponents } from './mdx-components-context'
-import { useMemo } from 'react'
-import { LastUpdated as DefaultLastUpdated } from '../components/ui-base'
-
-/**
- * DocPage renders the MDX content and page-specific metadata.
- * It is rendered inside the Outlet of DocsLayout.
- */
-export function DocPage({
-  route,
-  content: Content,
-  mdxComponents: propComponents,
-}: any) {
-  // Access global MDX components (defaults + plugins + virtuals) from context
-  const contextComponents = useMdxComponents()
-
-  // Merge components: Prop components (from loader) take priority,
-  // then context components (globals).
-  const allComponents = useMemo(
-    () => ({
-      LastUpdated: DefaultLastUpdated,
-      ...contextComponents,
-      ...propComponents,
-    }),
-    [contextComponents, propComponents],
-  )
-
-  const LastUpdated = allComponents.LastUpdated || DefaultLastUpdated
-
-  if (!Content) return null
-
-  return (
-    <>
-      <Content components={allComponents} />
-      {route?.lastUpdated && <LastUpdated date={route.lastUpdated} />}
-    </>
-  )
-}

package/src/client/app/docs-layout.tsx

@@ -1,28 +0,0 @@
-import { Outlet } from 'react-router-dom'
-import UserLayout from 'virtual:boltdocs-layout'
-import { useRoutes } from '../hooks/use-routes'
-import { useConfig } from './config-context'
-import { Head } from './head'
-
-/**
- * Wraps the docs Outlet with the user's (or default) layout component.
- * The Layout receives the routed page as `children`.
- * We use useRoutes to pass the current route context to the persistent layout.
- */
-export function DocsLayout() {
-  const config = useConfig()
-  const { currentRoute, allRoutes } = useRoutes()
-
-  return (
-    <>
-      <Head
-        siteTitle={config.theme?.title}
-        siteDescription={config.theme?.description}
-        routes={allRoutes || []}
-      />
-      <UserLayout route={currentRoute}>
-        <Outlet />
-      </UserLayout>
-    </>
-  )
-}

package/src/client/app/head.tsx

@@ -1,122 +0,0 @@
-import { useMemo } from 'react'
-import { useLocation } from 'react-router-dom'
-import { Helmet } from './helmet-compat'
-import { useConfig } from './config-context'
-import { getTranslated } from '../utils/i18n'
-import { useRoutes } from '../hooks/use-routes'
-
-interface HeadProps {
-  siteTitle?: string | Record<string, string>
-  siteDescription?: string | Record<string, string>
-  routes: Array<{
-    path: string
-    title: string
-    description?: string
-    seo?: Record<string, unknown>
-  }>
-}
-
-export function Head({ siteTitle, siteDescription, routes }: HeadProps) {
-  const location = useLocation()
-  const config = useConfig()
-  const { currentLocale } = useRoutes()
-
-  // Find the current route's metadata — memoized so the O(n) search only
-  // re-runs when the routes array or the current URL changes, not on every render.
-  const currentRoute = useMemo(
-    () => routes?.find?.((r) => r.path === location.pathname),
-    [routes, location.pathname],
-  )
-  const pageTitle = currentRoute?.title
-  const translatedSiteDescription = getTranslated(
-    siteDescription,
-    currentLocale,
-  )
-  const pageDescription =
-    currentRoute?.description || translatedSiteDescription || ''
-
-  const translatedSiteTitle = getTranslated(siteTitle, currentLocale)
-  const finalTitle = pageTitle
-    ? `${pageTitle} | ${translatedSiteTitle}`
-    : translatedSiteTitle
-
-  const seo = currentRoute?.seo || {}
-
-  // Merge custom global metatags
-  const globalMetatags = config?.seo?.metatags || {}
-
-  // Calculate specific ones
-  const defaultOgImage = config?.seo?.thumbnails?.background
-  const ogImage = (seo['og:image'] || defaultOgImage) as string | undefined
-
-  return (
-    <Helmet>
-      <title>{finalTitle}</title>
-      <meta name="description" content={pageDescription} />
-
-      {/* Default OG Tags */}
-      <meta property="og:title" content={finalTitle} />
-      <meta property="og:description" content={pageDescription} />
-      <meta property="og:type" content="article" />
-      {/* Canonical URL for both <link> and og:url */}
-      {typeof window !== 'undefined' && (
-        <meta property="og:url" content={window.location.href} />
-      )}
-      {typeof window !== 'undefined' && (
-        <link
-          rel="canonical"
-          href={window.location.origin + location.pathname}
-        />
-      )}
-
-      {/* Default Twitter Card */}
-      <meta name="twitter:card" content="summary" />
-      <meta name="twitter:title" content={finalTitle} />
-      <meta name="twitter:description" content={pageDescription} />
-      {ogImage && <meta name="twitter:image" content={ogImage} />}
-      {ogImage && <meta property="og:image" content={ogImage} />}
-
-      {/* Generator */}
-      <meta name="generator" content="Boltdocs" />
-
-      {/* User-defined global metatags */}
-      {Object.entries(globalMetatags).map(([key, value]) => {
-        const isProperty =
-          key.startsWith('og:') ||
-          key.startsWith('music:') ||
-          key.startsWith('video:') ||
-          key.startsWith('article:') ||
-          key.startsWith('book:') ||
-          key.startsWith('profile:')
-        return isProperty ? (
-          <meta key={key} property={key} content={value as string} />
-        ) : (
-          <meta key={key} name={key} content={value as string} />
-        )
-      })}
-
-      {/* Page granular SEO tags (override global) */}
-      {Object.entries(seo).map(([key, value]) => {
-        if (key === 'noindex' && value === true)
-          return <meta key="noindex" name="robots" content="noindex" />
-        if (key === 'robots')
-          return <meta key="robots" name="robots" content={value as string} />
-        if (key === 'canonical')
-          return <link key="canonical" rel="canonical" href={value as string} />
-
-        const isProperty =
-          key.startsWith('og:') ||
-          key.startsWith('music:') ||
-          key.startsWith('video:') ||
-          key.startsWith('article:') ||
-          key.startsWith('book:') ||
-          key.startsWith('profile:')
-        return isProperty ? (
-          <meta key={key} property={key} content={value as string} />
-        ) : (
-          <meta key={key} name={key} content={value as string} />
-        )
-      })}
-    </Helmet>
-  )
-}

package/src/client/app/helmet-compat.tsx

@@ -1,36 +0,0 @@
-/**
- * Shared Helmet module compatibility helpers.
- *
- * react-helmet-async ships different module shapes depending on whether it is
- * loaded via CJS or ESM. Instead of duplicating the same detection logic in
- * every component that needs Helmet/HelmetProvider, we centralise it here.
- */
-import type { ComponentType, ReactNode } from 'react'
-import * as ReactHelmetAsync from 'react-helmet-async'
-
-type HelmetModule = {
-  Helmet?: ComponentType<{ children?: ReactNode }>
-  HelmetProvider?: ComponentType<{ children?: ReactNode }>
-  default?: {
-    Helmet?: ComponentType<{ children?: ReactNode }>
-    HelmetProvider?: ComponentType<{ children?: ReactNode }>
-  }
-}
-
-const mod = ReactHelmetAsync as unknown as HelmetModule
-
-/**
- * The `<Helmet>` component, resolved across CJS/ESM module shapes.
- * Falls back to a transparent fragment wrapper if the module cannot be resolved.
- */
-export const Helmet: ComponentType<{ children?: ReactNode }> =
-  mod.Helmet || mod.default?.Helmet || (({ children }) => <>{children}</>)
-
-/**
- * The `<HelmetProvider>` component, resolved across CJS/ESM module shapes.
- * Falls back to a transparent fragment wrapper if the module cannot be resolved.
- */
-export const HelmetProvider: ComponentType<{ children?: ReactNode }> =
-  mod.HelmetProvider ||
-  mod.default?.HelmetProvider ||
-  (({ children }) => <>{children}</>)

package/src/client/app/mdx-component.tsx

@@ -1,8 +0,0 @@
-import { NotFound } from '../components/ui-base/not-found'
-import { mdx_components_default } from '../components/mdx'
-
-export const mdxComponentsDefault = {
-  ...mdx_components_default,
-  NotFound,
-  '404': NotFound,
-}

package/src/client/app/mdx-components-context.tsx

@@ -1,72 +0,0 @@
-import { createContext, use, useMemo } from 'react'
-import type { BoltdocsMdxComponents } from '../../shared/types'
-
-export type MdxComponentsType = {
-  [key: string]: React.ComponentType<any>
-} & {
-  Frontmatter?: Record<string, React.ComponentType<any>>
-}
-
-const MDX_COMPONENTS_CONTEXT_SYMBOL = Symbol.for(
-  '__BDOCS_MDX_COMPONENTS_CONTEXT__',
-)
-const MDX_COMPONENTS_INSTANCE_SYMBOL = Symbol.for(
-  '__BDOCS_MDX_COMPONENTS_INSTANCE__',
-)
-
-const MdxComponentsContext =
-  (globalThis as any)[MDX_COMPONENTS_CONTEXT_SYMBOL] ||
-  ((globalThis as any)[MDX_COMPONENTS_CONTEXT_SYMBOL] =
-    createContext<MdxComponentsType>({}))
-
-export function useMdxComponents(): BoltdocsMdxComponents {
-  const context = use(MdxComponentsContext)
-
-  // Fallback to global registry for dual-package hazards
-  if (
-    (!context || Object.keys(context).length === 0) &&
-    (globalThis as any)[MDX_COMPONENTS_INSTANCE_SYMBOL]
-  ) {
-    return (globalThis as any)[
-      MDX_COMPONENTS_INSTANCE_SYMBOL
-    ] as BoltdocsMdxComponents
-  }
-
-  return context as any as BoltdocsMdxComponents
-}
-
-export function MdxComponentsProvider({
-  components,
-  children,
-}: {
-  components: Record<string, React.ComponentType<any>>
-  children: React.ReactNode
-}) {
-  const processedComponents = useMemo(() => {
-    const processed: Record<string, any> = {}
-    const frontmatter: Record<string, React.ComponentType<any>> = {}
-
-    Object.entries(components).forEach(([key, value]) => {
-      if (key.startsWith('Frontmatter_')) {
-        const cleanKey = key.slice('Frontmatter_'.length)
-        frontmatter[cleanKey] = value
-      } else {
-        processed[key] = value
-      }
-    })
-
-    processed.Frontmatter = frontmatter
-    return processed as MdxComponentsType
-  }, [components])
-
-  // Sync with global registry
-  if (typeof globalThis !== 'undefined') {
-    ;(globalThis as any)[MDX_COMPONENTS_INSTANCE_SYMBOL] = processedComponents
-  }
-
-  return (
-    <MdxComponentsContext.Provider value={processedComponents}>
-      {children}
-    </MdxComponentsContext.Provider>
-  )
-}

package/src/client/app/routes-context.tsx

@@ -1,34 +0,0 @@
-import { createContext, use } from 'react'
-import type { ComponentRoute } from '../types'
-
-interface RoutesContextType {
-  routes: ComponentRoute[]
-}
-
-const RoutesContext = createContext<RoutesContextType>({
-  routes: [],
-})
-
-/**
- * Hook to access the processed routes list from the closest provider.
- */
-export function useRoutesContext() {
-  return use(RoutesContext)
-}
-
-/**
- * Provider component for the documentation routes.
- */
-export function RoutesProvider({
-  routes,
-  children,
-}: {
-  routes: ComponentRoute[]
-  children: React.ReactNode
-}) {
-  return (
-    <RoutesContext.Provider value={{ routes }}>
-      {children}
-    </RoutesContext.Provider>
-  )
-}

package/src/client/app/scroll-handler.tsx

@@ -1,74 +0,0 @@
-import { useEffect, useLayoutEffect } from 'react'
-import { useLocation } from 'react-router-dom'
-
-/**
- * Handles scroll restoration and hash scrolling on navigation.
- * It ensures the page scrolls to top on pathname changes,
- * or specifically to an anchor element if a hash is present.
- */
-export function ScrollHandler() {
-  const { pathname, hash } = useLocation()
-
-  // Helper to handle scroll logic
-  const handleScroll = (behavior: ScrollBehavior = 'auto') => {
-    const container = document.querySelector('.boltdocs-content') || window
-
-    const getScrollTop = () => {
-      if (container === window) return window.scrollY
-      return (container as HTMLElement).scrollTop
-    }
-
-    const scrollTo = (top: number, scrollBehavior: ScrollBehavior) => {
-      if (container === window) {
-        window.scrollTo({ top, behavior: scrollBehavior })
-      } else {
-        ;(container as HTMLElement).scrollTo({ top, behavior: scrollBehavior })
-      }
-    }
-
-    if (hash) {
-      const id = hash.replace('#', '')
-      const element = document.getElementById(id)
-      if (element) {
-        const offset = 80
-        const containerTop =
-          container === window
-            ? 0
-            : (container as HTMLElement).getBoundingClientRect().top
-        const elementRect = element.getBoundingClientRect().top
-        const elementPosition = elementRect - containerTop
-        const offsetPosition = elementPosition - offset + getScrollTop()
-
-        scrollTo(offsetPosition, behavior)
-        return true
-      }
-    }
-
-    scrollTo(0, behavior)
-    return false
-  }
-
-  // 1. Immediate sync scroll before paint
-  // biome-ignore lint/correctness/useExhaustiveDependencies: pathname is used as a trigger for scroll-to-top on navigation
-  useLayoutEffect(() => {
-    handleScroll('auto')
-  }, [pathname, hash])
-
-  // 2. Delayed async scroll as fallback/stabilizer after paint & passive effects
-  useEffect(() => {
-    // Immediate run after paint (helps override old component unmount/revert side effects)
-    handleScroll('auto')
-
-    // Double-check inside requestAnimationFrame to catch concurrent renders or dynamic layout recalculations
-    const rafId = requestAnimationFrame(() => {
-      handleScroll('auto')
-      // Dispatch resize event so external components/scroll libraries (like GSAP ScrollTrigger) recalculate trigger offsets
-      window.dispatchEvent(new Event('resize'))
-    })
-
-    return () => cancelAnimationFrame(rafId)
-  }, [pathname, hash])
-
-  return null
-}
-

package/src/client/app/theme-context.tsx

@@ -1,103 +0,0 @@
-import { createContext, use, useState, useEffect } from 'react'
-
-export type Theme = 'light' | 'dark' | 'system'
-export type ResolvedTheme = 'light' | 'dark'
-
-interface ThemeContextType {
-  theme: Theme
-  resolvedTheme: ResolvedTheme
-  setTheme: (theme: Theme) => void
-}
-
-const THEME_CONTEXT_SYMBOL = Symbol.for('__BDOCS_THEME_CONTEXT__')
-const THEME_INSTANCE_SYMBOL = Symbol.for('__BDOCS_THEME_INSTANCE__')
-const THEME_EVENT = 'boltdocs-theme-change'
-
-const ThemeContext =
-  (globalThis as any)[THEME_CONTEXT_SYMBOL] ||
-  ((globalThis as any)[THEME_CONTEXT_SYMBOL] = createContext<
-    ThemeContextType | undefined
-  >(undefined))
-
-export function ThemeProvider({ children }: { children: React.ReactNode }) {
-  const [theme, setThemeState] = useState<Theme>('system')
-  const [resolvedTheme, setResolvedTheme] = useState<ResolvedTheme>('dark')
-
-  const applyTheme = (targetTheme: Theme) => {
-    const mediaQuery = window.matchMedia('(prefers-color-scheme: dark)')
-    const isDark =
-      targetTheme === 'dark' || (targetTheme === 'system' && mediaQuery.matches)
-
-    const root = window.document.documentElement
-    root.classList.toggle('dark', isDark)
-    root.dataset.theme = isDark ? 'dark' : 'light'
-    setResolvedTheme(isDark ? 'dark' : 'light')
-  }
-
-  useEffect(() => {
-    const savedTheme = localStorage.getItem('boltdocs-theme') as Theme | null
-    if (savedTheme) {
-      setThemeState(savedTheme)
-      applyTheme(savedTheme)
-    } else {
-      applyTheme('system')
-    }
-
-    const mediaQuery = window.matchMedia('(prefers-color-scheme: dark)')
-    const listener = () => {
-      const current =
-        (localStorage.getItem('boltdocs-theme') as Theme) || 'system'
-      if (current === 'system') applyTheme('system')
-    }
-
-    mediaQuery.addEventListener('change', listener)
-    return () => mediaQuery.removeEventListener('change', listener)
-  }, [])
-
-  const setTheme = (newTheme: Theme) => {
-    setThemeState(newTheme)
-    localStorage.setItem('boltdocs-theme', newTheme)
-    applyTheme(newTheme)
-
-    // Notify external listeners (dual-package hazard)
-    if (typeof window !== 'undefined') {
-      window.dispatchEvent(new CustomEvent(THEME_EVENT, { detail: newTheme }))
-    }
-  }
-
-  const value = { theme, resolvedTheme, setTheme }
-
-  // Sync with global registry
-  if (typeof globalThis !== 'undefined') {
-    ;(globalThis as any)[THEME_INSTANCE_SYMBOL] = value
-  }
-
-  return <ThemeContext.Provider value={value}>{children}</ThemeContext.Provider>
-}
-
-export function useTheme() {
-  const context = use(ThemeContext)
-  const [, forceUpdate] = useState({})
-
-  useEffect(() => {
-    if (context) return
-
-    const handler = () => forceUpdate({})
-    window.addEventListener(THEME_EVENT, handler)
-    return () => window.removeEventListener(THEME_EVENT, handler)
-  }, [context])
-
-  // Fallback to global registry for dual-package hazards
-  if (
-    !context &&
-    typeof globalThis !== 'undefined' &&
-    (globalThis as any)[THEME_INSTANCE_SYMBOL]
-  ) {
-    return (globalThis as any)[THEME_INSTANCE_SYMBOL] as ThemeContextType
-  }
-
-  if (context === undefined) {
-    throw new Error('useTheme must be used within a ThemeProvider')
-  }
-  return context as ThemeContextType
-}

package/src/client/app/ui-context.tsx

@@ -1,42 +0,0 @@
-import { createContext, useContext, useState, useEffect } from 'react'
-import { useLocation } from 'react-router-dom'
-
-interface UIContextType {
-  isSidebarOpen: boolean
-  toggleSidebar: () => void
-  closeSidebar: () => void
-}
-
-const UIContext = createContext<UIContextType | undefined>(undefined)
-
-export function UIProvider({ children }: { children: React.ReactNode }) {
-  const [isSidebarOpen, setIsSidebarOpen] = useState(false)
-  const location = useLocation()
-
-  const toggleSidebar = () => setIsSidebarOpen((prev) => !prev)
-  const closeSidebar = () => setIsSidebarOpen(false)
-
-  // Close sidebar on navigation
-  useEffect(() => {
-    setIsSidebarOpen(false)
-  }, [location.pathname])
-
-  return (
-    <UIContext.Provider value={{ isSidebarOpen, toggleSidebar, closeSidebar }}>
-      {children}
-    </UIContext.Provider>
-  )
-}
-
-export function useUI() {
-  const context = useContext(UIContext)
-  if (context === undefined) {
-    // Safe fallback for split bundles, independent component renders, or during SSR
-    return {
-      isSidebarOpen: false,
-      toggleSidebar: () => {},
-      closeSidebar: () => {},
-    }
-  }
-  return context
-}