boltdocs 1.0.1 → 1.3.0

package/dist/client/index.css

@@ -422,73 +422,43 @@ a {
   flex: 1;
 }
 .boltdocs-main-container.sidebar-collapsed .boltdocs-sidebar {
-  width: 0;
-  padding-left: 0;
-  padding-right: 0;
-  border-right-color: transparent;
-  opacity: 0;
-  pointer-events: none;
+  width: 54px;
+  padding: 1rem 0;
+  border-right: 1px solid var(--ld-border-subtle);
+  opacity: 1;
+  pointer-events: auto;
   overflow: hidden;
 }
-.sidebar-toggle-floating {
-  position: fixed;
-  bottom: 2rem;
-  left: 2rem;
-  width: 2.75rem;
-  height: 2.75rem;
-  border-radius: 50%;
-  background-color: var(--ld-surface);
-  border: 1px solid var(--ld-border-strong);
-  color: var(--ld-text-muted);
+.sidebar-collapse {
+  width: 100%;
   display: flex;
   align-items: center;
-  justify-content: center;
-  cursor: pointer;
-  z-index: 100;
-  box-shadow: 0 4px 12px rgba(0, 0, 0, 0.1);
-  transition: all 0.3s cubic-bezier(0.16, 1, 0.3, 1);
-  opacity: 0;
-  pointer-events: none;
-  transform: translateY(20px) scale(0.9);
-}
-.sidebar-toggle-floating:hover {
-  background-color: var(--ld-bg-soft);
-  color: var(--ld-text-main);
-  transform: translateY(0px) scale(1.05);
-  border-color: var(--ld-color-primary);
+  justify-content: flex-end;
+  padding: 0 0.75rem 1rem;
+  transition: justify-content 0.3s ease;
 }
-.sidebar-toggle-floating:active {
-  transform: translateY(0px) scale(0.95);
-}
-.boltdocs-main-container.sidebar-collapsed .sidebar-toggle-floating {
-  opacity: 1;
-  pointer-events: auto;
-  transform: translateY(0) scale(1);
-}
-.sidebar-footer {
-  margin-top: 2rem;
-  padding-top: 1rem;
-  border-top: 1px solid var(--ld-border-subtle);
+.boltdocs-main-container.sidebar-collapsed .sidebar-collapse {
+  justify-content: center;
+  padding: 0 0 1rem;
 }
 .sidebar-collapse-btn {
+  color: var(--ld-text-muted);
+  border: none;
+  box-shadow: none;
+  background-color: transparent;
+  cursor: pointer;
   display: flex;
   align-items: center;
-  gap: 0.5rem;
-  width: 100%;
-  padding: 0.5rem 0.75rem;
-  background: none;
-  border: none;
+  justify-content: center;
+  width: 32px;
+  height: 32px;
   border-radius: var(--ld-radius-md);
-  color: var(--ld-text-muted);
-  font-family: var(--ld-font-sans);
-  font-size: 0.8125rem;
-  font-weight: 500;
-  cursor: pointer;
-  transition: all 0.2s ease;
+  transition: all 0.2s cubic-bezier(0.16, 1, 0.3, 1);
 }
 .sidebar-collapse-btn:hover {
-  background-color: var(--ld-bg-soft);
-  color: var(--ld-color-primary);
+  background-color: var(--ld-bg-mute);
+  color: var(--ld-text-main);
+  transform: scale(1.05);
 }
 .boltdocs-sidebar::-webkit-scrollbar {
   width: 4px;
@@ -1142,11 +1112,11 @@ a {
   background-color: transparent !important;
 }
 .code-block-wrapper pre > code {
-  padding: 1.25rem !important;
-  display: block !important;
+  display: grid !important;
+  padding: 1.25rem 1rem !important;
 }
 .code-block-wrapper pre > code .line {
-  padding: 0;
+  padding: 0 1.25rem;
 }
 .boltdocs-page pre {
   margin: 1.5rem 0;
@@ -1161,7 +1131,7 @@ a {
 }
 .boltdocs-page pre > code {
   display: grid;
-  padding: 1rem 0;
+  padding: 1rem 1rem;
   background-color: transparent;
   border: none;
   color: inherit;
@@ -1245,57 +1215,68 @@ a {
 
 /* src/client/theme/components/mdx/mdx-components.css */
 .ld-btn {
+  all: unset;
+  box-sizing: border-box !important;
   display: inline-flex;
   align-items: center;
-  gap: 0.4rem;
+  justify-content: center;
+  gap: 0.5rem;
+  font-family: var(--ld-font-sans);
   font-weight: 600;
+  font-size: 0.9375rem;
+  line-height: normal;
+  letter-spacing: -0.01em;
+  text-align: center;
+  text-decoration: none !important;
+  white-space: nowrap;
   border-radius: var(--ld-radius-md);
   cursor: pointer;
-  transition: all 300ms cubic-bezier(0.16, 1, 0.3, 1);
-  font-family: var(--ld-font-sans);
+  transition: all 250ms cubic-bezier(0.4, 0, 0.2, 1);
   border: 1px solid transparent;
-  line-height: 1;
-  letter-spacing: -0.01em;
+  user-select: none;
+  position: relative;
 }
 .ld-btn:hover {
-  transform: scale(1.05);
+  transform: translateY(-1px);
 }
 .ld-btn:active {
-  transform: scale(0.95);
+  transform: translateY(0) scale(0.98);
 }
 .ld-btn--sm {
-  padding: 0.45rem 1.1rem;
+  min-height: 2rem;
+  padding: 0 1rem;
   font-size: 0.8125rem;
   border-radius: var(--ld-radius-md);
 }
 .ld-btn--md {
-  padding: 0.7rem 1.6rem;
+  min-height: 2.625rem;
+  padding: 0 1.6rem;
   font-size: 0.9375rem;
 }
 .ld-btn--lg {
-  padding: 0.85rem 2.1rem;
+  min-height: 3.25rem;
+  padding: 0 2.2rem;
   font-size: 1.05rem;
 }
 .ld-btn--primary {
-  background-color: var(--ld-ui-btn-primary-bg, var(--ld-btn-primary-bg));
+  background-color: var( --ld-ui-btn-primary-bg, var(--ld-btn-primary-bg) ) !important;
   color: var(--ld-ui-btn-primary-text, var(--ld-btn-primary-text)) !important;
+  box-shadow: 0 1px 2px rgba(0, 0, 0, 0.1);
 }
 .ld-btn--primary:hover {
-  opacity: 0.92;
-  color: var(--ld-ui-btn-primary-text, var(--ld-btn-primary-text)) !important;
+  filter: brightness(1.1);
 }
 .ld-btn--secondary {
-  background-color: var(--ld-ui-btn-secondary-bg, var(--ld-btn-secondary-bg));
+  background-color: var( --ld-ui-btn-secondary-bg, var(--ld-btn-secondary-bg) ) !important;
   color: var( --ld-ui-btn-secondary-text, var(--ld-btn-secondary-text) ) !important;
   border-color: var(--ld-border-subtle);
 }
 .ld-btn--secondary:hover {
   background-color: var(--ld-bg-mute);
   border-color: var(--ld-border-strong);
-  color: var( --ld-ui-btn-secondary-text, var(--ld-btn-secondary-text) ) !important;
 }
 .ld-btn--outline {
-  background: transparent;
+  background: transparent !important;
   color: var(--ld-text-main) !important;
   border-color: var(--ld-border-strong);
 }
@@ -1304,7 +1285,7 @@ a {
   border-color: var(--ld-color-primary);
 }
 .ld-btn--ghost {
-  background: transparent;
+  background: transparent !important;
   color: var(--ld-text-muted) !important;
 }
 .ld-btn--ghost:hover {
@@ -1840,56 +1821,6 @@ a {
   color: var(--ld-color-primary);
 }
 
-/* src/client/theme/styles/home.css */
-.boltdocs-home {
-  min-height: calc(100vh - var(--ld-navbar-height));
-}
-.home-hero {
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  padding: 6rem 2rem 4rem;
-  text-align: center;
-}
-.hero-content {
-  max-width: 680px;
-}
-.hero-title {
-  font-size: 3.5rem;
-  font-weight: 900;
-  line-height: 1.1;
-  margin: 0 0 1.25rem;
-  letter-spacing: -0.03em;
-  color: var(--ld-text-main);
-}
-.hero-highlight {
-  background:
-    linear-gradient(
-      135deg,
-      var(--ld-gradient-from),
-      var(--ld-gradient-to));
-  -webkit-background-clip: text;
-  -webkit-text-fill-color: transparent;
-  background-clip: text;
-}
-.hero-description {
-  font-size: 1.125rem;
-  color: var(--ld-text-muted);
-  line-height: 1.7;
-  margin-bottom: 2rem;
-}
-.hero-actions {
-  display: flex;
-  gap: 0.75rem;
-  justify-content: center;
-  flex-wrap: wrap;
-}
-.home-features {
-  padding: 2rem 2rem 6rem;
-  max-width: 1000px;
-  margin: 0 auto;
-}
-
 /* src/client/theme/ui/NotFound/not-found.css */
 .boltdocs-not-found {
   display: flex;
@@ -2122,9 +2053,6 @@ a.not-found-link:hover {
   .boltdocs-sidebar {
     display: none;
   }
-  .sidebar-toggle-floating {
-    display: none !important;
-  }
   .boltdocs-content {
     padding: 1.5rem 1rem 3rem;
   }

package/dist/client/index.d.mts

@@ -1,11 +1,38 @@
-import { B as BoltdocsConfig } from '../config-D2XmHJYe.mjs';
-export { a as BoltdocsThemeConfig } from '../config-D2XmHJYe.mjs';
-import { C as ComponentRoute } from '../index-CRQKWAeo.mjs';
-export { a as CreateBoltdocsAppOptions, c as createBoltdocsApp } from '../index-CRQKWAeo.mjs';
+import { B as BoltdocsConfig } from '../config-BD5ZHz15.mjs';
+export { a as BoltdocsThemeConfig } from '../config-BD5ZHz15.mjs';
+import { C as CreateBoltdocsAppOptions, a as ComponentRoute } from '../types-CvrzTbEX.mjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React from 'react';
 import 'vite';
 
+declare global {
+    interface ImportMeta {
+        env: Record<string, any>;
+    }
+}
+/**
+ * Creates and mounts the Boltdocs documentation app.
+ *
+ * Usage:
+ * ```tsx
+ * import { createBoltdocsApp } from 'boltdocs/client'
+ * import routes from 'virtual:boltdocs-routes'
+ * import config from 'virtual:boltdocs-config'
+ * import 'boltdocs/style.css'
+ * import HomePage from './HomePage'
+ *
+ * createBoltdocsApp({
+ *   target: '#root',
+ *   routes,
+ *   config,
+ *   modules: import.meta.glob('/docs/**\/*.{md,mdx}'),
+ *   hot: import.meta.hot,
+ *   homePage: HomePage,
+ * })
+ * ```
+ */
+declare function createBoltdocsApp(options: CreateBoltdocsAppOptions): void;
+
 /**
  * The top navigation bar of the documentation site.
  */
@@ -36,10 +63,11 @@ interface RouteItem {
  * @param routes - Array of all generated routes to be displayed
  * @param config - Global configuration (which can contain sidebar overrides)
  */
-declare function Sidebar({ routes, config, onCollapse, }: {
+declare function Sidebar({ routes, config, isCollapsed, onToggle, }: {
     routes: RouteItem[];
     config: BoltdocsConfig;
-    onCollapse?: () => void;
+    isCollapsed?: boolean;
+    onToggle?: () => void;
 }): react_jsx_runtime.JSX.Element;
 
 interface TocHeading {
@@ -109,12 +137,15 @@ interface PlaygroundProps {
     children?: string | React.ReactNode;
     scope?: Record<string, any>;
     readonly?: boolean;
+    noInline?: boolean;
 }
 /**
  * A live React playground component.
  * Features a split layout with a live editor and a preview section.
+ *
+ * Supports `export default function App()` style code out of the box.
  */
-declare function Playground({ code, children, scope, readonly, }: PlaygroundProps): react_jsx_runtime.JSX.Element;
+declare function Playground({ code, children, scope, readonly, noInline: forceNoInline, }: PlaygroundProps): react_jsx_runtime.JSX.Element;
 
 declare function NotFound(): react_jsx_runtime.JSX.Element;
 
@@ -295,4 +326,4 @@ interface ListProps extends React.HTMLAttributes<HTMLUListElement> {
  */
 declare function List({ variant, children, className, ...rest }: ListProps): react_jsx_runtime.JSX.Element;
 
-export { Admonition, type AdmonitionProps, BackgroundGradient, Badge, type BadgeProps, BoltdocsConfig, Breadcrumbs, Button, type ButtonProps, Card, type CardProps, Cards, type CardsProps, CodeBlock, ComponentRoute, Danger, Head, InfoBox, List, type ListProps, Loading, Navbar, NotFound, Note, OnThisPage, Playground, Sidebar, Tab, type TabProps, Tabs, type TabsProps, ThemeLayout, Tip, Video, Warning };
+export { Admonition, type AdmonitionProps, BackgroundGradient, Badge, type BadgeProps, BoltdocsConfig, Breadcrumbs, Button, type ButtonProps, Card, type CardProps, Cards, type CardsProps, CodeBlock, ComponentRoute, CreateBoltdocsAppOptions, Danger, Head, InfoBox, List, type ListProps, Loading, Navbar, NotFound, Note, OnThisPage, Playground, Sidebar, Tab, type TabProps, Tabs, type TabsProps, ThemeLayout, Tip, Video, Warning, createBoltdocsApp };

package/dist/client/index.d.ts

@@ -1,11 +1,38 @@
-import { B as BoltdocsConfig } from '../config-D2XmHJYe.js';
-export { a as BoltdocsThemeConfig } from '../config-D2XmHJYe.js';
-import { C as ComponentRoute } from '../index-CRQKWAeo.js';
-export { a as CreateBoltdocsAppOptions, c as createBoltdocsApp } from '../index-CRQKWAeo.js';
+import { B as BoltdocsConfig } from '../config-BD5ZHz15.js';
+export { a as BoltdocsThemeConfig } from '../config-BD5ZHz15.js';
+import { C as CreateBoltdocsAppOptions, a as ComponentRoute } from '../types-CvrzTbEX.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React from 'react';
 import 'vite';
 
+declare global {
+    interface ImportMeta {
+        env: Record<string, any>;
+    }
+}
+/**
+ * Creates and mounts the Boltdocs documentation app.
+ *
+ * Usage:
+ * ```tsx
+ * import { createBoltdocsApp } from 'boltdocs/client'
+ * import routes from 'virtual:boltdocs-routes'
+ * import config from 'virtual:boltdocs-config'
+ * import 'boltdocs/style.css'
+ * import HomePage from './HomePage'
+ *
+ * createBoltdocsApp({
+ *   target: '#root',
+ *   routes,
+ *   config,
+ *   modules: import.meta.glob('/docs/**\/*.{md,mdx}'),
+ *   hot: import.meta.hot,
+ *   homePage: HomePage,
+ * })
+ * ```
+ */
+declare function createBoltdocsApp(options: CreateBoltdocsAppOptions): void;
+
 /**
  * The top navigation bar of the documentation site.
  */
@@ -36,10 +63,11 @@ interface RouteItem {
  * @param routes - Array of all generated routes to be displayed
  * @param config - Global configuration (which can contain sidebar overrides)
  */
-declare function Sidebar({ routes, config, onCollapse, }: {
+declare function Sidebar({ routes, config, isCollapsed, onToggle, }: {
     routes: RouteItem[];
     config: BoltdocsConfig;
-    onCollapse?: () => void;
+    isCollapsed?: boolean;
+    onToggle?: () => void;
 }): react_jsx_runtime.JSX.Element;
 
 interface TocHeading {
@@ -109,12 +137,15 @@ interface PlaygroundProps {
     children?: string | React.ReactNode;
     scope?: Record<string, any>;
     readonly?: boolean;
+    noInline?: boolean;
 }
 /**
  * A live React playground component.
  * Features a split layout with a live editor and a preview section.
+ *
+ * Supports `export default function App()` style code out of the box.
  */
-declare function Playground({ code, children, scope, readonly, }: PlaygroundProps): react_jsx_runtime.JSX.Element;
+declare function Playground({ code, children, scope, readonly, noInline: forceNoInline, }: PlaygroundProps): react_jsx_runtime.JSX.Element;
 
 declare function NotFound(): react_jsx_runtime.JSX.Element;
 
@@ -295,4 +326,4 @@ interface ListProps extends React.HTMLAttributes<HTMLUListElement> {
  */
 declare function List({ variant, children, className, ...rest }: ListProps): react_jsx_runtime.JSX.Element;
 
-export { Admonition, type AdmonitionProps, BackgroundGradient, Badge, type BadgeProps, BoltdocsConfig, Breadcrumbs, Button, type ButtonProps, Card, type CardProps, Cards, type CardsProps, CodeBlock, ComponentRoute, Danger, Head, InfoBox, List, type ListProps, Loading, Navbar, NotFound, Note, OnThisPage, Playground, Sidebar, Tab, type TabProps, Tabs, type TabsProps, ThemeLayout, Tip, Video, Warning };
+export { Admonition, type AdmonitionProps, BackgroundGradient, Badge, type BadgeProps, BoltdocsConfig, Breadcrumbs, Button, type ButtonProps, Card, type CardProps, Cards, type CardsProps, CodeBlock, ComponentRoute, CreateBoltdocsAppOptions, Danger, Head, InfoBox, List, type ListProps, Loading, Navbar, NotFound, Note, OnThisPage, Playground, Sidebar, Tab, type TabProps, Tabs, type TabsProps, ThemeLayout, Tip, Video, Warning, createBoltdocsApp };