boltdocs 2.7.10 → 2.8.0

package/dist/{sidebar-CcBkrm06.d.cts → sidebar-DNq4_ZAa.d.ts}

@@ -1,8 +1,8 @@
 
 import * as React$2 from "react";
 import { ComponentType, ReactNode } from "react";
-import { Plugin } from "vite";
 import * as _$react_jsx_runtime0 from "react/jsx-runtime";
+import { Plugin } from "vite";
 
 //#region src/shared/types.d.ts
 /**
@@ -33,15 +33,15 @@ interface BoltdocsThemeConfig {
   };
   navbar?: Array<{
     label: string | Record<string, string>;
-    href: string;
+    href: BoltdocsRoutePathWithFallback$1;
     items?: Array<{
       label: string | Record<string, string>;
-      href: string;
+      href: BoltdocsRoutePathWithFallback$1;
     }>;
   }>;
   sidebar?: Record<string, Array<{
     text: string;
-    link: string;
+    link: BoltdocsRoutePathWithFallback$1;
   }>>;
   sidebarGroups?: Record<string, {
     title?: string | Record<string, string>;
@@ -111,24 +111,44 @@ interface BoltdocsVersionsConfig {
   prefix?: string;
   versions: BoltdocsVersionConfig[];
 }
+/**
+ * Shared badge value type used in frontmatter, RouteMeta, and ComponentRoute.
+ */
+type BadgeValue = string | {
+  text: string;
+  expires?: string;
+};
 /**
  * Defines a Boltdocs plugin.
+ *
+ * Use the `createPlugin()` helper from the node API for full type safety and
+ * access to lifecycle hooks.
  */
 interface BoltdocsPlugin {
   name: string;
   enforce?: 'pre' | 'post';
   version?: string;
   boltdocsVersion?: string;
-  permissions?: string[];
   remarkPlugins?: unknown[];
   rehypePlugins?: unknown[];
   vitePlugins?: Plugin[];
   components?: Record<string, string>;
-  hooks?: Record<string, any>;
+  /** Lifecycle hooks — use the `PluginLifecycleHooks` type from the node API. */
+  hooks?: Record<string, (ctx: unknown) => Promise<void> | void>;
 }
 /**
- * Configuration for security-related settings.
- */
+ * Configuration for the collections (blog) feature.
+ */
+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';
+}
 interface BoltdocsSecurityConfig {
   headers?: Record<string, string>;
   enableCSP?: boolean;
@@ -168,9 +188,18 @@ interface BoltdocsGTMConfig {
   dataLayerName?: string;
   preview?: string;
 }
+/**
+ * Configuration for Algolia DocSearch.
+ */
+interface BoltdocsAlgoliaConfig {
+  appId: string;
+  apiKey: string;
+  indexName: string;
+}
 interface BoltdocsIntegrationsConfig {
   ga4?: BoltdocsGA4Config;
   gtm?: BoltdocsGTMConfig;
+  algolia?: BoltdocsAlgoliaConfig;
 }
 /**
  * The root configuration object for Boltdocs.
@@ -183,6 +212,7 @@ interface BoltdocsConfig$1 {
   i18n?: BoltdocsI18nConfig;
   versions?: BoltdocsVersionsConfig;
   plugins?: BoltdocsPlugin[];
+  collections?: BoltdocsCollectionsConfig;
   robots?: BoltdocsRobotsConfig;
   security?: BoltdocsSecurityConfig;
   seo?: BoltdocsSeoConfig;
@@ -198,9 +228,17 @@ interface BoltdocsConfig$1 {
 declare global {
   namespace Boltdocs {
     interface Types {}
+    /**
+     * Marker interface augmented by generated code to provide strict route path typing.
+     * When no types have been generated (e.g., before first dev server start),
+     * keyof is never, and BoltdocsRoutePath falls back to string.
+     */
+    interface RoutePaths {}
   }
 }
 type BoltdocsTypes = Boltdocs.Types;
+type BoltdocsRoutePath = keyof Boltdocs.RoutePaths;
+type BoltdocsRoutePathWithFallback$1 = BoltdocsRoutePath extends never ? string : BoltdocsRoutePath;
 type BoltdocsLocale = Boltdocs.Types extends {
   Locale: infer L;
 } ? L : string;
@@ -259,16 +297,15 @@ interface ComponentRoute {
   /** The tab this route belongs to, if tabs are configured */
   tab?: string;
   /** Optional badge to display next to the sidebar item */
-  badge?: string | {
-    text: 'updated' | 'new' | 'deprecated';
-    expires?: string;
-  };
+  badge?: BadgeValue;
   /** Optional icon for the route's group */
   groupIcon?: string;
   /** The sub-route group this route belongs to (from folders starting with _) */
   subRouteGroup?: string;
   /** The nested sub-routes if this route acts as the parent of a subRouteGroup */
   subRoutes?: ComponentRoute[];
+  /** Internal helper map for nesting routes during sidebar construction */
+  _subMap?: Map<string, ComponentRoute>;
   /** The extracted plain-text content of the page for search indexing */
   _content?: string;
   /** The raw markdown content of the page */
@@ -277,10 +314,29 @@ interface ComponentRoute {
   date?: string | Date;
   /** The last updated timestamp or date */
   lastUpdated?: string | number | Date;
+  /** The collection this route belongs to (from [name] directories) */
+  collection?: string;
+  /** Tags for blog posts */
+  tags?: string[];
+  /** Author identifier for blog posts */
+  author?: string | {
+    name: string;
+    avatar?: string;
+    url?: string;
+    image?: string;
+  };
+  /** Draft flag */
+  draft?: boolean;
+  /** Short excerpt for list displays */
+  excerpt?: string;
+  /** Cover image for blog posts */
+  coverImage?: string;
   /** Raw extensible frontmatter data for custom components and formatters */
   frontmatter?: Record<string, any>;
   /** Clean URL segments stripped of locale/version prefixes */
   slugParts?: string[];
+  /** SEO metadata for page headers */
+  seo?: Record<string, any>;
 }
 /**
  * Site configuration provided by the server.
@@ -333,11 +389,50 @@ interface LayoutProps {
  */
 interface NavbarLink {
   label: string | Record<string, string>;
-  href: string;
+  href: BoltdocsRoutePathWithFallback;
   active: boolean;
   to?: string;
   items?: NavbarLink[];
 }
+/**
+ * Shape of the data returned by a collection post route loader.
+ * Consumed by `BlogPost` via `useLoaderData<CollectionPostLoaderData>()`.
+ */
+interface CollectionPostLoaderData {
+  /** Full route metadata for this post (title, date, author, tags, etc.) */
+  route: ComponentRoute;
+  /** The name of the collection this post belongs to (e.g. 'blog') */
+  collection: string;
+  /** Extracted page headings for the Table of Contents */
+  headings: {
+    level: number;
+    text: string;
+    id: string;
+  }[];
+}
+/**
+ * Shape of the data returned by a collection listing route loader.
+ * Consumed by `BlogList` via `useLoaderData<CollectionListLoaderData>()`.
+ */
+interface CollectionListLoaderData {
+  /** Paginated subset of posts to display on this page */
+  posts: Array<{
+    path: string;
+    title: string;
+    date?: string | Date;
+    excerpt?: string;
+    tags?: string[];
+    author?: string;
+    coverImage?: string;
+    filePath: string;
+  }>;
+  /** Total number of pages available */
+  totalPages: number;
+  /** Current page index (1-based) */
+  currentPage: number;
+  /** Collection name used to build pagination URLs (e.g. 'blog' → '/blog/page/2') */
+  collection: string;
+}
 //#endregion
 //#region src/client/components/primitives/types.d.ts
 type ComponentBase = {
@@ -377,7 +472,7 @@ declare function SidebarContent({
 /**
  * Navigation Group
  */
-declare const SidebarGroup: ({
+declare function SidebarGroup({
   title,
   icon: Icon,
   children,
@@ -385,7 +480,7 @@ declare const SidebarGroup: ({
 }: {
   title?: string;
   icon?: React.ElementType;
-} & ComponentBase) => _$react_jsx_runtime0.JSX.Element;
+} & ComponentBase): _$react_jsx_runtime0.JSX.Element;
 /**
  * Sidebar Link
  */
@@ -396,18 +491,18 @@ interface SidebarLinkProps extends ComponentBase {
   icon?: React.ElementType;
   badge?: ComponentRoute['badge'];
 }
-declare const SidebarLink: ({
+declare function SidebarLink({
   label,
   href,
   active,
   icon: Icon,
   badge,
   className
-}: SidebarLinkProps) => _$react_jsx_runtime0.JSX.Element;
+}: SidebarLinkProps): _$react_jsx_runtime0.JSX.Element;
 /**
  * Nested SubGroup
  */
-declare const SidebarSubGroup: ({
+declare function SidebarSubGroup({
   label,
   href,
   active,
@@ -421,7 +516,7 @@ declare const SidebarSubGroup: ({
   isOpen: boolean;
   onToggle: () => void;
   children: ReactNode;
-}) => _$react_jsx_runtime0.JSX.Element;
+}): _$react_jsx_runtime0.JSX.Element;
 /**
  * Automated single-route rendering primitive
  */
@@ -454,40 +549,11 @@ declare const Sidebar: typeof SidebarRoot & {
   Mobile: typeof SidebarMobile;
   Header: typeof SidebarHeader;
   Content: typeof SidebarContent;
-  Group: ({
-    title,
-    icon: Icon,
-    children,
-    className
-  }: {
-    title?: string;
-    icon?: React.ElementType;
-  } & ComponentBase) => _$react_jsx_runtime0.JSX.Element;
-  Link: ({
-    label,
-    href,
-    active,
-    icon: Icon,
-    badge,
-    className
-  }: SidebarLinkProps) => _$react_jsx_runtime0.JSX.Element;
-  SubGroup: ({
-    label,
-    href,
-    active,
-    icon: Icon,
-    badge,
-    isOpen,
-    onToggle,
-    children,
-    className
-  }: SidebarLinkProps & {
-    isOpen: boolean;
-    onToggle: () => void;
-    children: ReactNode;
-  }) => _$react_jsx_runtime0.JSX.Element;
+  Group: typeof SidebarGroup;
+  Link: typeof SidebarLink;
+  SubGroup: typeof SidebarSubGroup;
   Item: typeof SidebarItem;
   Items: typeof SidebarItems;
 };
 //#endregion
-export { BoltdocsConfig$1 as C, BoltdocsSocialLink as D, BoltdocsMdxComponents as E, BoltdocsTypes as O, TabsProps as S, BoltdocsLocale as T, LayoutProps as _, SidebarItem as a, SidebarProps as b, SidebarItemsProps as c, SidebarMobile as d, SidebarRoot as f, ComponentRoute as g, BoltdocsTab as h, SidebarHeader as i, BoltdocsVersion as k, SidebarLink as l, ComponentBase as m, SidebarContent as n, SidebarItemProps as o, SidebarSubGroup as p, SidebarGroup as r, SidebarItems as s, Sidebar as t, SidebarLinkProps as u, NavbarLink as v, BoltdocsIntegrationsConfig as w, SiteConfig as x, OnThisPageProps as y };
+export { BoltdocsRoutePathWithFallback$1 as A, SiteConfig as C, BoltdocsLocale as D, BoltdocsIntegrationsConfig as E, BoltdocsTypes as M, BoltdocsVersion as N, BoltdocsMdxComponents as O, SidebarProps as S, BoltdocsConfig$1 as T, CollectionPostLoaderData as _, SidebarItem as a, NavbarLink as b, SidebarItemsProps as c, SidebarMobile as d, SidebarRoot as f, CollectionListLoaderData as g, BoltdocsTab as h, SidebarHeader as i, BoltdocsSocialLink as j, BoltdocsRoutePath as k, SidebarLink as l, ComponentBase as m, SidebarContent as n, SidebarItemProps as o, SidebarSubGroup as p, SidebarGroup as r, SidebarItems as s, Sidebar as t, SidebarLinkProps as u, ComponentRoute as v, TabsProps as w, OnThisPageProps as x, LayoutProps as y };

package/dist/{sidebar-CyZS9YOm.d.ts → sidebar-Dlkgbxs6.d.cts}

@@ -1,8 +1,8 @@
 
 import * as React$2 from "react";
 import { ComponentType, ReactNode } from "react";
-import * as _$react_jsx_runtime0 from "react/jsx-runtime";
 import { Plugin } from "vite";
+import * as _$react_jsx_runtime0 from "react/jsx-runtime";
 
 //#region src/shared/types.d.ts
 /**
@@ -33,15 +33,15 @@ interface BoltdocsThemeConfig {
   };
   navbar?: Array<{
     label: string | Record<string, string>;
-    href: string;
+    href: BoltdocsRoutePathWithFallback$1;
     items?: Array<{
       label: string | Record<string, string>;
-      href: string;
+      href: BoltdocsRoutePathWithFallback$1;
     }>;
   }>;
   sidebar?: Record<string, Array<{
     text: string;
-    link: string;
+    link: BoltdocsRoutePathWithFallback$1;
   }>>;
   sidebarGroups?: Record<string, {
     title?: string | Record<string, string>;
@@ -111,24 +111,44 @@ interface BoltdocsVersionsConfig {
   prefix?: string;
   versions: BoltdocsVersionConfig[];
 }
+/**
+ * Shared badge value type used in frontmatter, RouteMeta, and ComponentRoute.
+ */
+type BadgeValue = string | {
+  text: string;
+  expires?: string;
+};
 /**
  * Defines a Boltdocs plugin.
+ *
+ * Use the `createPlugin()` helper from the node API for full type safety and
+ * access to lifecycle hooks.
  */
 interface BoltdocsPlugin {
   name: string;
   enforce?: 'pre' | 'post';
   version?: string;
   boltdocsVersion?: string;
-  permissions?: string[];
   remarkPlugins?: unknown[];
   rehypePlugins?: unknown[];
   vitePlugins?: Plugin[];
   components?: Record<string, string>;
-  hooks?: Record<string, any>;
+  /** Lifecycle hooks — use the `PluginLifecycleHooks` type from the node API. */
+  hooks?: Record<string, (ctx: unknown) => Promise<void> | void>;
 }
 /**
- * Configuration for security-related settings.
- */
+ * Configuration for the collections (blog) feature.
+ */
+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';
+}
 interface BoltdocsSecurityConfig {
   headers?: Record<string, string>;
   enableCSP?: boolean;
@@ -168,9 +188,18 @@ interface BoltdocsGTMConfig {
   dataLayerName?: string;
   preview?: string;
 }
+/**
+ * Configuration for Algolia DocSearch.
+ */
+interface BoltdocsAlgoliaConfig {
+  appId: string;
+  apiKey: string;
+  indexName: string;
+}
 interface BoltdocsIntegrationsConfig {
   ga4?: BoltdocsGA4Config;
   gtm?: BoltdocsGTMConfig;
+  algolia?: BoltdocsAlgoliaConfig;
 }
 /**
  * The root configuration object for Boltdocs.
@@ -183,6 +212,7 @@ interface BoltdocsConfig$1 {
   i18n?: BoltdocsI18nConfig;
   versions?: BoltdocsVersionsConfig;
   plugins?: BoltdocsPlugin[];
+  collections?: BoltdocsCollectionsConfig;
   robots?: BoltdocsRobotsConfig;
   security?: BoltdocsSecurityConfig;
   seo?: BoltdocsSeoConfig;
@@ -198,9 +228,17 @@ interface BoltdocsConfig$1 {
 declare global {
   namespace Boltdocs {
     interface Types {}
+    /**
+     * Marker interface augmented by generated code to provide strict route path typing.
+     * When no types have been generated (e.g., before first dev server start),
+     * keyof is never, and BoltdocsRoutePath falls back to string.
+     */
+    interface RoutePaths {}
   }
 }
 type BoltdocsTypes = Boltdocs.Types;
+type BoltdocsRoutePath = keyof Boltdocs.RoutePaths;
+type BoltdocsRoutePathWithFallback$1 = BoltdocsRoutePath extends never ? string : BoltdocsRoutePath;
 type BoltdocsLocale = Boltdocs.Types extends {
   Locale: infer L;
 } ? L : string;
@@ -259,16 +297,15 @@ interface ComponentRoute {
   /** The tab this route belongs to, if tabs are configured */
   tab?: string;
   /** Optional badge to display next to the sidebar item */
-  badge?: string | {
-    text: 'updated' | 'new' | 'deprecated';
-    expires?: string;
-  };
+  badge?: BadgeValue;
   /** Optional icon for the route's group */
   groupIcon?: string;
   /** The sub-route group this route belongs to (from folders starting with _) */
   subRouteGroup?: string;
   /** The nested sub-routes if this route acts as the parent of a subRouteGroup */
   subRoutes?: ComponentRoute[];
+  /** Internal helper map for nesting routes during sidebar construction */
+  _subMap?: Map<string, ComponentRoute>;
   /** The extracted plain-text content of the page for search indexing */
   _content?: string;
   /** The raw markdown content of the page */
@@ -277,10 +314,29 @@ interface ComponentRoute {
   date?: string | Date;
   /** The last updated timestamp or date */
   lastUpdated?: string | number | Date;
+  /** The collection this route belongs to (from [name] directories) */
+  collection?: string;
+  /** Tags for blog posts */
+  tags?: string[];
+  /** Author identifier for blog posts */
+  author?: string | {
+    name: string;
+    avatar?: string;
+    url?: string;
+    image?: string;
+  };
+  /** Draft flag */
+  draft?: boolean;
+  /** Short excerpt for list displays */
+  excerpt?: string;
+  /** Cover image for blog posts */
+  coverImage?: string;
   /** Raw extensible frontmatter data for custom components and formatters */
   frontmatter?: Record<string, any>;
   /** Clean URL segments stripped of locale/version prefixes */
   slugParts?: string[];
+  /** SEO metadata for page headers */
+  seo?: Record<string, any>;
 }
 /**
  * Site configuration provided by the server.
@@ -333,11 +389,50 @@ interface LayoutProps {
  */
 interface NavbarLink {
   label: string | Record<string, string>;
-  href: string;
+  href: BoltdocsRoutePathWithFallback;
   active: boolean;
   to?: string;
   items?: NavbarLink[];
 }
+/**
+ * Shape of the data returned by a collection post route loader.
+ * Consumed by `BlogPost` via `useLoaderData<CollectionPostLoaderData>()`.
+ */
+interface CollectionPostLoaderData {
+  /** Full route metadata for this post (title, date, author, tags, etc.) */
+  route: ComponentRoute;
+  /** The name of the collection this post belongs to (e.g. 'blog') */
+  collection: string;
+  /** Extracted page headings for the Table of Contents */
+  headings: {
+    level: number;
+    text: string;
+    id: string;
+  }[];
+}
+/**
+ * Shape of the data returned by a collection listing route loader.
+ * Consumed by `BlogList` via `useLoaderData<CollectionListLoaderData>()`.
+ */
+interface CollectionListLoaderData {
+  /** Paginated subset of posts to display on this page */
+  posts: Array<{
+    path: string;
+    title: string;
+    date?: string | Date;
+    excerpt?: string;
+    tags?: string[];
+    author?: string;
+    coverImage?: string;
+    filePath: string;
+  }>;
+  /** Total number of pages available */
+  totalPages: number;
+  /** Current page index (1-based) */
+  currentPage: number;
+  /** Collection name used to build pagination URLs (e.g. 'blog' → '/blog/page/2') */
+  collection: string;
+}
 //#endregion
 //#region src/client/components/primitives/types.d.ts
 type ComponentBase = {
@@ -377,7 +472,7 @@ declare function SidebarContent({
 /**
  * Navigation Group
  */
-declare const SidebarGroup: ({
+declare function SidebarGroup({
   title,
   icon: Icon,
   children,
@@ -385,7 +480,7 @@ declare const SidebarGroup: ({
 }: {
   title?: string;
   icon?: React.ElementType;
-} & ComponentBase) => _$react_jsx_runtime0.JSX.Element;
+} & ComponentBase): _$react_jsx_runtime0.JSX.Element;
 /**
  * Sidebar Link
  */
@@ -396,18 +491,18 @@ interface SidebarLinkProps extends ComponentBase {
   icon?: React.ElementType;
   badge?: ComponentRoute['badge'];
 }
-declare const SidebarLink: ({
+declare function SidebarLink({
   label,
   href,
   active,
   icon: Icon,
   badge,
   className
-}: SidebarLinkProps) => _$react_jsx_runtime0.JSX.Element;
+}: SidebarLinkProps): _$react_jsx_runtime0.JSX.Element;
 /**
  * Nested SubGroup
  */
-declare const SidebarSubGroup: ({
+declare function SidebarSubGroup({
   label,
   href,
   active,
@@ -421,7 +516,7 @@ declare const SidebarSubGroup: ({
   isOpen: boolean;
   onToggle: () => void;
   children: ReactNode;
-}) => _$react_jsx_runtime0.JSX.Element;
+}): _$react_jsx_runtime0.JSX.Element;
 /**
  * Automated single-route rendering primitive
  */
@@ -454,40 +549,11 @@ declare const Sidebar: typeof SidebarRoot & {
   Mobile: typeof SidebarMobile;
   Header: typeof SidebarHeader;
   Content: typeof SidebarContent;
-  Group: ({
-    title,
-    icon: Icon,
-    children,
-    className
-  }: {
-    title?: string;
-    icon?: React.ElementType;
-  } & ComponentBase) => _$react_jsx_runtime0.JSX.Element;
-  Link: ({
-    label,
-    href,
-    active,
-    icon: Icon,
-    badge,
-    className
-  }: SidebarLinkProps) => _$react_jsx_runtime0.JSX.Element;
-  SubGroup: ({
-    label,
-    href,
-    active,
-    icon: Icon,
-    badge,
-    isOpen,
-    onToggle,
-    children,
-    className
-  }: SidebarLinkProps & {
-    isOpen: boolean;
-    onToggle: () => void;
-    children: ReactNode;
-  }) => _$react_jsx_runtime0.JSX.Element;
+  Group: typeof SidebarGroup;
+  Link: typeof SidebarLink;
+  SubGroup: typeof SidebarSubGroup;
   Item: typeof SidebarItem;
   Items: typeof SidebarItems;
 };
 //#endregion
-export { BoltdocsConfig$1 as C, BoltdocsSocialLink as D, BoltdocsMdxComponents as E, BoltdocsTypes as O, TabsProps as S, BoltdocsLocale as T, LayoutProps as _, SidebarItem as a, SidebarProps as b, SidebarItemsProps as c, SidebarMobile as d, SidebarRoot as f, ComponentRoute as g, BoltdocsTab as h, SidebarHeader as i, BoltdocsVersion as k, SidebarLink as l, ComponentBase as m, SidebarContent as n, SidebarItemProps as o, SidebarSubGroup as p, SidebarGroup as r, SidebarItems as s, Sidebar as t, SidebarLinkProps as u, NavbarLink as v, BoltdocsIntegrationsConfig as w, SiteConfig as x, OnThisPageProps as y };
+export { BoltdocsRoutePathWithFallback$1 as A, SiteConfig as C, BoltdocsLocale as D, BoltdocsIntegrationsConfig as E, BoltdocsTypes as M, BoltdocsVersion as N, BoltdocsMdxComponents as O, SidebarProps as S, BoltdocsConfig$1 as T, CollectionPostLoaderData as _, SidebarItem as a, NavbarLink as b, SidebarItemsProps as c, SidebarMobile as d, SidebarRoot as f, CollectionListLoaderData as g, BoltdocsTab as h, SidebarHeader as i, BoltdocsSocialLink as j, BoltdocsRoutePath as k, SidebarLink as l, ComponentBase as m, SidebarContent as n, SidebarItemProps as o, SidebarSubGroup as p, SidebarGroup as r, SidebarItems as s, Sidebar as t, SidebarLinkProps as u, ComponentRoute as v, TabsProps as w, OnThisPageProps as x, LayoutProps as y };

package/dist/utils-BYITg7T5.mjs

@@ -0,0 +1,7 @@
+/**
+ * Boltdocs - https://boltdocs.vercel.app
+ * Copyright (c) 2026 Jesus Alcala
+ * Licensed under the MIT License.
+ */
+import e from"node:fs";import t from"isomorphic-dompurify";import{z as n}from"zod";import{error as r}from"@bdocs/dui";const i=/^[a-zA-Z0-9\-_/.()\[\]]+$/,a=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.string(),n.any()).optional(),tags:n.array(n.string().max(50)).optional(),author:n.union([n.string().max(100),n.object({name:n.string().max(100),avatar:n.string().optional(),url:n.string().optional(),image:n.string().optional()})]).optional(),draft:n.boolean().optional(),excerpt:n.string().max(500).optional(),coverImage:n.string().nullable().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+1)}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();return e?e.split(/,\s*/).map(e=>u(e.trim())):[]}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(t){try{return e.statSync(t).mtimeMs}catch{return 0}}function b(e,t,n){let{data:r,content:i,rawMatter:s}=o(t);if(s&&s.length>10240)throw k(`FRONTMATTER_TOO_LARGE`,`Frontmatter block exceeds size limit`,{size:s.length,file:e}),new m(`Security breach: Frontmatter size exceeds limit of 10240 bytes`);if(!n)return{data:r,content:i};let c=a.safeParse(r),l={...c.success?c.data:{}};return l.title&&=E(l.title).trim(),l.description&&=E(l.description).trim(),{data:l,content:i}}async function x(t,n=!0){let r=``;try{r=await e.promises.readFile(t,`utf-8`);let{data:i,content:a}=b(t,r,n);if(n&&!i.lastUpdated)try{i.lastUpdated=(await e.promises.stat(t)).mtimeMs}catch{i.lastUpdated=0}return{data:i,content:a,raw:r}}catch(e){if(e instanceof m)throw e;return{data:{},content:r,raw:r}}}function S(e){return e.replace(/&/g,`&amp;`).replace(/"/g,`&quot;`).replace(/'/g,`&apos;`).replace(/</g,`&lt;`).replace(/>/g,`&gt;`)}function C(e){return S(e)}function w(e){let t=h(e).split(`/`).map(e=>O(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 T(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 E(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 D(e){return e.charAt(0).toUpperCase()+e.slice(1)}function O(e){return e.replace(/[^a-zA-Z0-9\-_/.]/g,``).split(`/`).filter(e=>e!==`..`&&e!==`.`).map(e=>e.replace(/\.\.+/g,`.`)).join(`/`)}function k(e,t,n={}){let i=new Date().toISOString(),a={...n};for(let e in a)typeof a[e]==`string`&&a[e].includes(`:`)&&(a[e]=a[e].split(/[\\/]/).pop()||a[e]);r(`[SECURITY][${i}] TYPE: ${e} | MESSAGE: ${t} | DETAILS: ${JSON.stringify(a)}`)}function A(){return{dir:process.env.BOLTDOCS_CACHE_DIR||`.boltdocs/cache`,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{f as _,w as a,i as b,v as c,x as d,O as f,p as g,g as h,_ as i,k as l,E as m,S as n,A as o,T as p,C as r,y as s,D as t,h as u,m as v,a as y};

package/dist/utils-Cjmx1hhk.cjs

@@ -0,0 +1,7 @@
+/**
+ * Boltdocs - https://boltdocs.vercel.app
+ * Copyright (c) 2026 Jesus Alcala
+ * Licensed under the MIT License.
+ */
+const e=require(`./chunk-CU-zTemE.cjs`);let t=require(`node:fs`);t=e.t(t);let n=require(`isomorphic-dompurify`);n=e.t(n);let r=require(`zod`),i=require(`@bdocs/dui`);const a=/^[a-zA-Z0-9\-_/.()\[\]]+$/,o=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.string(),r.z.any()).optional(),tags:r.z.array(r.z.string().max(50)).optional(),author:r.z.union([r.z.string().max(100),r.z.object({name:r.z.string().max(100),avatar:r.z.string().optional(),url:r.z.string().optional(),image:r.z.string().optional()})]).optional(),draft:r.z.boolean().optional(),excerpt:r.z.string().max(500).optional(),coverImage:r.z.string().nullable().optional()});function s(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 c(r)?{data:{},content:i,rawMatter:r}:{data:l(r),content:i,rawMatter:r}}function c(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 l(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=u(t.slice(r+1),e.search(/\S|$/));i.value===void 0?r++:(n[o]=i.value,r+=i.linesConsumed+1)}else n[o]=d(s),r++}else r++}return n}function u(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]=d(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]=d(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]=d(o.slice(s+1).trim())}r++}return{value:Object.keys(n).length>0?n:void 0,linesConsumed:r}}function d(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();return e?e.split(/,\s*/).map(e=>d(e.trim())):[]}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]=d(e.slice(t+1).trim())}}return n}return t}var f=class e extends Error{constructor(t){super(t),this.name=`SecurityViolationError`,Object.setPrototypeOf(this,e.prototype)}},p=class e extends f{constructor(t){super(t),this.name=`PathTraversalError`,Object.setPrototypeOf(this,e.prototype)}},m=class e extends f{constructor(t){super(t),this.name=`EncodingSecurityError`,Object.setPrototypeOf(this,e.prototype)}},h=class e extends f{constructor(t){super(t),this.name=`ValidationError`,Object.setPrototypeOf(this,e.prototype)}};function g(e){return e.replace(/\\/g,`/`)}function _(e){return e.replace(/^\d+\./,``)}function v(e){let t=e.match(/^(\d+)\./);return t?parseInt(t[1],10):void 0}function y(e){return/\.mdx?$/.test(e)}function b(e){try{return t.default.statSync(e).mtimeMs}catch{return 0}}function x(e,t,n){let{data:r,content:i,rawMatter:a}=s(t);if(a&&a.length>10240)throw A(`FRONTMATTER_TOO_LARGE`,`Frontmatter block exceeds size limit`,{size:a.length,file:e}),new h(`Security breach: Frontmatter size exceeds limit of 10240 bytes`);if(!n)return{data:r,content:i};let c=o.safeParse(r),l={...c.success?c.data:{}};return l.title&&=D(l.title).trim(),l.description&&=D(l.description).trim(),{data:l,content:i}}async function S(e,n=!0){let r=``;try{r=await t.default.promises.readFile(e,`utf-8`);let{data:i,content:a}=x(e,r,n);if(n&&!i.lastUpdated)try{i.lastUpdated=(await t.default.promises.stat(e)).mtimeMs}catch{i.lastUpdated=0}return{data:i,content:a,raw:r}}catch(e){if(e instanceof h)throw e;return{data:{},content:r,raw:r}}}function C(e){return e.replace(/&/g,`&amp;`).replace(/"/g,`&quot;`).replace(/'/g,`&apos;`).replace(/</g,`&lt;`).replace(/>/g,`&gt;`)}function w(e){return C(e)}function T(e){let t=g(e).split(`/`).map(e=>k(_(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 E(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 D(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 O(e){return e.charAt(0).toUpperCase()+e.slice(1)}function k(e){return e.replace(/[^a-zA-Z0-9\-_/.]/g,``).split(`/`).filter(e=>e!==`..`&&e!==`.`).map(e=>e.replace(/\.\.+/g,`.`)).join(`/`)}function A(e,t,n={}){let r=new Date().toISOString(),a={...n};for(let e in a)typeof a[e]==`string`&&a[e].includes(`:`)&&(a[e]=a[e].split(/[\\/]/).pop()||a[e]);(0,i.error)(`[SECURITY][${r}] TYPE: ${e} | MESSAGE: ${t} | DETAILS: ${JSON.stringify(a)}`)}function j(){return{dir:process.env.BOLTDOCS_CACHE_DIR||`.boltdocs/cache`,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 p}}),Object.defineProperty(exports,`a`,{enumerable:!0,get:function(){return T}}),Object.defineProperty(exports,`b`,{enumerable:!0,get:function(){return a}}),Object.defineProperty(exports,`c`,{enumerable:!0,get:function(){return y}}),Object.defineProperty(exports,`d`,{enumerable:!0,get:function(){return S}}),Object.defineProperty(exports,`f`,{enumerable:!0,get:function(){return k}}),Object.defineProperty(exports,`g`,{enumerable:!0,get:function(){return m}}),Object.defineProperty(exports,`h`,{enumerable:!0,get:function(){return _}}),Object.defineProperty(exports,`i`,{enumerable:!0,get:function(){return v}}),Object.defineProperty(exports,`l`,{enumerable:!0,get:function(){return A}}),Object.defineProperty(exports,`m`,{enumerable:!0,get:function(){return D}}),Object.defineProperty(exports,`n`,{enumerable:!0,get:function(){return C}}),Object.defineProperty(exports,`o`,{enumerable:!0,get:function(){return j}}),Object.defineProperty(exports,`p`,{enumerable:!0,get:function(){return E}}),Object.defineProperty(exports,`r`,{enumerable:!0,get:function(){return w}}),Object.defineProperty(exports,`s`,{enumerable:!0,get:function(){return b}}),Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return O}}),Object.defineProperty(exports,`u`,{enumerable:!0,get:function(){return g}}),Object.defineProperty(exports,`v`,{enumerable:!0,get:function(){return h}}),Object.defineProperty(exports,`y`,{enumerable:!0,get:function(){return o}});