boltdocs 3.0.2 → 3.2.1

package/src/shared/types.ts

@@ -2,18 +2,90 @@ import type { Plugin as VitePlugin } from 'vite'
 import type { ComponentType } from 'react'
 
 /**
- * Represents a single social link in the configuration.
+ * Metadata representing a single documentation route.
+ * This information is used to build the client-side router and the sidebar navigation.
  */
-export interface BoltdocsSocialLink {
-  icon: 'discord' | 'x' | 'github' | 'bluesky' | string
-  link: string
+export interface RouteMeta {
+  /** The final URL path for the route (e.g., '/docs/guide/start') */
+  path: string
+  /** The absolute filesystem path to the source markdown/mdx file */
+  componentPath: string
+  /** The title of the page, usually extracted from frontmatter or the filename */
+  title: string
+  /** The relative path from the docs directory, used for edit links */
+  filePath: string
+  /** Optional description of the page (for SEO/meta tags) */
+  description?: string
+  /** Optional explicit position for ordering in the sidebar */
+  sidebarPosition?: number
+  /** The group (directory) this route belongs to */
+  group?: string
+  /** The display title for the route's group */
+  groupTitle?: string
+  /** Optional explicit position for ordering the group itself */
+  groupPosition?: number
+  /** Optional icon for the route's group */
+  groupIcon?: string
+  /** The sub-route group this route belongs to (from folders starting with _) */
+  subRouteGroup?: string
+  /** Extracted markdown headings for search indexing */
+  headings?: { level: number; text: string; id: string }[]
+  /** The locale this route belongs to, if i18n is configured */
+  locale?: string
+  /** The version this route belongs to, if versioning is configured */
+  version?: string
+  /** Optional badge to display next to the sidebar item (e.g., 'New', 'Experimental') */
+  badge?: BadgeValue
+  /** Optional icon to display (Lucide icon name or raw SVG) */
+  icon?: string
+  /** The tab this route belongs to, if tabs are configured */
+  tab?: string
+  /** The collection this route belongs to (from [name] directories like [blog]) */
+  collection?: string
+  /** Tags for blog posts or other taxonomy */
+  tags?: string[]
+  /** Author identifier for blog posts */
+  author?: string
+  /** Draft flag — excluded from production builds */
+  draft?: boolean
+  /** Feature flags required for this page to be visible */
+  featureFlags?: string[]
+  /** Short excerpt/summary for list displays */
+  excerpt?: string
+  /** Cover image for blog posts */
+  coverImage?: string
+  /** The extracted plain-text content of the page for search indexing */
+  _content?: string
+  /** The raw markdown content of the page */
+  _rawContent?: string
+  /** Extracted SEO and Open Graph metadata from frontmatter */
+  seo?: Record<string, any>
+  /** The publication date */
+  date?: string | Date
+  /** The last updated timestamp or date */
+  lastUpdated?: string | number | Date
+  /** Optional category for the page */
+  category?: string
+  /** Optional explicit order (alternative to sidebarPosition) */
+  order?: number
+  /** Optional explicit label for the sidebar */
+  sidebarLabel?: string
+  /** Whether the page is hidden from the sidebar */
+  sidebarHidden?: boolean
+  /** Raw extensible frontmatter data for custom components and formatters */
+  frontmatter?: Record<string, any>
+  /** Optional recursive child routes for deep sidebar hierarchies */
+  subRoutes?: RouteMeta[]
+  /** Clean URL segments stripped of locale/version prefixes */
+  slugParts?: string[]
 }
 
 /**
- * Configuration for the site footer.
+ * Represents a single social link in the configuration.
  */
-export interface BoltdocsFooterConfig {
-  text?: string
+export interface BoltdocsSocialLink {
+  icon: 'discord' | 'x' | 'github' | 'bluesky' | string
+  link: string
 }
 
 /**
@@ -48,7 +120,6 @@ export interface BoltdocsThemeConfig {
     { title?: string | Record<string, string>; icon?: string }
   >
   socialLinks?: BoltdocsSocialLink[]
-  footer?: BoltdocsFooterConfig
   editLink?: string
   communityHelp?: string
   version?: string
@@ -115,6 +186,44 @@ export interface BoltdocsVersionConfig {
   path: string
 }
 
+/**
+ * Configuration for content collections (e.g. blog posts, changelog)
+ * declared in `boltdocs.config.ts`. Each entry maps a directory name
+ * (e.g. `[blog]`) to its display + ordering settings.
+ */
+export interface BoltdocsCollectionsConfig {
+  /**
+   * Map of collection id (matches the bracketed directory name) to
+   * its display label. Falls back to the id when a label is missing.
+   */
+  labels?: Record<string, string | Record<string, string>>
+  /**
+   * Map of collection id to a numeric position used for sidebar ordering.
+   * Collections with no explicit position are sorted last.
+   */
+  positions?: Record<string, number>
+  /**
+   * Items-per-page for paginated collection routes (e.g. blog indexes).
+   * Falls back to the framework default (10) when omitted.
+   */
+  postsPerPage?: number
+  /**
+   * Default collection ID used by collection routing when no collection
+   * is explicitly referenced. Defaults to `'blog'`.
+   */
+  defaultCollection?: string
+  /**
+   * Date format string for rendering post dates in listing pages.
+   * Defaults to `'MMMM dd, yyyy'`.
+   */
+  dateFormat?: string
+  /**
+   * Field used to sort posts within a collection.
+   * Defaults to `'date'`.
+   */
+  sortBy?: 'date' | 'title' | 'sidebarPosition'
+}
+
 /**
  * Configuration for documentation versioning.
  */
@@ -129,6 +238,385 @@ export interface BoltdocsVersionsConfig {
  */
 export type BadgeValue = string | { text: string; expires?: string }
 
+/**
+ * Context provided to plugin lifecycle hooks.
+ */
+export interface PluginContext {
+  readonly config: BoltdocsConfig
+  readonly logger: PluginLogger
+  readonly store: PluginStore
+  readonly meta: PluginMeta
+  readonly docsDir: string
+  readonly rootDir: string
+  readonly outDir: string
+  readonly routes: RouteMeta[]
+  /** Namespaced cache helpers bound to the core's cache machinery. */
+  readonly caches: PluginCachesAPI
+  /** Structured diagnostics channel; reports can be drained via `list()`. */
+  readonly diagnostics: PluginDiagnosticsAPI
+  /** Helpers for resolving paths inside the workspace safely. */
+  readonly paths: PluginPathsAPI
+  /** Declare virtual modules the core should expose to Vite. */
+  readonly virtualModules: PluginVirtualModulesAPI
+  /** Register and query transform middleware at runtime. */
+  readonly middleware: PluginMiddlewareAPI
+  /**
+   * Hook into dev-server file watching and send custom HMR events
+   * to connected clients.
+   */
+  readonly hmr: PluginHmrAPI
+  /**
+   * Register HTTP middleware and server lifecycle hooks without
+   * writing a Vite plugin.
+   */
+  readonly server: PluginServerAPI
+}
+
+/**
+ * Functional cache helpers exposed through `PluginContext.caches`.
+ *
+ * Plugin authors do not get a reference to the raw `TransformCache` /
+ * `FileCache` instances — those stay encapsulated in core. The methods
+ * returned here are bound to namespaced keys so two plugins cannot
+ * collide.
+ */
+export interface PluginCachesAPI {
+  /** Sharded, hash-keyed cache. One namespace per plugin recommended. */
+  transform(namespace: string): PluginTransformCacheAPI
+  /** Routes cache wrapper around the parsed-doc cache. */
+  routes: PluginRoutesCacheAPI
+  /** In-memory LRU cache keyed by namespace + plugin-supplied key. */
+  memory<V = unknown>(
+    namespace: string,
+    opts?: { max?: number; ttl?: number },
+  ): PluginMemoryCacheAPI<V>
+}
+
+export interface PluginTransformCacheAPI {
+  /** Async read — first call may warm from disk if the entry was evicted. */
+  get(key: string): Promise<string | null>
+  /** Synchronous write that batches a background disk flush. */
+  set(key: string, value: string): void
+  /** Force-flush background writes. Call before measuring disk state. */
+  flush(): Promise<void>
+}
+
+export interface PluginRoutesCacheAPI {
+  /** Read a parsed `RouteMeta` (and its private `_content` blob) by abs file path. */
+  get(filePath: string): RouteMeta | null
+  /** Write a parsed route entry. Caller assumptions match `docCache.set`. */
+  set(filePath: string, route: RouteMeta): void
+  /** Invalidate one route. Use when content changes. */
+  invalidate(filePath: string): void
+  /** Clear every cached route. Use when the directory layout changes. */
+  invalidateAll(): void
+}
+
+export interface PluginMemoryCacheAPI<V> {
+  get(key: string): V | undefined
+  set(key: string, value: V): void
+  has(key: string): boolean
+}
+
+/**
+ * Plugin diagnostics API.
+ *
+ * Plugins push structured records instead of spamming the logger; downstream
+ * tools (dev-server overlay, CI reporters, IDE plugins) drain the queue via
+ * `list()`.
+ */
+export interface DiagnosticRecord {
+  readonly id: number
+  readonly severity: 'info' | 'warn' | 'error'
+  readonly code: string
+  readonly message: string
+  readonly pluginName: string
+  readonly filePath?: string
+  readonly routePath?: string
+  readonly time: Date
+}
+
+export interface PluginDiagnosticsAPI {
+  report(
+    severity: DiagnosticRecord['severity'],
+    code: string,
+    message: string,
+    where?: { filePath?: string; routePath?: string },
+  ): void
+  list(): readonly DiagnosticRecord[]
+  clear(): void
+}
+
+/**
+ * Path-resolution helpers exposed through `PluginContext.paths`.
+ *
+ * Both `resolveDocs` and `resolveAsset` validate the resulting path against
+ * the workspace boundary and reject any segment that resolves outside the
+ * docs / project root directories.
+ */
+export interface PluginPathsAPI {
+  resolveDocs(...parts: string[]): string
+  resolveAsset(...parts: string[]): string
+  /**
+   * Build a `file://` URL for an absolute path inside the workspace.
+   * Useful for `new URL(import.meta.url)` replacements and image srcsets.
+   */
+  safeFileURL(absFilePath: string): string
+}
+
+/**
+ * Plugin virtual-modules registration.
+ *
+ * Plugins call `add(id, loader)` to expose a `virtual:<plugin>/<id>` module
+ * to Vite without having to author a full Vite plugin. The loader returns
+ * the module source code as a string; the core wraps it in the right
+ * `resolveId`/`load` plumbing at Vite build time.
+ */
+export interface RegisteredVirtualModule {
+  readonly id: string
+  readonly eager: boolean
+  readonly loader: () => string | Promise<string>
+}
+
+export interface PluginVirtualModulesAPI {
+  add(
+    id: string,
+    loader: () => string | Promise<string>,
+    opts?: { eager?: boolean },
+  ): void
+  has(id: string): boolean
+  list(): readonly RegisteredVirtualModule[]
+}
+
+/**
+ * Logger interface for plugin logging.
+ */
+export interface PluginLogger {
+  info(message: string): void
+  warn(message: string): void
+  error(message: string | Error): void
+  debug(message: string): void
+}
+
+/**
+ * Key-value store interface for plugins.
+ */
+export interface PluginStore {
+  get<T = unknown>(pluginName: string, key: string): T | undefined
+  set(pluginName: string, key: string, value: unknown): void
+  has(pluginName: string, key: string): boolean
+}
+
+/**
+ * Plugin metadata provided in the context.
+ */
+export interface PluginMeta {
+  name: string
+  version?: string
+  boltdocsVersion?: string
+}
+
+/**
+ * Chain control signal returned by transform hooks. Use with `__signal` in
+ * the return value to influence the middleware chain:
+ *
+ * - `'skip'`: stop processing this hook for the current file (remaining
+ *   plugins in the chain still run).
+ * - `'break'`: stop the entire chain immediately — no further plugin's
+ *   transform hooks run for this file.
+ *
+ * @example
+ * ```ts
+ * transformMdx: async (_ctx, { code }) => ({
+ *   code: code.replace(/foo/g, 'bar'),
+ *   __signal: 'skip',   // skip remaining plugins
+ * })
+ * ```
+ */
+export type ChainSignal = 'skip' | 'break'
+
+/**
+ * Returned by a transform hook that wants to signal the chain. The `__signal`
+ * field is optional — most hooks will just return `{ code: string }` and the
+ * chain continues normally. When `__signal` is present, `runChain` reacts:
+ *
+ * - `'skip'` continues with the next plugin, but passes the **original params**
+ *   (the output of this hook is discarded).
+ * - `'break'` stops the chain immediately.
+ *
+ * @template T The params shape (e.g. `{ code: string; filePath: string }`).
+ */
+export type TransformResult<T> = T & { __signal?: ChainSignal }
+
+/**
+ * Enriched params passed to `transformSource` and `transformMdx`. The `code`
+ * and `filePath` fields are always present. The optional `frontmatter` and
+ * `route` fields are populated when available (they are `undefined` in the
+ * early pipeline where frontmatter hasn't been parsed yet).
+ */
+export interface TransformSourceParams {
+  /** The raw or compiled code (source before MDX / JS after MDX). */
+  code: string
+  /** Absolute file path of the source document. */
+  filePath: string
+  /** Parsed frontmatter, if available. `undefined` in very early pipeline. */
+  frontmatter?: Record<string, unknown>
+}
+
+/**
+ * Enriched params passed to `transformHtml`. The `html` and `path` fields
+ * are always present. The optional `route` carries the generated `RouteMeta`
+ * for richer context (locale, version, collection, etc.).
+ */
+export interface TransformHtmlParams {
+  /** The rendered HTML string for this page. */
+  html: string
+  /** The route path (e.g. `/docs/guides/start`). */
+  path: string
+  /** The route metadata for the page, if available. */
+  route?: RouteMeta
+}
+
+/**
+ * Plugin transform middleware. Each middleware runs in the transform
+ * pipeline alongside lifecycle hooks. The `name` field is optional —
+ * when omitted, the owning plugin's name is used as context.
+ * Middleware runs in `enforce` order (pre → normal → post) and supports
+ * `__signal: 'skip'` / `__signal: 'break'` for chain control.
+ */
+export interface PluginTransformMiddleware {
+  /** Optional name. Defaults to the owning plugin's name for diagnostics. */
+  name?: string
+  enforce?: 'pre' | 'post'
+  transformSource?: (
+    ctx: PluginContext,
+    params: TransformSourceParams,
+  ) =>
+    | TransformResult<{ code: string }>
+    | Promise<TransformResult<{ code: string }>>
+  transformMdx?: (
+    ctx: PluginContext,
+    params: TransformSourceParams,
+  ) =>
+    | TransformResult<{ code: string }>
+    | Promise<TransformResult<{ code: string }>>
+  transformHtml?: (
+    ctx: PluginContext,
+    params: TransformHtmlParams,
+  ) =>
+    | TransformResult<{ html: string }>
+    | Promise<TransformResult<{ html: string }>>
+}
+
+/**
+ * Plugin middleware registry API exposed through `PluginContext.middleware`.
+ * Plugins can register named middleware entries from lifecycle hooks.
+ */
+export interface PluginMiddlewareAPI {
+  add(middleware: PluginTransformMiddleware): void
+  remove(name: string): void
+  has(name: string): boolean
+  list(): readonly PluginTransformMiddleware[]
+}
+
+/**
+ * HMR event types plugins can listen to.
+ */
+export type PluginHmrEvent = 'add' | 'change' | 'unlink'
+
+/**
+ * Plugin HMR API — hook into file-watching events and send custom
+ * HMR messages to connected clients.
+ */
+export interface PluginHmrAPI {
+  /**
+   * Register a callback for file events scoped to the docs directory.
+   * The callback receives the normalized file path and event type.
+   */
+  onFileEvent(
+    eventType: PluginHmrEvent,
+    handler: (filePath: string) => void | Promise<void>,
+  ): void
+  /** Shorthand for `onFileEvent('add', handler)`. */
+  onFileAdd(handler: (filePath: string) => void | Promise<void>): void
+  /** Shorthand for `onFileEvent('change', handler)`. */
+  onFileChange(handler: (filePath: string) => void | Promise<void>): void
+  /** Shorthand for `onFileEvent('unlink', handler)`. */
+  onFileUnlink(handler: (filePath: string) => void | Promise<void>): void
+  /**
+   * Send a custom HMR event to all connected clients.
+   * The client can listen with `import.meta.hot.on('boltdocs:plugin:<name>', ...)`.
+   */
+  send(event: string, data?: unknown): void
+}
+
+/**
+ * Plugin Server API — register HTTP middleware and lifecycle hooks
+ * for the dev server and preview server, without writing a Vite plugin.
+ */
+export interface PluginServerAPI {
+  /**
+   * Register a Connect-style middleware function.
+   * Runs on both dev and preview servers.
+   */
+  use(middleware: PluginServerMiddleware): void
+  /**
+   * Register a middleware scoped to a specific path prefix.
+   * Only requests starting with `path` trigger the handler.
+   */
+  useAt(path: string, handler: PluginServerMiddleware): void
+  /** Called when the dev/preview server starts (once per process). */
+  onStart(callback: () => void | Promise<void>): void
+  /** Called when the server shuts down (cleanup). */
+  onEnd(callback: () => void | Promise<void>): void
+}
+
+/**
+ * Connect-style middleware signature.
+ */
+export type PluginServerMiddleware = (
+  req: import('http').IncomingMessage,
+  res: import('http').ServerResponse,
+  next: (err?: unknown) => void,
+) => void | Promise<void>
+
+/**
+ * Plugin lifecycle hooks with full type safety.
+ */
+export interface PluginLifecycleHooks {
+  beforeBuild?: (ctx: PluginContext) => Promise<void> | void
+  afterBuild?: (ctx: PluginContext) => Promise<void> | void
+  beforeDev?: (ctx: PluginContext) => Promise<void> | void
+  afterDev?: (ctx: PluginContext) => Promise<void> | void
+  buildEnd?: (ctx: PluginContext) => Promise<void> | void
+  transformSource?: (
+    ctx: PluginContext,
+    params: TransformSourceParams,
+  ) =>
+    | TransformResult<{ code: string }>
+    | Promise<TransformResult<{ code: string }>>
+  transformMdx?: (
+    ctx: PluginContext,
+    params: TransformSourceParams,
+  ) =>
+    | TransformResult<{ code: string }>
+    | Promise<TransformResult<{ code: string }>>
+  transformHtml?: (
+    ctx: PluginContext,
+    params: TransformHtmlParams,
+  ) =>
+    | TransformResult<{ html: string }>
+    | Promise<TransformResult<{ html: string }>>
+}
+
+/**
+ * MDX processor configuration.
+ * When `processor` is set to 'satteri', the Sätteri Rust-based compiler is used.
+ */
+export interface BoltdocsMdxConfig {
+  processor?: 'unified' | 'satteri'
+}
+
 /**
  * Defines a Boltdocs plugin.
  *
@@ -144,23 +632,22 @@ export interface BoltdocsPlugin {
   rehypePlugins?: unknown[]
   vitePlugins?: VitePlugin[]
   components?: Record<string, string>
-  /** Lifecycle hooks — use the `PluginLifecycleHooks` type from the node API. */
-  hooks?: Record<string, (ctx: unknown) => Promise<void> | void>
+  /** Optional runtime metadata exposed to client via useConfig().plugins[].metadata */
+  metadata?: Record<string, unknown>
+  /** Declarative transform middleware entries. */
+  middleware?: PluginTransformMiddleware[]
+  /** Lifecycle hooks with full type safety */
+  hooks?: PluginLifecycleHooks
 }
 
 /**
- * Configuration for the collections (blog) feature.
  */
-export interface BoltdocsCollectionsConfig {
-  /** Number of posts per page in collection listing pages. Defaults to 10. */
-  postsPerPage?: number
-  /** The name of the default collection used by BlogList when none is specified. */
-  defaultCollection?: string
-  /** Date format string for rendering post dates (e.g., 'MMMM dd, yyyy'). */
-  dateFormat?: string
-  /** Field to sort posts by. Defaults to 'date'. */
-  sortBy?: 'date' | 'title' | 'sidebarPosition'
-}
+
+/**
+ */
+
+/**
+ */
 
 export interface BoltdocsSecurityConfig {
   headers?: Record<string, string>
@@ -258,11 +745,21 @@ export interface BoltdocsVercelConfig {
   speedInsights?: boolean
 }
 
+export interface BoltdocsPostHogConfig {
+  apiKey: string
+  host?: string
+  capturePageview?: boolean
+  capturePageleave?: boolean
+  sessionRecording?: boolean
+  autocapture?: boolean
+}
+
 export interface BoltdocsIntegrationsConfig {
   analytics?: {
     ga4?: BoltdocsGA4Config
     vercel?: BoltdocsVercelConfig
     gtm?: BoltdocsGTMConfig
+    posthog?: BoltdocsPostHogConfig
   }
   search?: {
     algolia?: BoltdocsAlgoliaConfig
@@ -273,6 +770,16 @@ export interface BoltdocsIntegrationsConfig {
   }
 }
 
+/**
+ * Configuration for drafts visibility control.
+ */
+export interface BoltdocsDraftsConfig {
+  /** If true, drafts are visible in all environments. Default: false */
+  visible?: boolean
+  /** Environments where drafts are visible (e.g. ['development', 'staging']). Default: [] */
+  environments?: string[]
+}
+
 /**
  * The root configuration object for Boltdocs.
  */
@@ -283,12 +790,15 @@ export interface BoltdocsConfig {
   theme?: BoltdocsThemeConfig
   i18n?: BoltdocsI18nConfig
   versions?: BoltdocsVersionsConfig
+  mdx?: BoltdocsMdxConfig
   plugins?: BoltdocsPlugin[]
   collections?: BoltdocsCollectionsConfig
   robots?: BoltdocsRobotsConfig
   security?: BoltdocsSecurityConfig
   seo?: BoltdocsSeoConfig
   integrations?: BoltdocsIntegrationsConfig
+  drafts?: BoltdocsDraftsConfig
+  featureFlags?: Record<string, boolean | string>
   directoryMeta?: Record<string, unknown>
   vite?: unknown
 }
@@ -339,7 +849,6 @@ export type BoltdocsMdxComponents = Boltdocs.Types extends {
   MdxComponents: infer M
 }
   ? TransformMdxComponents<UnpackMdxComponents<M>>
-  : {
-      [key: string]: ComponentType<any>
+  : Omit<Record<string, ComponentType<any>>, 'Frontmatter'> & {
       Frontmatter: Record<string, ComponentType<any>>
     }

package/dist/cache-DETwlACe.cjs

@@ -1,6 +0,0 @@
-/**
- * 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`);let n=require(`node:path`);n=e.n(n);let r=require(`node:fs`);r=e.n(r);let i=require(`node:fs/promises`);i=e.n(i);let a=require(`node:crypto`);a=e.n(a);let o=require(`node:zlib`);o=e.n(o);let s=require(`node:util`),c=require(`lru-cache`);const l=i.default.writeFile,u=i.default.readFile,d=i.default.mkdir,f=i.default.rename,p=(0,s.promisify)(o.default.gzip),m=(0,s.promisify)(o.default.gunzip),h=new class{activeTasks=new Set;add(e){let t=Promise.resolve().then(e).catch(()=>{}).finally(()=>{this.activeTasks.delete(t)});this.activeTasks.add(t)}async flush(){await Promise.all(Array.from(this.activeTasks))}get pending(){return this.activeTasks.size}};var g=class{entries=new Map;cachePath=null;compress;constructor(e={}){let r=t.o();if(this.compress=e.compress===void 0?r.compress:e.compress,e.name){let t=e.root||process.cwd(),i=this.compress?`json.gz`:`json`;this.cachePath=n.default.resolve(t,r.dir,`${e.name}.${i}`)}}async load(){if(!t.o().noCache&&this.cachePath)try{let e=await u(this.cachePath);this.cachePath.endsWith(`.gz`)&&(e=await m(e));let t=JSON.parse(e.toString(`utf-8`));this.entries=new Map(Object.entries(t))}catch(e){if(e.code===`ENOENT`)return}}save(){if(t.o().noCache||!this.cachePath)return;let e=Object.fromEntries(this.entries),r=JSON.stringify(e),i=this.cachePath,o=this.compress;h.add(async()=>{try{await d(n.default.dirname(i),{recursive:!0});let e=Buffer.from(r);o&&(e=await p(e));let t=`${i}.${a.default.randomBytes(4).toString(`hex`)}.tmp`;await l(t,e),await f(t,i)}catch{}})}get(e){let n=this.entries.get(e);return!n||t.s(e)!==n.mtime?null:n.data}getStale(e){let t=this.entries.get(e);return t?t.data:null}set(e,n){this.entries.set(e,{data:n,mtime:t.s(e)})}isValid(e){let n=this.entries.get(e);return n?t.s(e)===n.mtime:!1}invalidate(e){this.entries.delete(e)}invalidateAll(){this.entries.clear()}pruneStale(e){for(let t of this.entries.keys())e.has(t)||this.entries.delete(t)}get size(){return this.entries.size}async flush(){await h.flush()}},_=class{index=new Map;memoryCache;baseDir;shardsDir;indexPath;saveTimeout=null;constructor(e,r=process.cwd()){let i=t.o();this.baseDir=n.default.resolve(r,i.dir,`transform-${e}`),this.shardsDir=n.default.resolve(this.baseDir,`shards`),this.indexPath=n.default.resolve(this.baseDir,`index.json`),this.memoryCache=new c.LRUCache({max:i.lruLimit,ttl:i.lruTTL,updateAgeOnGet:!0})}async load(){if(!t.o().noCache)try{let e=await u(this.indexPath,`utf-8`);this.index=new Map(Object.entries(JSON.parse(e)))}catch(e){if(e.code===`ENOENT`)return}}save(){if(t.o().noCache)return;let e=JSON.stringify(Object.fromEntries(this.index)),r=this.indexPath;h.add(async()=>{try{await d(n.default.dirname(r),{recursive:!0}),await l(r,e)}catch{}})}async getMany(e){let t=new Map,r=[];for(let n of e){let e=this.memoryCache.get(n);e?t.set(n,e):this.index.has(n)&&r.push(n)}if(r.length>0){let e=await Promise.all(r.map(async e=>{let t=this.index.get(e),r=n.default.resolve(this.shardsDir,`${t}.gz`);try{let t=(await m(await u(r))).toString(`utf-8`);return this.memoryCache.set(e,t),{key:e,val:t}}catch{return null}}));for(let n of e)n&&t.set(n.key,n.val)}return t}async getAsync(e){let t=this.memoryCache.get(e);if(t)return t;let r=this.index.get(e);if(!r)return null;let i=n.default.resolve(this.shardsDir,`${r}.gz`);try{let t=(await m(await u(i))).toString(`utf-8`);return this.memoryCache.set(e,t),t}catch(e){return e.code,null}}set(e,t){let r=a.default.createHash(`md5`).update(t).digest(`hex`);this.index.set(e,r),this.memoryCache.set(e,t);let o=n.default.resolve(this.shardsDir,`${r}.gz`);h.add(async()=>{try{try{await i.default.access(o);return}catch{}await d(this.shardsDir,{recursive:!0});let e=await p(Buffer.from(t)),n=`${o}.${a.default.randomBytes(4).toString(`hex`)}.tmp`;await l(n,e),await f(n,o)}catch{}}),this.saveTimeout&&clearTimeout(this.saveTimeout),this.saveTimeout=setTimeout(()=>{this.save()},500),typeof this.saveTimeout.unref==`function`&&this.saveTimeout.unref()}get size(){return this.index.size}async flush(){await h.flush()}};async function v(){await h.flush()}const y=new Map,b=()=>{let e=t.o();return n.default.resolve(process.cwd(),e.dir,`parser`)},x=`v2.5`;var S=class{static async get(e){if(t.o().noCache)return null;try{let t=await r.default.promises.stat(e),i=y.get(e);if(i&&i.mtime===t.mtimeMs)return i.data;let o=b(),s=a.default.createHash(`md5`).update(e).digest(`hex`),c=n.default.join(o,`${s}.json`);try{let n=await r.default.promises.readFile(c,`utf-8`),i=JSON.parse(n);return i._mtime!==t.mtimeMs||i._v!==x?null:(y.set(e,{data:i.data,mtime:i._mtime}),i.data)}catch{return null}}catch{return null}}static async set(e,i){if(!t.o().noCache)try{let t=await r.default.promises.stat(e);y.set(e,{data:i,mtime:t.mtimeMs});let o=b(),s=a.default.createHash(`md5`).update(e).digest(`hex`),c=n.default.join(o,`${s}.json`),l={_v:x,_mtime:t.mtimeMs,data:i};h.add(async()=>{try{await r.default.promises.mkdir(o,{recursive:!0}),await r.default.promises.writeFile(c,JSON.stringify(l))}catch{}})}catch{}}static invalidate(e){y.delete(e)}static clear(){y.clear();let e=b();if(r.default.existsSync(e))try{r.default.rmSync(e,{recursive:!0,force:!0})}catch{}}};Object.defineProperty(exports,`i`,{enumerable:!0,get:function(){return v}}),Object.defineProperty(exports,`n`,{enumerable:!0,get:function(){return g}}),Object.defineProperty(exports,`r`,{enumerable:!0,get:function(){return _}}),Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return S}});

package/dist/cache-SF59enb3.mjs

@@ -1,6 +0,0 @@
-/**
- * Boltdocs - https://boltdocs.vercel.app
- * Copyright (c) 2026 Jesus Alcala
- * Licensed under the MIT License.
- */
-import{o as e,s as t}from"./utils-B3xYMrpK.mjs";import n from"node:path";import r from"node:fs";import i from"node:fs/promises";import a from"node:crypto";import o from"node:zlib";import{promisify as s}from"node:util";import{LRUCache as c}from"lru-cache";const l=i.writeFile,u=i.readFile,d=i.mkdir,f=i.rename,p=s(o.gzip),m=s(o.gunzip),h=new class{activeTasks=new Set;add(e){let t=Promise.resolve().then(e).catch(()=>{}).finally(()=>{this.activeTasks.delete(t)});this.activeTasks.add(t)}async flush(){await Promise.all(Array.from(this.activeTasks))}get pending(){return this.activeTasks.size}};var g=class{entries=new Map;cachePath=null;compress;constructor(t={}){let r=e();if(this.compress=t.compress===void 0?r.compress:t.compress,t.name){let e=t.root||process.cwd(),i=this.compress?`json.gz`:`json`;this.cachePath=n.resolve(e,r.dir,`${t.name}.${i}`)}}async load(){if(!e().noCache&&this.cachePath)try{let e=await u(this.cachePath);this.cachePath.endsWith(`.gz`)&&(e=await m(e));let t=JSON.parse(e.toString(`utf-8`));this.entries=new Map(Object.entries(t))}catch(e){if(e.code===`ENOENT`)return}}save(){if(e().noCache||!this.cachePath)return;let t=Object.fromEntries(this.entries),r=JSON.stringify(t),i=this.cachePath,o=this.compress;h.add(async()=>{try{await d(n.dirname(i),{recursive:!0});let e=Buffer.from(r);o&&(e=await p(e));let t=`${i}.${a.randomBytes(4).toString(`hex`)}.tmp`;await l(t,e),await f(t,i)}catch{}})}get(e){let n=this.entries.get(e);return!n||t(e)!==n.mtime?null:n.data}getStale(e){let t=this.entries.get(e);return t?t.data:null}set(e,n){this.entries.set(e,{data:n,mtime:t(e)})}isValid(e){let n=this.entries.get(e);return n?t(e)===n.mtime:!1}invalidate(e){this.entries.delete(e)}invalidateAll(){this.entries.clear()}pruneStale(e){for(let t of this.entries.keys())e.has(t)||this.entries.delete(t)}get size(){return this.entries.size}async flush(){await h.flush()}},_=class{index=new Map;memoryCache;baseDir;shardsDir;indexPath;saveTimeout=null;constructor(t,r=process.cwd()){let i=e();this.baseDir=n.resolve(r,i.dir,`transform-${t}`),this.shardsDir=n.resolve(this.baseDir,`shards`),this.indexPath=n.resolve(this.baseDir,`index.json`),this.memoryCache=new c({max:i.lruLimit,ttl:i.lruTTL,updateAgeOnGet:!0})}async load(){if(!e().noCache)try{let e=await u(this.indexPath,`utf-8`);this.index=new Map(Object.entries(JSON.parse(e)))}catch(e){if(e.code===`ENOENT`)return}}save(){if(e().noCache)return;let t=JSON.stringify(Object.fromEntries(this.index)),r=this.indexPath;h.add(async()=>{try{await d(n.dirname(r),{recursive:!0}),await l(r,t)}catch{}})}async getMany(e){let t=new Map,r=[];for(let n of e){let e=this.memoryCache.get(n);e?t.set(n,e):this.index.has(n)&&r.push(n)}if(r.length>0){let e=await Promise.all(r.map(async e=>{let t=this.index.get(e),r=n.resolve(this.shardsDir,`${t}.gz`);try{let t=(await m(await u(r))).toString(`utf-8`);return this.memoryCache.set(e,t),{key:e,val:t}}catch{return null}}));for(let n of e)n&&t.set(n.key,n.val)}return t}async getAsync(e){let t=this.memoryCache.get(e);if(t)return t;let r=this.index.get(e);if(!r)return null;let i=n.resolve(this.shardsDir,`${r}.gz`);try{let t=(await m(await u(i))).toString(`utf-8`);return this.memoryCache.set(e,t),t}catch(e){return e.code,null}}set(e,t){let r=a.createHash(`md5`).update(t).digest(`hex`);this.index.set(e,r),this.memoryCache.set(e,t);let o=n.resolve(this.shardsDir,`${r}.gz`);h.add(async()=>{try{try{await i.access(o);return}catch{}await d(this.shardsDir,{recursive:!0});let e=await p(Buffer.from(t)),n=`${o}.${a.randomBytes(4).toString(`hex`)}.tmp`;await l(n,e),await f(n,o)}catch{}}),this.saveTimeout&&clearTimeout(this.saveTimeout),this.saveTimeout=setTimeout(()=>{this.save()},500),typeof this.saveTimeout.unref==`function`&&this.saveTimeout.unref()}get size(){return this.index.size}async flush(){await h.flush()}};async function v(){await h.flush()}const y=new Map,b=()=>{let t=e();return n.resolve(process.cwd(),t.dir,`parser`)},x=`v2.5`;var S=class{static async get(t){if(e().noCache)return null;try{let e=await r.promises.stat(t),i=y.get(t);if(i&&i.mtime===e.mtimeMs)return i.data;let o=b(),s=a.createHash(`md5`).update(t).digest(`hex`),c=n.join(o,`${s}.json`);try{let n=await r.promises.readFile(c,`utf-8`),i=JSON.parse(n);return i._mtime!==e.mtimeMs||i._v!==x?null:(y.set(t,{data:i.data,mtime:i._mtime}),i.data)}catch{return null}}catch{return null}}static async set(t,i){if(!e().noCache)try{let e=await r.promises.stat(t);y.set(t,{data:i,mtime:e.mtimeMs});let o=b(),s=a.createHash(`md5`).update(t).digest(`hex`),c=n.join(o,`${s}.json`),l={_v:x,_mtime:e.mtimeMs,data:i};h.add(async()=>{try{await r.promises.mkdir(o,{recursive:!0}),await r.promises.writeFile(c,JSON.stringify(l))}catch{}})}catch{}}static invalidate(e){y.delete(e)}static clear(){y.clear();let e=b();if(r.existsSync(e))try{r.rmSync(e,{recursive:!0,force:!0})}catch{}}};export{v as i,g as n,_ as r,S as t};

package/dist/config-B5uVv5q4.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`),t=require(`./errors-Dx6JHoKE.cjs`),n=require(`./types-generator-CYcHkDzZ.cjs`);let r=require(`node:path`);r=e.n(r);let i=require(`node:fs`);i=e.n(i);let a=require(`zod`),o=require(`@bdocs/dui`);function s(e){return e}const c=a.z.object({icon:a.z.string().max(50),link:a.z.string().url()});a.z.object({text:a.z.string().max(2e3).optional()});const l=a.z.object({name:a.z.string(),enforce:a.z.enum([`pre`,`post`]).optional(),version:a.z.string().optional(),boltdocsVersion:a.z.string().optional(),remarkPlugins:a.z.array(a.z.unknown()).optional(),rehypePlugins:a.z.array(a.z.unknown()).optional(),vitePlugins:a.z.array(a.z.unknown()).optional(),components:a.z.record(a.z.string(),a.z.string()).optional(),hooks:a.z.record(a.z.string(),a.z.unknown()).optional()}),u=a.z.object({title:a.z.union([a.z.string(),a.z.record(a.z.string(),a.z.string())]).optional(),description:a.z.union([a.z.string(),a.z.record(a.z.string(),a.z.string())]).optional(),logo:a.z.union([a.z.string(),a.z.object({dark:a.z.string(),light:a.z.string(),alt:a.z.string().optional(),width:a.z.number().optional(),height:a.z.number().optional()})]).optional(),navbar:a.z.array(a.z.object({label:a.z.union([a.z.string(),a.z.record(a.z.string(),a.z.string())]),href:a.z.string(),items:a.z.array(a.z.object({label:a.z.union([a.z.string(),a.z.record(a.z.string(),a.z.string())]),href:a.z.string()})).optional()})).optional(),sidebar:a.z.record(a.z.string(),a.z.array(a.z.object({text:a.z.string(),link:a.z.string()}))).optional(),sidebarGroups:a.z.record(a.z.string(),a.z.object({title:a.z.union([a.z.string(),a.z.record(a.z.string(),a.z.string())]).optional(),icon:a.z.string().optional()})).optional(),socialLinks:a.z.array(c).optional(),editLink:a.z.string().refine(e=>!e||e.includes(`:path`),{message:`editLink must contain ':path' placeholder if specified`}).optional(),communityHelp:a.z.string().url().optional(),version:a.z.string().max(50).optional(),githubRepo:a.z.string().max(100).optional(),favicon:a.z.string().optional(),tabs:a.z.array(a.z.object({id:a.z.string(),text:a.z.union([a.z.string(),a.z.record(a.z.string(),a.z.string())]),icon:a.z.string().optional()})).optional(),codeTheme:a.z.union([a.z.string(),a.z.object({light:a.z.string(),dark:a.z.string()})]).optional()}),d=a.z.union([a.z.string(),a.z.object({rules:a.z.array(a.z.object({userAgent:a.z.string(),allow:a.z.union([a.z.string(),a.z.array(a.z.string())]).optional(),disallow:a.z.union([a.z.string(),a.z.array(a.z.string())]).optional()})).optional(),sitemaps:a.z.array(a.z.string().url()).optional()})]),f=a.z.object({defaultLocale:a.z.string(),locales:a.z.union([a.z.record(a.z.string(),a.z.string()),a.z.array(a.z.string())]).transform(e=>Array.isArray(e)?Object.fromEntries(e.map(e=>[e,e])):e),localeConfigs:a.z.record(a.z.string(),a.z.object({label:a.z.string().optional(),direction:a.z.enum([`ltr`,`rtl`]).optional(),htmlLang:a.z.string().optional(),calendar:a.z.string().optional()})).optional()}),p=a.z.object({defaultVersion:a.z.string(),prefix:a.z.string().optional(),versions:a.z.array(a.z.object({label:a.z.string(),path:a.z.string()}))}),m=a.z.object({headers:a.z.record(a.z.string(),a.z.string()).optional(),enableCSP:a.z.boolean().optional(),customHeaders:a.z.record(a.z.string(),a.z.string()).optional()}),h=a.z.object({google:a.z.string().optional(),bing:a.z.string().optional(),yandex:a.z.string().optional(),pinterest:a.z.string().optional(),facebook:a.z.string().optional()}),g=a.z.object({metatags:a.z.record(a.z.string(),a.z.string()).optional(),indexing:a.z.enum([`all`,`public`]).optional(),thumbnails:a.z.object({background:a.z.string().optional()}).optional(),verification:h.optional()}),_=a.z.object({measurementId:a.z.string().min(1,`Measurement ID is required for GA4`),debug:a.z.boolean().optional(),anonymizeIp:a.z.boolean().optional(),sendPageView:a.z.boolean().optional(),cookieFlags:a.z.string().optional(),autoTrack:a.z.object({pageViews:a.z.boolean().optional(),downloads:a.z.boolean().optional(),externalLinks:a.z.boolean().optional(),search:a.z.boolean().optional()}).optional()}),v=a.z.object({tagId:a.z.string().min(1,`Tag ID is required for GTM`),dataLayerName:a.z.string().optional(),preview:a.z.string().optional()}),y=a.z.object({appId:a.z.string().min(1,`Algolia App ID is required`),apiKey:a.z.string().min(1,`Algolia API Key is required`),indexName:a.z.string().min(1,`Algolia Index Name is required`)}),b=a.z.object({repo:a.z.string().min(1,`Giscus repository is required`),repoId:a.z.string().min(1,`Giscus repository ID is required`),category:a.z.string().optional(),categoryId:a.z.string().optional(),mapping:a.z.enum([`pathname`,`url`,`title`,`og:title`,`specific`,`number`]).optional(),strict:a.z.union([a.z.enum([`0`,`1`]),a.z.boolean()]).optional(),reactionsEnabled:a.z.union([a.z.enum([`0`,`1`]),a.z.boolean()]).optional(),emitMetadata:a.z.union([a.z.enum([`0`,`1`]),a.z.boolean()]).optional(),inputPosition:a.z.enum([`top`,`bottom`]).optional(),theme:a.z.string().optional(),darkTheme:a.z.string().optional(),lang:a.z.string().optional(),loading:a.z.enum([`lazy`,`eager`]).optional()}),x=a.z.object({enabled:a.z.boolean(),owner:a.z.string().min(1,`GitHub owner is required`),repo:a.z.string().min(1,`GitHub repository name is required`),categorySlug:a.z.string().optional(),endpoint:a.z.string().optional()}),S=a.z.object({analytics:a.z.boolean().optional(),speedInsights:a.z.boolean().optional()}),C=a.z.object({ga4:_.optional(),gtm:v.optional(),vercel:S.optional()}),w=a.z.object({algolia:y.optional()}),T=a.z.object({giscus:b.optional(),custom:x.optional()}),E=a.z.object({analytics:C.optional(),search:w.optional(),feedback:T.optional()}),D=a.z.object({siteUrl:a.z.string().url().optional(),docsDir:a.z.string().optional(),base:a.z.string().optional(),theme:u.optional(),i18n:f.optional(),versions:p.optional(),plugins:a.z.array(l).optional(),robots:d.optional(),security:m.optional(),seo:g.optional(),integrations:E.optional(),vite:a.z.record(a.z.string(),a.z.unknown()).optional()}),O=[`boltdocs.config.js`,`boltdocs.config.mjs`,`boltdocs.config.ts`];async function k(e,n=process.cwd()){let a=n,s={docsDir:r.default.resolve(e),theme:{title:`Boltdocs`,description:`A Vite documentation framework`,navbar:[{label:`Home`,href:`/`},{label:`Documentation`,href:`/docs`}],codeTheme:{light:`github-light`,dark:`github-dark`}}},c={};for(let e of O){let t=r.default.resolve(a,e);if(i.default.existsSync(t))try{let{loadConfigFromFile:e}=await import(`vite`),n=await e({command:`serve`,mode:`development`},t,a);if(n){c=n.config;break}}catch(t){(0,o.warn)(`Failed to load config from ${e}:`,t)}}let l={title:c.title,description:c.description,logo:c.logo,favicon:c.favicon,navbar:c.navbar,sidebar:c.sidebar,sidebarGroups:c.theme?.sidebarGroups,socialLinks:c.socialLinks,githubRepo:c.githubRepo,tabs:c.tabs,codeTheme:c.codeTheme,communityHelp:c.communityHelp,version:c.version,editLink:c.editLink,...c.theme||{}},u=Object.fromEntries(Object.entries(l).filter(([e,t])=>t!==void 0));u.navbar&&=u.navbar.map(e=>({label:e.label||e.text||``,href:e.href||e.link||e.to||``,items:e.items}));let d={docsDir:r.default.resolve(e),theme:{...s.theme,...u},i18n:c.i18n?{...c.i18n,locales:Array.isArray(c.i18n.locales)?Object.fromEntries(c.i18n.locales.map(e=>[e,e])):c.i18n.locales}:void 0,versions:c.versions,siteUrl:c.siteUrl,base:c.base,seo:c.seo,plugins:c.plugins||[],robots:c.robots,security:c.security,integrations:c.integrations,vite:c.vite},f=D.safeParse(d);if(!f.success)throw new t.r(`Invalid Boltdocs configuration:\n${f.error.issues.map(e=>`  - ${e.path.join(`.`)}: ${e.message}`).join(`
-`)}`);return f.data}async function A(e,t=process.cwd()){let r=await k(e,t);return n.t(r,e,t),r}Object.defineProperty(exports,`a`,{enumerable:!0,get:function(){return s}}),Object.defineProperty(exports,`i`,{enumerable:!0,get:function(){return l}}),Object.defineProperty(exports,`n`,{enumerable:!0,get:function(){return k}}),Object.defineProperty(exports,`r`,{enumerable:!0,get:function(){return A}}),Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return O}});